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 で指定する。
# 環境変数で認証（非インタラクティブ向け）
export ACOMO_ACCESS_TOKEN="your-token"
export ACOMO_TENANT_ID="your-tenant-id"
# または login で保存
acomo login --tenant-id <tenantId> --access-token <accessToken>| 環境変数 | 説明 | 必須 |
|---|---|---|
ACOMO_ACCESS_TOKEN | アクセストークン | Yes |
ACOMO_TENANT_ID | テナント ID | Yes |
ACOMO_BASE_URL | API Base URL（省略時: https://acomo.app） | No |
CLI の出力は JSON です。パラメータは acomo <operationId> --help で確認する。
呼び出し形式
acomo <operationId> [--option value...] [body-json]- path/query パラメータ →
--name value形式の named option - リクエストボディ → 位置引数の JSON 文字列（または stdin）
# path param のみ（GET など）
acomo getWorkflowModel --modelId <ID>
# query params
acomo listWorkflowModels --take 10 --filter '{"name":{"contains":"申請"}}'
# body のみ（POST）
acomo createWorkflowModel '{"name":"経費申請","definition":{},"dataSchema":{},"policy":{}}'
# path param + body（PUT）
acomo saveWorkflowModel --modelId <ID> '{"name":"経費申請","definition":{},"dataSchema":{},"policy":{}}'
# stdin から body を渡す
echo '{"name":"経費申請","definition":{},"dataSchema":{},"policy":{}}' | acomo createWorkflowModel標準フロー
- モデル一覧:
acomo listWorkflowModelsで対象モデルを特定する。フィルタ例:acomo listWorkflowModels --take 10 --filter '{"name":{"contains":"申請"}}' - モデル定義:
acomo getWorkflowModel --modelId <ID>で definition / dataSchema / policy の JSON を取得する。 - プロセス操作: 必要に応じて
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 を参照する。
- 全コマンド一覧は
acomo --helpで確認する。
