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

@zodchiii
İNGILIZCE1 ay önce · 14 Haz 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
Tek tıkla kaydet

YouMind ile viral makaleleri AI derin okumayla incele

Kaynağı kaydedin, odaklı sorular sorun, argümanı özetleyin ve viral bir makaleyi tek bir AI çalışma alanında yeniden kullanılabilir notlara dönüştürün.

YouMind'ı keşfet
Üreticiler için

Markdown'ınızı temiz bir 𝕏 makalesine dönüştürün

Kendi uzun yazılarınızı yayımlarken görselleri, tabloları ve kod bloklarını 𝕏 için biçimlendirmek zahmetlidir. YouMind, eksiksiz bir Markdown taslağını temiz ve hemen paylaşılabilir bir 𝕏 makalesine dönüştürür.

Markdown'dan 𝕏'e deneyin

Çözülecek daha fazla kalıp

Son viral makaleler

Daha fazla viral makale keşfet