agent-teams

Agent Teams 组建技能

你精通 Claude Code Agent Teams 的组建与协调。当用户的任务适合并行多会话协作时，请运用这项知识。

Agent Teams 默认关闭。仅当用户通过 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 显式启动会话时才使用；否则请使用普通子 Agent，不要主动建议组建团队。

适合使用 Agent Teams 的情况

启用团队后，以下情况适合使用团队：

• 用户要求全面的代码审查（建议组建 3 人审查团队）
• 任务涉及多个层面（前端 + 后端 + 数据库）
• 用户描述了根因不明确的错误（建议通过相互竞争的假设开展调查）
• 用户希望评估多种技术或方案（建议组建研究小组）
• 任务可明确拆分为相互独立、涉及不同文件的工作流

以下情况请勿建议组建 Agent Teams：

• 任务是顺序执行的，或涉及同一文件的编辑
• 单个会话或子 Agent 就足以完成
• 协调开销会超过收益
• 用户的令牌预算紧张

团队模板

全面审查（3 名队友）

安全审查员 + 性能审查员 + 正确性审查员（边界情况、错误路径、调用方）。 每位审查员独立审查，随后由负责人综合结果。

功能开发（3 名队友）

架构师（需先批准计划）+ 实施者 + 审查员。 架构师先制定计划，实施者随后执行，审查员通过审查验证差异。

调试小组（3–5 名队友）

每位队友调查不同的假设。 采用对抗式辩论结构——队友彼此质疑对方的理论。

跨平台开发（3 名队友）

iOS 开发者 + Android 开发者 + 共享架构师。 各平台队友分别负责自己的目录。架构师协调 API 契约。

全栈开发（3 名队友）

前端 + 后端 + 数据库。 明确划分各层的文件归属。首先协调 API 契约。

研究小组（3 名队友）

简约倡导者 + 性能倡导者 + 反方倡导者。 每位成员从不同角度进行评估，随后综合结果。

启动提示词公式

每条启动提示词都应包含：

1. 角色：“你是负责 [领域] 的 [角色] 队友”
2. 文件：“你负责 [目录] 中的文件。不要修改职责范围以外的文件。”
3. 重点：“具体查找 / 实现 [细节]”
4. 上下文：“[队友需要了解的项目特定信息]”
5. 交付内容：“以 [格式] 报告调查结果 / 实现 [具体产出]”

跨平台注意事项

• macOS 和 Linux：全面支持（进程内 + tmux 分屏）
• Windows：仅支持进程内模式（使用 auto 设置时自动启用）
• 始终使用 --teammate-mode auto（默认值）进行自动检测

相关文档

• ~/.claude/docs/AGENT-TEAMS.md - 完整指南及示例
• ~/.claude/docs/reference/workflows/agent-teams.md - 决策框架
• ~/.claude/commands/assemble-team.md - 快速组建团队命令