案件と引き継ぎ

実案件を開始し、責任を割り当て、成果を残し、レビューして再開します。

案件を開始して読む

epismo case start --version-id <version-id> --case-input '{"customer":"Acme"}'
epismo case start --title "Review contract exception"
epismo case get <case-id>
epismo case list --status open
epismo case list --assigned-to <user-id>
epismo case popular

仕事の共同作業者に対する case get は、案件本体、現在のタスク、その案件の最新 5 件の記録（新しい順）、直接の引き継ぎ関係、読み取り可能な開始元プレイブックと固定した Version を返します。公開アクセスだけを持つ閲覧者には、現在のタイトル、入力、その案件の最新 5 件の記録、読み取り可能な引き継ぎ関係を返し、タスク・担当・共同作業者の識別情報は返しません。Public にすると、後から追加する記録も含めて現在の内容が即座に公開されます。古い記録は case record list --cursor <records_next_cursor> と返された records_scope（self）で続けて取得します。CLI 出力は snake_case、API/MCP は recordsNextCursor と recordsScope を使います。

公開案件の読み取りは Web・CLI・API・MCP でログインなしでも 0 credits です。API / CLI / MCP の仕事の詳細取得は補助取得を 案件 get 1 回分の 1 credit にまとめ、通常の Web 閲覧は無料です。

再現性のために指針を固定する場合は Version に紐づく案件、共有価値はあるもののプレイブックがない場合は都度作成の案件を使います。どちらもタスクを自動作成しません。

assign と役割分担

epismo case acl <case-id> --acl <principal-ids> --lock-version <n>
epismo case assign <case-id> --assigned-to <user-id> --lock-version <n>
epismo case task create <case-id> --kind work --title "Verify totals" \
  --instructions "Use the latest invoice" --assigned-to <user-id>
epismo case task create <case-id> --kind approval --title "Approve recommendation" \
  --subject-record-id <record-id> --assigned-to <user-id>
epismo task list --status open

割り当て前に User を案件 ACL へ追加します。案件全体の責任には案件、一つの明示的な仕事または承認にはタスクを割り当てます。承認タスクは対象記録を正確に指定してください。top-level の task list は現在のユーザーに割り当てられたタスクを既定で表示します。別の担当者を見るときだけ --assigned-to を指定します。

案件の引き継ぎ（handoff）

epismo case handoff create <from-case-id> --to-case-id <to-case-id>
epismo case handoff create <to-case-id> --from-case-id <from-case-id>
epismo case handoff remove <case-id> <handoff-id>
epismo case handoff graph get <case-id> --scope connected
epismo case handoff candidates list <case-id> --direction outgoing

連続する案件や依存関係にある案件を有向エッジ（fromCaseId -> toCaseId）で接続します。引き継ぎの作成・削除には元案件の閲覧権限と先案件の編集権限が必要です。公開案件は、編集できる案件へ続けられますが、閲覧だけでは公開案件へ仕事を接続できません。ループや循環は拒否されます。epismo case handoff graph get で案件周辺の DAG を確認できます。

記録を追記・更新して読む

epismo case record append <case-id> --kind output --origin agent --content "..."
epismo case record append <case-id> --kind review --origin agent --data '{"verdict":"pass"}' --content "..."
epismo case record append <case-id> --task-id <task-id> --input @evidence.json
epismo case record update <record-id> --content "..."
epismo case record delete <record-id>
epismo case record list <case-id> --scope ancestors --order asc

進行中の案件の ACL に含まれる参加者は全員、記録の追記、タスクの更新、案件のタイトル変更・担当変更・終了・再開、Epismo AI review の実行ができます。アクセス変更とアーカイブは現在の担当者に限られます。クライアントが書く Record kind は note、output、または review（data.verdict は pass、changes_requested、insufficient）。activity は server のみです。user または agent が作った記録の更新・削除は作成者だけが行えます。--scope（self、ancestors、descendants、neighbors、connected）を指定することで、引き継ぎ関係にある案件の記録も含めて取得できます。絞り込みは時系列を絞り、返された cursor で安定したページ送りを継続します。

update と close

epismo task update <task-id> --title "Verify totals and tax" \
  --instructions "Use the signed invoice" --assigned-to <user-id> --lock-version <n>
epismo task set status <task-id> --status closed --outcome approved --lock-version <n>
epismo task set status <task-id> --status open --lock-version <n>
epismo case update <case-id> --title "Updated title" --lock-version <n>
epismo case update <case-id> --auto-review --lock-version <n>
epismo case review <case-id>
epismo case review <case-id> --prompt "引用漏れを blocker として指摘してください。"
epismo case overview <case-id>
epismo case close <case-id> --outcome completed --lock-version <n>
epismo case reopen <case-id> --lock-version <n>

タスクまたは案件を close するときに --input または対応 flag で records array を渡すと、最終記録をまとめて追記できます。completed には全タスクの close が必要です。cancel と abandon は残りタスクを close し、案件を reopen してもタスクは closed のままです。案件の編集者は case review で進行中の案件の共有証拠に対する Epismo AI review をキューでき、呼び出しは即座に返ります。承認タスク（approval）とは別です。任意の --prompt で固定のレビュー規則のあとに呼び出し側の指示を追加できます。その REVIEW 記録は case record list --kinds review --origins system で確認し、完了後に同じ idempotency key を再送すると受け取れます。案件の編集者は case overview で一発の状況ブリーフも取れます。同期で応答に本文が返ります。同じ idempotency key を再送すると再生成せず前回のブリーフを受け取ります。--auto-review による自動レビュー、case review、case overview は、AI モデルの消費 token に応じて、開始時に固定した案件の billing account から課金されます。