用途
Agent Teams 是一套关于 Claude Code Agent Teams 的团队组建与编排知识技能。当用户任务适合并行多会话协作时，可运用该知识来组织团队。
Agent Teams 默认关闭。仅当用户以 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 显式启动会话时才使用；否则应使用普通子智能体，且不要主动提议组建团队。
何时适合使用 Agent Teams
在团队已启用的情况下，以下情形适合使用：
- 用户要求进行全面代码审查（建议 3 名审查员团队）
- 任务涉及跨多个层次的工作（前端 + 后端 + 数据库）
- 用户描述的缺陷根因不明（建议采用竞争性假设调查）
- 用户希望评估多种技术或方案（建议组建研究小组）
- 任务可清晰拆分为相互独立、文件分离的工作流
以下情形不应建议使用 Agent Teams：
- 任务为顺序执行，或涉及对同一文件的编辑
- 单个会话或子智能体即可完成
- 协调开销会超过收益
- 用户 token 预算紧张
团队模板
全面审查（3 名队友）
安全审查员 + 性能审查员 + 正确性审查员（边界情况、错误路径、调用方）。 各自独立审查，然后由负责人综合结论。
功能开发（3 名队友）
架构师（需计划审批）+ 实现者 + 审查员。 架构师先规划，实现者跟进，审查员通过评审验证差异。
调试小队（3-5 名队友）
每名队友调查不同的假设。 采用对抗性辩论结构——队友之间相互质疑对方的理论。
跨平台（3 名队友）
iOS 开发者 + Android 开发者 + 共享架构师。 各平台队友拥有自己的目录。架构师协调 API 契约。
全栈（3 名队友）
前端 + 后端 + 数据库。 每层有清晰的文件归属。先就 API 契约进行协调。
研究小组（3 名队友）
简洁性倡导者 + 性能倡导者 + 魔鬼代言人。 各自从不同视角评估，然后综合。
生成提示词公式
每个生成提示词应包含：
- 角色：“你是负责 [领域] 的 [角色] 队友”
- 文件：“你拥有 [目录] 中的文件。不要修改你范围之外的文件。”
- 重点：“特别查找 / 实现 [细节]”
- 上下文：“[队友需要的项目特定信息]”
- 交付物：“以 [格式] 报告你的发现 / 实现 [具体输出]”
跨平台注意事项
- 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- 快速团队组建命令