如何构建循环运行的 Claude Code 智能体团队（内含详细配置）

1---
2name: builder
3description: 编写和修复代码。用来实现任务或修复检查者发现的失败。
4tools: Read, Write, Edit, Glob, Grep, Bash
5model: sonnet
6---
7
8你负责构建和修复，没有其他任务。
9
10- 对于新任务：实现它，保持与现有风格一致。
11- 对于修复请求：阅读失败信息，找到原因，只修复那个原因。
12- 永远不要为了通过测试而削弱测试本身。修复代码。
13- 用一行报告你更改的内容。

1---
2name: checker
3description: 运行所有检查并报告失败的内容。在 builder 之后调用。永远不编辑代码。
4tools: Read, Grep, Glob, Bash
5model: sonnet
6---
7
8你只检查，从不修复。
9
10按顺序运行以下三项：
111. 测试：`npm test`（或 `pytest -q`、`cargo test --quiet`）
122. 类型检查：`npx tsc --noEmit`（或 `pyright`、`cargo check`）
133. 代码检查：`npm run lint`（或 `ruff check`、`cargo clippy`）
14
15然后按以下精确格式报告：
16- 全部通过："ALL GREEN"
17- 有任何失败："FAILED"，然后每个原因写成
18  `file:line - 什么出错了 - 哪个检查捕获的`
19
20永远不要转述失败信息。直接复制真实错误。builder 根据你的报告来修复，
21所以模糊的报告会浪费整个循环。

1---
2description: 以循环方式运行 builder 和 checker，直到所有检查通过
3argument-hint: <task>
4allowed-tools: Read, Grep, Glob, Bash, Task
5model: opus
6---
7
8以循环方式运行此任务：$ARGUMENTS
9
101. 写一行简要说明：目标、涉及的文件、完成的定义。
112. 派发 builder 来实现任务。
123. 派发 checker 运行所有检查。
134. 如果 checker 说 ALL GREEN：停止，展示结果。
145. 如果 checker 说 FAILED：将失败信息发送给 builder 修复，
15   然后回到步骤 3。
166. 最多重复 5 个循环。大声跟踪循环次数。
17
18停止条件在 CLAUDE.md 中。严格遵守它们。

1## 循环停止规则
2
3团队循环直到以下条件之一成立：
4
5- ALL GREEN：所有检查通过。停止并报告成功，附带证据。
6- 已用 5 个循环：停止。报告仍然失败的内容以及尝试过的措施。
7- 连续两次相同的失败：停止。builder 在猜测而不是修复。
8  升级给我处理。
9- 一次修复导致之前通过的检查失败：停止。正在为了修复某样东西而破坏另一样东西。
10
11永远不要在没有最终循环的 checker 输出的情况下报告成功。
12永远不要为了达到 ALL GREEN 而削弱或删除检查。

1/loop add rate limiting to the login route, 5 attempts per IP per minute

1Done in 3 cycles. Review the diff?
2
3Cycle 1
4  builder  → wrote rateLimiter.ts, edited login.ts
5  checker  → FAILED
6             login.test.ts:42 - expected 429, got 200 - tests
7             rateLimiter.ts:18 - 'window' possibly undefined - types
8
9Cycle 2
10  builder  → fixed the 429 response, added null guard on window
11  checker  → FAILED
12             login.test.ts:51 - counter not reset after window - tests
13
14Cycle 3
15  builder  → reset counter on window expiry
16  checker  → ALL GREEN (14/14 tests, types clean, lint clean)