如何构建一个能自动循环修复 Bug 的 Claude Code Agent（内含详细设置指南）

1---
2description: 运行一个任务并自修复，直到所有测试通过
3argument-hint: <task>
4allowed-tools: Read, Write, Edit, Glob, Grep, Bash
5model: sonnet
6---
7
8任务：$ARGUMENTS
9
10循环：
111. 实现任务。
122. 运行测试套件：`npm test`（或 pytest、cargo test）。
133. 如果所有测试通过：停止并向显示结果。
144. 如果测试失败：对错误类型进行分类，指明根本原因，
15   修复该原因，然后返回步骤 2。
165. 最多尝试 5 次。每轮都公布尝试次数。
17
18先分类后修复的顺序是整个方案的关键。每轮都是先诊断后编辑。
19绝不要为了通过测试而削弱测试，要修复代码本身。

1{
2  "hooks": {
3    "PostToolUse": [
4      {
5        "matcher": "Write|Edit",
6        "hooks": [
7          { "type": "command", "command": "npm test --silent 2>&1 | tail -5 || echo 'TESTS FAILING, fix before continuing'" }
8        ]
9      }
10    ]
11  }
12}

1## 如何在修复前读取错误
2
3始终先指明错误类型。每种类型都有不同的含义：
4
5- 断言失败（期望 X，得到 Y）：逻辑错误。
6  从断言点回溯到构建该值的位置。
7  修复计算逻辑，而不是测试的期望值。
8
9- 类型错误 / undefined is not a function：形状不匹配。
10  某个值为 null，或者错误类型到达了这行代码。
11  找到该值的来源，在那里进行保护或修正。
12
13- 超时 / 挂起：缺少 await，或者 Promise 从未 resolve。
14  查找没有 await 的异步调用，或者一个永远不会翻转的条件。
15
16- 导入 / 模块未找到：路径或依赖问题，不是逻辑错误。
17  修复路径或进行安装，不要修改使用该模块的代码。
18
19- 不稳定（有时通过）：共享状态或时序问题，绝不是随机。
20  查找顺序依赖的测试或未模拟的时间/网络。
21
22规则：在编辑之前，口头说出类型和一句话的根本原因。
23如果无法指出原因，你就是在猜测。停止。

1/fix the date formatter returns wrong timezones

1Attempt 1
2  ran tests → FAILED
3  type: assertion (expected 5, got 11)
4  cause: page size not applied to the query
5  fixed the LIMIT clause
6
7Attempt 2
8  ran tests → FAILED
9  type: type error (offset is undefined)
10  cause: page 1 sends no offset, defaulted wrong
11  added offset = (page-1)*size
12
13Attempt 3
14  ran tests → ALL GREEN (7/7)
15
16Fixed in 3 attempts. Review the diff?