プラットフォーム利用者（acomo 上でワークフローモデルを使って開発する開発者）向け。 acomo CLI および公開 API の標準的な使い方（モデル取得・プロセス操作・認証）を案内する。 acomo 本体の内部実装は対象外。 acomo CLI を使うとき、ワークフローやプロセスの操作・モデル定義の確認を行うときに参照する。

acomo CLI / API 標準ガイド acomo はワークフロー管理プラットフォームです。このスキルは acomo CLI と公開 API の標準的な使い方（モデル一覧・モデル定義取得・プロセス開始・保存・提出・承認・却下・差し戻しなど）を案内します。前提・実行環境 acomo CLI が実行できる環境（PATH に acomo が存在すること）を前提とします。エージェントが CLI を実行する場合、リモートサンドボックス等ではローカルの ~/.acomo/config.json や環境変数が自動継承されないことがあります。CI・エージェント実行時は環境変数（ ACOMO ACCESS TOKEN , ACOMO TENANT ID , ACOMO BASE URL ）の設定を推奨します。認証未設定時も API コマンドは存在し、実行時に終了コード 2 と stderr の AUTH REQUIRED で失敗します。その場合はユーザーに再ログイン（または環境変数設定）を促してください。認証エラー時の扱い認証エラー（認証未設定・401/403、終了コード 2）が出た場合は、試行錯誤で解決しようとしないこと。速やかにユーザーにログインを促し、処理を中断する。 acomo login の実行、または環境変数 ACOMO ACCESS TOKEN , ACOMO TENANT ID の設定認証ローカル利用 : acomo login で ~/.acomo/config.json に永続保存。 CI・エージェント環境 : 環境変数での認証を推奨。アクセストークンはブラウザで acomo にログインした後に入手し、CLI で指定する。環境変数説明必須 ACOMO ACCESS TOKEN アクセストークン Yes ACOMO TENANT ID テナント ID Yes ACOMO BASE URL API Base URL（省略時: https://acomo.app ） No CLI の出力は JSON です。パラメータは acomo <operationId help で確認する。呼び出し形式 path/query パラメータ → name value 形式の named option リクエストボディ → 位置引数の JSON 文字列（または stdin）標準フロー 1. モデル一覧 : acomo listWorkflowModels で対象モデルを特定する。フィルタ例: acomo listWorkflowModels take 10 filter '{"name":{"contains":"申請"}}' 2. モデル定義 : acomo getWorkflowModel modelId <ID で definition / dataSchema / policy の JSON を取得する。 3. プロセス操作 : 必要に応じて startWorkflowProcess / saveWorkflowProcess / submitWorkflowProcess / submitWorkflowProcessWithNodeId / approveWorkflowProcess / rejectWorkflowProcess / revertWorkflowProcess を使う。自分のプロセス一覧は listMyProcesses や listProcessWithNodeActions を検討する。主要コマンド早見用途コマンドモデル一覧 listWorkflowModels モデル定義取得 getWorkflowModel modelId <ID 編集中モデル getWorkflowModelWithLatestModelHistory modelId <ID プロセス開始 startWorkflowProcess modelId <ID データ保存 saveWorkflowProcess processId <ID '{"data":{...}}' 提出 submitWorkflowProcess processId <ID 承認 approveWorkflowProcess processId <ID 却下 rejectWorkflowProcess processId <ID 差し戻し revertWorkflowProcess processId <ID nodeId <nodeId 自分のプロセス一覧 listMyProcesses / listProcessWithNodeActions 自分のプロセス取得 getMyProcesses / getProcessWithNodeActions プロセス操作では、タスクノードでは dataSchema に沿ったデータを saveWorkflowProcess の body の data フィールドで送る。遷移は submit / approve / reject / revert で実行する。policy の write/read に従い、現在ノードで編集可能な項目だけを扱う。補足データ構造（definition / dataSchema / policy / 条件式）の詳細は [reference.md](reference.md) を参照する。全コマンド一覧は acomo help で確認する。