如何打造一支 Claude Code 团队,让每个 Agent 各司其职(附详细配置方案)

@zodchiii
INGLÊShá 1 mês · 14 de jun. de 2026
302K
195
35
27
633

TL;DR

本指南提供了 Claude Code 四人 Agent 团队的完整配置方案,通过为编写者、审查者、测试者和教练分配明确角色,最大化开发效率并确保代码质量。

尼克斯队刚拿下了他们 53 年来的首个总冠军,而他们甚至不是联盟里天赋最强的球队!

他们之所以能赢,是因为每个球员都清楚自己的唯一职责,并且全力执行。

大多数开发者运行 Claude Code 时,就像用一个全能型选手包揽一切:写代码、测试、审查,全都在模糊的一次性会话里完成。

下面是一套 4 人阵容,每个角色有单一职责:写手、测试员、审查员,还有一个负责指挥的教练。

完整的设置如下 👇

在深入之前,我会在 Telegram 频道里每天分享关于 AI 和 vibe coding 的笔记:

https://t.me/zodchixquant 🧠

darkzodchi - inline image

球员 1:写手

放入 .claude/agents/writer.md 文件:

yaml
1---
2name: writer
3description: 实现功能特征。当需要编写代码时调用。返回可工作的代码,不做审查。
4tools: Read, Write, Edit, Glob, Grep, Bash
5model: sonnet
6---
7
8你编写的代码是可直接交付的。你不做审查,也不做测试。
9
101. 阅读任务简报。确定工作范围。
112. 完整阅读你需要的上下文文件。
123. 编写实现代码,匹配现有风格。
134. 运行构建,确认语法上没有错误。
145. 用一段话总结你写的内容,附上文件:行号引用。
15
16你不编写测试。你不审查自己的工作。
17做好自己的本分。

球员 2:审查员

放入 .claude/agents/reviewer.md 文件:

yaml
1---
2name: reviewer
3description: 审查本次会话中编写的代码。在写手之后调用。返回发现的问题,从不直接编辑。
4tools: Read, Grep, Glob, Bash
5model: sonnet
6---
7
8你审查的不是你自己编写的代码。你不编辑代码,你只找出问题。
9
101. 运行 `git diff` 查看变更内容。
112. 完整阅读发生变更的文件。
123. 检查:Bug、边界情况、安全漏洞、约定破坏、
13 缺失的错误处理。
144. 输出:紧急、重要、琐碎之处。每条均附上文件:行号。
15
16如果没有发现紧急问题,请如实说明。不要为了显得有用
17而捏造问题。针对代码,不要针对人。

球员 3:测试员

放入 .claude/agents/tester.md 文件:

yaml
1---
2name: tester
3description: 为本次会话中的代码编写测试。在写手之后调用。针对规格说明而非实现进行测试。
4tools: Read, Write, Edit, Bash
5model: sonnet
6---
7
8你编写的测试能够抓住真正的 Bug。
9
101. 阅读规格说明,而不仅仅是代码。
112. 识别每一个分支、边界情况以及错误路径。
123. 匹配现有的测试惯例。
134. 编写的测试能够在代码出错时失败,而不是
14 逐行镜像代码的测试。
155. 运行测试。诚实报告通过/失败。绝不要为了通过而弱化测试。
16
17优先级:边界情况优先,错误路径其次,快乐路径最后。

球员 4:教练

这是你真正调用的编排者。

放入 .claude/commands/ship.md 文件:

yaml
1---
2description: 将写手、测试员和审查员组队执行一个任务
3argument-hint: <task>
4allowed-tools: Read, Grep, Glob, Bash, Task
5model: opus
6---
7
8交付此任务:$ARGUMENTS
9
101. 撰写一段话的简报:目标、涉及的文件、
11 完成标准、不包含的内容。
122. 并行调度写手和测试员,并附上简报。
13 测试员依据规格说明设计,而不是依据写手的代码。
143. 当写手完成后,调度审查员审查差异。
154. 收集全部三份报告。向我展示一份总结:
16 - 写手:交付了什么(文件:行号)
17 - 测试员:编写的测试,通过/失败
18 - 审查员:紧急、重要、琐碎之处
195. 不要提交。等待我的指令。

你只需要输入 /ship add rate limiting to the login route,教练就会运行整个阵容,然后给你一份报告。

darkzodchi - inline image

常见错误

让写手自我审查。 这就像是让明星球员自己给自己的比赛打分。保持审查员的独立性,并且不让其了解写手的思路。

让测试员先读取实现代码。 这样测试就会镜像代码本身而不是规格说明,即使逻辑有误,测试也能通过。永远要规格说明优先。

给每个智能体所有工具。 审查员不需要写权限。工具越受限,角色就越清晰。

跳过简报。 如果没有教练撰写一份共享简报,每个智能体都会以不同的方式解读任务,从而导致工作出现偏差。简报就是作战手册。

10 分钟即可完成设置

3 分钟:在 .claude/agents/ 中创建写手、测试员和审查员。

2 分钟:在 .claude/commands/ship.md 中创建教练。

2 分钟:提交这些文件,这样你的团队就能拉取同一套阵容。

3 分钟:对一个真实任务运行 /ship,观看整个阵容的配合。

尼克斯队不是靠五位明星球员包揽所有投篮才赢的。他们是靠五个明确的角色分工赢的。你的 Claude Code 设置也会以同样的方式变得更高效。

感谢阅读!

我在 Telegram 频道里每天分享关于 AI、金融和 vibe coding 的笔记:

https://t.me/zodchixquant

darkzodchi - inline image
Salvar com um clique

Faça leitura profunda de artigos virais com IA no YouMind

Salve a fonte, faça perguntas específicas, resuma o argumento e transforme um artigo viral em notas reutilizáveis em um único espaço de trabalho com IA.

Explorar o YouMind
Para criadores

Transforme seu Markdown em um artigo 𝕏 impecável

Quando você publica seus próprios textos longos, formatar imagens, tabelas e blocos de código para o 𝕏 é uma dor de cabeça. O YouMind transforma um rascunho completo em Markdown em um artigo 𝕏 impecável e pronto para publicar.

Experimente Markdown para 𝕏

Mais padrões para decifrar

Artigos virais recentes

Explorar mais artigos virais