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-processShiftDown 切换、tmuxsplit-pane、auto自动检测需启用环境变量CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS1队友自动加载项目上下文CLAUDE.md、MCP、skills但不继承 Lead 对话历史Superpowers 技能体系配合 Teams 使用阶段技能/工具耗时并发度需求澄清superpowers:brainstorming15-30 min串行一问一答方案设计superpowers:brainstorming10-20 min串行2-3 方案对比设计文档superpowers:brainstorming5-10 min保存到docs/superpowers/specs/实施计划superpowers:writing-plans5-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-developmentTDD 开发、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 #1423 个队友分别负责安全、性能、测试覆盖率竞争假设调试生成 5 个队友调查不同的 Bug 假设让他们互相讨论反驳对方的理论多角度探索创建团队一个队友做 UX 设计一个做技术架构一个做质疑者快捷键in-process 模式快捷键功能ShiftDown切换队友Enter查看某个队友的会话Escape中断队友操作CtrlT切换任务列表关闭团队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_TEAMS1典型工作流Lead 视角Lead 发起 brainstorming → 产出设计文档Lead 发起 writing-plans → 产出任务列表Lead 创建团队 → 生成 teammates → 创建任务列表Teammates 自主认领任务 → 执行 → 标记完成 → 认领下一个遇到阻塞时通过 SendMessage 互相通信或向 Lead 汇报Lead 监控进度、汇总结果全部完成后Lead 发起 code-review verifyLead 关闭所有 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:{superpowersclaude-plugins-official:true}}