【Claude Code】带你了解 Agent Teams 及实践细节

Agent Teams

Agent Teams 功能它允许主 Claude Code 会话充当“团队负责人”或“项目经理”的角色，协调并管理多个独立的 AI 代理，共同完成复杂的任务。

在开始 Agent Teams 工作前，我们要做好前置工作，让 Claude 能更好的执行工作。

前置知识

代理团队与子代理的核心区别？

• 并行工作与直接通信：常规的子代理通常独立工作并将结果直接发回给主代理；而代理团队拥有一个共享的任务列表，各个代理可以并行工作并相互直接通信。例如，前端和后端代理可以将代码发送给 QA 代理，QA 代理发现漏洞后能直接将任务打回给开发代理进行迭代修复，形成高效的反馈循环。
• 上下文与权限继承：代理在唤醒时是没有任何历史对话上下文的。但它们会继承主会话的权限（例如绕过权限或允许 bash 命令），并且团队中的所有成员都能直接访问工作区内的文件、MCP 服务器以及技能

前期设置

• 明确需求：你可以在头脑风暴中brainstrom.md中输出你想要 Agent Teams 的工作方式，无缝接入。用自然语言去组织团队，明确每个 Agent 应该执行的任务，设定明确的整体目标，让每个代理明白它们为何被唤醒以及最终要交付什么， 可以某个代理运用特定模型。

• 提供标准的仓靠文档： 在项目中，可以将官方的 Agent Teams 文档发给 Claude，有助于 Claude 更好的管理代理团队，prompt：

  为代理团队创建一个在docs的文件夹中的主参考指南。这将有助于您在未来构建更优秀、更高效的代理团队。这是参考url
  https://code.claude.com/docs/en/agent-teams

• 分配专属文件：必须让每个代理负责并编辑自己专属的文件，分出独立空间。如果多个代理同时编辑同一个共享文件，它们可能会互相覆盖对方的工作成果。

  

• 控制团队规模在 3 到 5 人：由于代理团队是并行运行的，Token 会成倍增加；另外过多的 Agent 会增加工作的复杂度，并不是越多越好的。

• 熟练运用 Plan mode 模式： 在项目规划初期使用，让 Claude 帮你想到你没想到的问题。比如说各个子代理之间的如何联系，是通过file 还是某种方式？

注意事项

• 审批模式：在代理实际执行任务前，先规定它们制定计划或者后期修改计划方向都由主代理（或本人）进行审批确认，这样可以更好地控制项目走向
• 不要将代理团队用于简单的顺序型任务：如果任务是可以按“第一步、第二步、第三步”顺序完成的，且步骤间仅依赖上一步的结果而不需要互相交流，使用普通的子代理即可，不要使用代理团队，否则会大材小用且浪费成本。如果确认要使用 Teams 模式要明确各代理之间是并行执行
• 如果只需要单一的对话上下文历史或只在完全相同的文件上工作，不要使用代理团队。代理团队的优势在于解决需要各个专业领域代理并行工作、互相反应、分配任务和频繁沟通的复杂高要求项目

完整流程提示

这些都能写到brainstrom.md，然后再执行Workflow部分的执行流程，更加规范化

1. 设定全局目标与背景

项目目标： [详细描述项目的最终目的，例如：构建一个带有 React 前端和 REST API 的完整全栈应用。最终结果应该是一个我可以在本地环境中查看并运行的程序，具备用户和发帖功能]。

2. 组建团队与指定模型

请使用 Sonnet 模型 创建一个由 3 名队友组成的团队。

3. 定义角色、依赖关系

• 第一个代理是 后端开发者，名字为Loues：主要工作是 设计并编写 REST API 逻辑。专门负责并只能编辑 [后端相关的文件/数据库文件夹] 。当你完成这部分工作后，请主动发消息通知Marcus。
• 第二个代理是 前端开发者， 名字为Marcus：工作是 构建 React 组件并对接 API。请等待 Loues 发送消息后再开始执行。你专门负责并只能编辑 前端 UI 文件夹。完成界面和对接后，请将所有的工作成果发送给 Mathew。
• 第三个代理是 QA 测试代理， 名字为Mathew：工作是测试Marcus和Loues提交的代码。你需要仔细检查所有功能，如果发现任何问题，请直接指出并打回给相应的开发者让他们重新修改，直到所有关键问题解决为止。

4. 明确最终交付物

最终交付物必须包含：

一个完整且能够正常运行的应用程序。
一份详细的 QA 测试报告，确认测试通过与失败的情况。
一份开发文档，记录项目中做出的关键决策以及后续如何运行该程序的说明。

QA 测试报告，确认测试通过与失败的情况。
一份开发文档，记录项目中做出的关键决策以及后续如何运行该程序的说明。

这就整合了 Claude docs 层面有完整的项目进度、系统架构、PRD、EDD、测试报告、开发文档、git 提交记录，能让我们开发更加得心应手。

希望对你有所帮助，祝你身体健康。