Agent Teams 多代理协作
Agent Teams + Superpowers 协作方案
Summary [coverage: high – 3 sources]
Agent Teams 是 Claude Code 的多 agent 协作功能，与 Superpowers 技能体系配合形成完整的开发工作流：brainstorming（串行思考、需求澄清、方案设计）→ writing-plans（任务拆解）→ Agent Teams（并行实施）→ code-review / verify（质量把关）。每个 teammate 拥有独立的上下文窗口，共享任务列表，可直接互相通信。与普通 Subagents 的关键区别：teammates 之间能互发消息、共享任务列表、自主认领任务。团队配置存储在~/.claude/teams/{team-name}/config.json，任务列表存储在~/.claude/tasks/{team-name}/。
Key Points [coverage: high – 3 sources]
Agent Teams 核心工具
- TeamCreate— 创建团队，生成配置文件和共享任务列表
- Agent (team_name)— 将 subagent 作为 teammate 生成到团队中
- SendMessage— 按名称向任意 teammate 发消息，支持自动投递
- TaskCreate/TaskUpdate/TaskList— 共享任务列表，支持依赖关系和文件锁防竞态
- TeamDelete— 清理团队资源，必须先关闭所有活跃 teammate
- 三种显示模式：
in-process（Shift+Down 切换）、tmux（split-pane）、auto（自动检测） - 需启用环境变量
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 - 队友自动加载项目上下文（CLAUDE.md、MCP、skills），但不继承 Lead 对话历史
Superpowers 技能体系（配合 Teams 使用）
| 阶段 | 技能/工具 | 耗时 | 并发度 |
|---|---|---|---|
| 需求澄清 | superpowers:brainstorming | 15-30 min | 串行，一问一答 |
| 方案设计 | superpowers:brainstorming | 10-20 min | 串行，2-3 方案对比 |
| 设计文档 | superpowers:brainstorming | 5-10 min | 保存到docs/superpowers/specs/ |
| 实施计划 | superpowers:writing-plans | 5-10 min | 产出任务列表 |
| 并行实施 | Agent Teams | 按任务量 | 3-5 Agent 并行 |
| 代码审查 | superpowers:requesting-code-review/code-review | 按代码量 | 可多 Agent 并行 |
| 验证 | superpowers:verification-before-completion/verify | 按功能量 | 浏览器/终端验证 |
Superpowers 包含的关键技能：brainstorming（需求澄清与方案设计）、writing-plans（编写实施计划）、executing-plans（执行计划）、test-driven-development（TDD 开发）、systematic-debugging（系统化调试）、dispatching-parallel-agents（并行 Agent 调度）、verification-before-completion（完成前验证）、requesting-code-review（请求代码审查）。
Structure & Organization [coverage: high – 3 sources]
团队文件结构
~/.claude/ ├── teams/{team-name}/config.json # 团队成员配置（名称、agentId、类型） └── tasks/{team-name}/ # 共享任务列表（每个任务一个文件）任务状态流转
pending→in_progress→completed。任务可设置依赖（blockedBy/blocks）。Teammates 完成当前任务后自动认领下一个未分配、未被阻塞的任务。
完整工作流结构
brainstorming（需求澄清 + 方案设计） ↓ 产出设计文档 docs/superpowers/specs/ writing-plans（任务拆解） ↓ 产出可执行任务列表 Agent Teams（并行实施） ↓ 3-5 Agent 同时干活 code-review / verify（质量把关） ↓ 审查 + 验证 完成Usage & Patterns [coverage: high – 3 sources]
创建 Agent Team
用自然语言描述即可：
创建一个 agent team 来完成 [任务]。生成 3 个队友： - 队友A：负责前端组件 - 队友B：负责 API 接口 - 队友C：负责测试指定模型：
创建 4 个队友并行重构，每个队友使用 Sonnet 模型常见使用场景
并行代码审查：
创建团队审查 PR #142，3 个队友分别负责：安全、性能、测试覆盖率竞争假设调试：
生成 5 个队友调查不同的 Bug 假设，让他们互相讨论反驳对方的理论多角度探索：
创建团队，一个队友做 UX 设计，一个做技术架构，一个做质疑者快捷键（in-process 模式）
| 快捷键 | 功能 |
|---|---|
| Shift+Down | 切换队友 |
| Enter | 查看某个队友的会话 |
| Escape | 中断队友操作 |
| Ctrl+T | 切换任务列表 |
关闭团队
Ask the researcher teammate to shut down # 关闭单个队友 Clean up the team # 清理整个团队（先关闭所有队友）最佳实践
Agent Teams 使用原则：
- 3-5 个队友最佳，每个分配 5-6 个任务
- 避免文件冲突：确保每个队友负责不同文件
- 先做研究类任务：PR 审查、Bug 调查，熟悉后再做开发
- 等待队友完成：负责人有时会自己干活，告诉它 “Wait for your teammates to complete their tasks”
与 Superpowers 的衔接：
- brainstorming必须先于Teams：先想清楚，再动手
- brainstorming 输出设计文档后，用 writing-plans 拆任务
- 拆好的任务直接作为 Team 任务列表派发给队友
- 全部完成后用 code-review 做最终审查
- 用 verify 确认功能在真实应用中正常工作
注意事项
- 队友不会继承你的对话历史，需要在提示中给足上下文
- Token 消耗随队友数量线性增长
- 一次只能运行一个团队，不支持嵌套团队
- 需要环境变量
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
典型工作流（Lead 视角）
- Lead 发起 brainstorming → 产出设计文档
- Lead 发起 writing-plans → 产出任务列表
- Lead 创建团队 → 生成 teammates → 创建任务列表
- Teammates 自主认领任务 → 执行 → 标记完成 → 认领下一个
- 遇到阻塞时通过 SendMessage 互相通信或向 Lead 汇报
- Lead 监控进度、汇总结果
- 全部完成后，Lead 发起 code-review + verify
- Lead 关闭所有 teammate → TeamDelete 清理
实操示例：开发用户认证系统
# Step 1: brainstorming > /superpowers:brainstorming > 我要做一个用户认证系统，支持邮箱登录和 OAuth # Step 2: 经过对话，产出设计文档 docs/superpowers/specs/2026-05-29-user-auth-design.md # Step 3: 写实施计划 > /superpowers:writing-plans # 产出任务：数据库 schema、后端 API、前端页面、测试等 # Step 4: 创建 Agent Team 并行实施 > 创建一个 3 人团队： > - Alice：后端 API + 数据库 schema > - Bob：前端登录页 + OAuth 回调 > - Carol：单元测试 + E2E 测试 # Step 5: 审查验证 > /code-review > /verify环境配置
启用 Agent Teams（.claude/settings.json）：
{"env":{"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS":"1"}}安装 Superpowers 插件（~/.claude/settings.json）：
{"enabledPlugins":{"superpowers@claude-plugins-official":true}}