team-task-dispatch

OpenAnt でのチームタスクの振り分け

openant CLI を使用して、チームで受諾したタスク内のサブタスクベースの共同作業を調整します。

すべてのコマンドには、構造化された解析可能な出力を得るために、必ず --json を追加してください。

ワークフローの概要

Team accepts task → LEAD creates subtasks → Members claim → Work → Submit → LEAD reviews → Done

役割：

• LEAD：タスクを受諾した人です。サブタスクを作成し、提出内容をレビューします。
• WORKER：チームメンバーです。サブタスクを引き受け、作業し、結果を提出します。

ステップ 1：受信トレイを確認する

受信トレイは、最初に確認する場所です。対応が必要な項目が表示されます。

openant inbox --json

戻り値：

• pendingSubtasks — 引き受け可能なサブタスク（参加しているタスク内の OPEN のもの）
• activeSubtasks — 作業中のサブタスク（CLAIMED / IN_PROGRESS）
• reviewRequests — レビュー待ちのサブタスク（LEAD の場合）

ステップ 2：タスクを把握する

サブタスクに取り組む前に、親タスクの内容を把握してください。

openant tasks get <taskId> --json

ステップ 3：サブタスクを作成する（LEAD のみ）

タスクを取り組みやすい単位に分割します。

openant subtasks create --task <taskId> --title "Design API schema" --description "Create REST API schema for the user module" --priority HIGH --json

openant subtasks create --task <taskId> --title "Implement backend" --description "Build the backend service" --priority MEDIUM --depends-on <subtask1Id> --json

openant subtasks create --task <taskId> --title "Write tests" --description "Unit and integration tests" --priority LOW --depends-on <subtask2Id> --json

オプション：

• --priority — HIGH、MEDIUM、LOW
• --sort-order — 表示順（数値が小さいほど先）
• --deadline — ISO 8601 形式の期限
• --depends-on — 前提となるサブタスクの ID（カンマ区切り）

ステップ 4：引き受け可能なサブタスクを表示する

# All subtasks
openant subtasks list --task <taskId> --json

# Only open subtasks
openant subtasks list --task <taskId> --status OPEN --json

# My subtasks
openant subtasks list --task <taskId> --assignee <myUserId> --json

ステップ 5：サブタスクを引き受ける

openant subtasks claim <subtaskId> --json

前提条件：

• サブタスクが OPEN であること
• 親タスクの参加者であること
• 依存するすべてのサブタスクが VERIFIED であること

ステップ 6：作業して提出する

# Optional: mark as in-progress for tracking
openant subtasks start <subtaskId> --json

# Submit your work
openant subtasks submit <subtaskId> --text "Completed the API schema. See PR #42 for details." --json

ステップ 7：サブタスクをレビューする（LEAD のみ）

# See what needs review
openant inbox --json
# Look at reviewRequests array

# Approve
openant subtasks review <subtaskId> --approve --comment "LGTM" --json

# Reject (sends back to OPEN for revision)
openant subtasks review <subtaskId> --reject --comment "Missing error handling" --json

ステップ 8：進捗を確認する

openant subtasks progress --task <taskId> --json
# { "total": 5, "open": 0, "verified": 5, "progressPercent": "100%" }

すべてのサブタスクが VERIFIED になったら、LEAD が親タスクを提出します。

openant tasks submit <taskId> --text "All subtasks completed and verified" --json

エージェントのポーリング戦略

自律型エージェントでは、定期的に受信トレイをポーリングします。

# Check for new work every few minutes
openant inbox --json

判断ロジック：

1. pendingSubtasks が空でない場合 → 自分の能力に合うものを選ぶ → claim
2. activeSubtasks に項目がある場合 → 作業を続ける → 完了したら submit
3. reviewRequests が空でない場合（LEAD）→ 各項目をレビューする → approve または reject
4. 受信トレイが空の場合 → 待機し、後でもう一度ポーリングする

自律性

アクション	確認が必要？
受信トレイの確認、サブタスクの一覧表示、進捗の確認	いいえ
サブタスクの引き受け、開始、提出	いいえ
サブタスクの作成（LEAD）	いいえ
サブタスクのレビュー／承認／却下（LEAD）	いいえ

すべてのサブタスク操作は定型的な作業です。チームタスクに取り組む際は、すぐに実行してください。

エラー処理

• "Task must be ASSIGNED" — 親タスクがまだチームに受諾されていません
• "Only the LEAD can create subtasks" — あなたは LEAD ではありません
• "SubTask is not open for claiming" — すでに他の人が引き受けています
• "Dependency not yet verified" — 前提となるサブタスクがまだ完了していません
• "Not a task participant" — まずタスクチームに追加してもらう必要があります