Acomo

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>

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

標準フロー

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 を検討する。

主要コマンド早見

プロセス操作では、タスクノードでは dataSchema に沿ったデータを saveWorkflowProcess の body の data フィールドで送る。遷移は submit / approve / reject / revert で実行する。policy の write/read に従い、現在ノードで編集可能な項目だけを扱う。

補足

• データ構造（definition / dataSchema / policy / 条件式）の詳細は reference.md を参照する。
• 全コマンド一覧は acomo --help で確認する。

acomo データ構造リファレンス

acomo スキル（SKILL.md）の補助資料。getWorkflowModel で取得する JSON の definition / dataSchema / policy を読むときの型と用語をまとめる。

ModelDefinition（ワークフロー定義）

type ModelDefinition = {
  nodes: Node[]; // ワークフローのノード（タスク、イベント、分岐など）
  edges: Edge[]; // ノード間の接続
};

Node（ノード）

type Node = {
  id: NodeId; // ノード固有ID（文字列）
  name: string; // ノード名（日本語）
  type: NodeType; // ノード種別
  eventType?: "start" | "end"; // イベントノードの場合の種別
  actionPolicies?: {
    // 操作権限ポリシー
    type: NodeActionType; // アクション種別
    allow: BinaryExpression; // 許可条件式
    description?: string; // 説明
  }[];
  conditions?: {
    // 分岐条件（exclusiveFork, parallelJoin）
    expression: BinaryExpression;
    type?: FlowType;
    destination: NodeId;
  }[];
  position?: { x: number; y: number }; // エディタ上の座標（表示用。業務ロジックでは不要なら無視してよい）
  canRevert?: boolean; // 差し戻し可能か
};

NodeType（ノード種別）

NodeActionType（アクション種別）

Edge（エッジ）

type Edge = {
  from: string; // 遷移元ノードID
  to: string; // 遷移先ノードID
  type: FlowType[]; // 遷移種別の配列
};

FlowType（遷移種別）

ModelDataSchema（データスキーマ）

JSON Schema のサブセット。ワークフローで扱うデータの構造を定義する。

type ModelDataSchema = {
  type: "object";
  properties: {
    [key: string]: ModelDataSchemaProperty;
  };
  required?: string[];
  additionalProperties: false;
};

type ModelDataSchemaProperty = {
  type: "string" | "number" | "date" | "object" | "array";
  title: string; // 日本語ラベル
  description?: string; // 説明
  enum?: string[]; // 列挙値（type が 'string' の場合）
  items?: any; // 配列要素のスキーマ（type が 'array' の場合）
  _order?: number; // 表示順序（10, 20, 30...）
  _acomoType?: string; // acomo 独自拡張型
  _recordKey?: string; // レコード型のキー
};

\_acomoType（独自拡張型）

ModelPolicy（データアクセスポリシー）

各ノードで各データフィールドに対する読み書き権限を定義する。

type ModelPolicy = {
  [nodeId: NodeId]: {
    [propertyKey: string]: "write" | "read";
  };
};

• write: そのノードでフィールドを編集可能
• read: そのノードでフィールドは読み取り専用

ノードIDに対応するエントリがない場合、そのノードではフィールドにアクセスできない。

BinaryExpression（条件式）

actionPolicies の allow や conditions の expression で使用される条件式。

type BinaryExpression = {
  operator: "and" | "or" | "==" | "!=" | "has" | "in" | "belongsTo";
  expression1: BinaryExpression | string;
  expression2: BinaryExpression | string;
};

主なオペレーター

式中の変数