coordinator

协调器

概述

负责管理两项事务：输出模式切换（语音与文本）以及Agent 团队编排，以并行执行任务。

语音/文本模式切换

触发词：“vm”“voice mode” -> 切换到 VOICE。“tm”“text mode” -> 切换到 TEXT。

VOICE 模式规则

• 句子简短，每句最多 2 行
• 所有列表都使用项目符号
• 代码块不超过 3 行；否则改为口头概述
• 执行任何工具前都要确认：“我将[执行操作]。现在开始吗？”
• 使用通俗语言，避免术语
• 展示代码变更时，描述改动内容，而不是展示差异

TEXT 模式规则（默认）

• 提供完整、详细的回复，并使用代码块
• 展示差异、完整实现和详细说明
• 无需事先确认即可执行工具（破坏性操作除外）

Agent 团队编排

何时使用团队

• 任务包含 3 个或更多相互独立的子任务
• 不同子任务需要不同的专业知识（例如：实现 + 测试 + 审查）
• 工作可以并行开展，且不会产生合并冲突

编排详情

阅读 references/team-orchestration.md，了解完整的协调模式（分解 -> 波次计划 -> 派发 -> 把关 -> 验证）、Agent 启动规则、模型选择表、上下文预算管理和冲突解决。

基于计划的编排

编排结构化计划（.claude/plans/<plan-id>/）的执行时：

会话开始时

读取 plan.md 和 manifest.json。清单定义了波次和任务依赖关系。直接使用清单中的波次分组，不要重新推导波次结构。

每个波次边界处

从磁盘重新读取 manifest.json。这样可以避免因上下文压缩而丢失信息。每个波次完成后，更新清单中的任务状态。

派发 Agent

为每个 Agent 指定其简报文件。不要在派发信息中直接粘贴简报内容。在派发提示词中包含：plan-id、task-id、简报路径、工作目录。

最终波次之后

1. 可选：将执行备注写入 .claude/plans/<plan-id>/summary.md
2. 删除计划目录：rm -rf .claude/plans/<plan-id>/
3. 如果删除失败，发出警告，但不要阻塞流程

常见错误

• 在提示词中未提供完整上下文就启动 Agent
• 让多个 Agent 修改同一个文件
• 合并 Agent 的输出后跳过验证
• 对本质上需要按顺序执行的任务使用团队
• 将存在依赖关系的任务放在同一波次中（任务 B 需要任务 A 的输出 -> 应放在不同波次）
• 直接粘贴完整简报，而不是让 Agent 查看其简报文件
• 未在波次边界处重新读取清单（上下文压缩可能导致状态丢失）