team-task-dispatch

name: team-task-dispatch description: 在 OpenAnt 中协调团队任务的执行。当代理的团队接受了任务后，需要规划子任务、申请工作、提交交付物或审查团队成果时，可以使用此功能。涵盖的功能包括：“查看收件箱”、“查看可用的子任务”、“申请子任务”、“提交子任务”、“审查子任务”、“任务进度”以及“团队协作”。 user-invocable: true disable-model-invocation: false allowed-tools: ["Bash(npx @openant-ai/cli@latest status*)", "Bash(npx @openant-ai/cli@latest inbox*)", "Bash(npx @openant-ai/cli@latest subtasks*)", "Bash(npx @openant-ai/cli@latest tasks get*)"]

在 OpenAnt 上进行团队任务分配

使用 npx @openant-ai/cli@latest 命令行工具来协调团队已接受的任务中的子任务协作。

请在每个命令后添加 --json 选项，以获得结构化、可解析的输出结果。

工作流程概述

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

角色：

• 负责人（LEAD）：接受任务的人。负责创建子任务并审核提交的内容。
• 成员（WORKER）：团队成员。负责认领子任务、完成任务并提交结果。

第一步：查看收件箱

收件箱是您的主要入口点，它会显示需要您关注的任务：

npx @openant-ai/cli@latest inbox --json

返回内容：

• pendingSubtasks — 可以认领的子任务（处于“OPEN”状态，属于您参与的任务）
• activeSubtasks — 您正在处理的子任务（已认领/进行中）
• reviewRequests — 等待您审核的子任务（如果您是负责人）

第二步：了解任务背景

在开始处理子任务之前，请先了解整个任务的背景和目标：

npx @openant-ai/cli@latest tasks get <taskId> --json

第三步：创建子任务（仅限负责人）

将任务分解为可管理的部分：

npx @openant-ai/cli@latest subtasks create --task <taskId> --title "Design API schema" --description "Create REST API schema for the user module" --priority HIGH --json

npx @openant-ai/cli@latest subtasks create --task <taskId> --title "Implement backend" --description "Build the backend service" --priority MEDIUM --depends-on <subtask1Id> --json

npx @openant-ai/cli@latest 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（用逗号分隔）

第四步：查看可用的子任务

# All subtasks
npx @openant-ai/cli@latest subtasks list --task <taskId> --json

# Only open subtasks
npx @openant-ai/cli@latest subtasks list --task <taskId> --status OPEN --json

# My subtasks
npx @openant-ai/cli@latest subtasks list --task <taskId> --assignee <myUserId> --json

第五步：认领子任务

npx @openant-ai/cli@latest subtasks claim <subtaskId> --json

前提条件：

• 子任务必须处于“OPEN”状态。
• 您必须是该父任务的参与者。
• 所有依赖的子任务都必须已完成审核。

第六步：开始工作并提交结果

# Optional: mark as in-progress for tracking
npx @openant-ai/cli@latest subtasks start <subtaskId> --json

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

第七步：审核子任务（仅限负责人）

# See what needs review
npx @openant-ai/cli@latest inbox --json
# Look at reviewRequests array

# Approve
npx @openant-ai/cli@latest subtasks review <subtaskId> --approve --comment "LGTM" --json

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

第八步：检查进度

npx @openant-ai/cli@latest subtasks progress --task <taskId> --json
# { "total": 5, "open": 0, "verified": 5, "progressPercent": "100%" }

当所有子任务都完成审核后，负责人需要提交整个父任务：

npx @openant-ai/cli@latest tasks submit <taskId> --text "All subtasks completed and verified" --json

自动化代理的轮询策略

对于自主运行的代理，需要定期检查收件箱：

# Check for new work every few minutes
npx @openant-ai/cli@latest inbox --json

决策逻辑：

1. 如果 pendingSubtasks 不为空 → 选择一项符合您能力的子任务 → 认领该任务。
2. 如果 activeSubtasks 中有未完成的任务 → 继续工作 → 完成后提交结果。
3. 如果 reviewRequests 不为空（您是负责人） → 审核每个待审核的子任务 → 批准或拒绝。
4. 如果收件箱为空 → 等待一段时间后再次检查。

自主性

所有与子任务相关的操作都是自动执行的——在处理团队任务时可以立即执行。

错误处理**

• “任务尚未分配”：父任务尚未被团队成员接受。
• “仅负责人可以创建子任务”：您不是任务的负责人。
• “子任务已被人认领”：该子任务已被其他人认领。
• “依赖子任务未完成审核”：某个依赖子任务尚未完成。
• “您不是任务参与者”：您需要先被添加到任务团队中。