RSS

第 6 章 / 共 12 章

主循环:探索 → 计划 → 实现 → 验证 → 提交

约 8 分钟 更新于

6.1 即兴发挥是最贵的用法

前面五章都是零件,这一章把它们装成一条可以每天重复的流水线。

新手的典型用法是”想到哪说到哪”:先让它改一点,看效果不对再说一句,再改一点。这条路径的问题不是慢,而是没有任何一个点可以判断”做完了”——于是任务会一直拖到你累了为止。

官方最佳实践页给出的循环是:探索 → 计划 → 实现 → 提交。结合前面几章,这里把”验证”显式拆出来,因为它是最容易被跳过、也最不该被跳过的一环。

第6章:五步主循环
图 6.1:注意第四格是一道闸门而不是一个步骤。验证不通过就退回实现,通过才允许进入提交——如果你发现自己经常从”实现”直接跳到”提交”,那这一轮其实没有闭环。

6.2 第一步:探索(只读)

目标是让它建立对问题的认识,而不是急着动手。

不要改任何代码。先搞清楚:用户切换账号后还能看到上一个账号的订单,
这个数据是从哪一层带过来的?把涉及的文件和调用链列出来。

关键词是”不要改任何代码”。如果任务涉及大量文件,按第 5 章的做法交给子代理去读。

6.3 第二步:计划(进入 plan 模式)

Shift + Tab 切到计划模式,或者启动时指定:

claude --permission-mode plan

在这个模式下它只读不写,产出一份方案。然后你做三件事:

  1. 读方案,而不是扫一眼——这是你成本最低的一次纠错机会;
  2. 需要大改时,用 Ctrl + G 把方案拉到你的编辑器里改;
  3. 确认后再放行。

什么时候可以跳过计划? 官方文档说得很直白:计划模式本身有开销,如果你能用一句话描述这个 diff,就跳过它。改一个常量、加一行日志,不需要走这一步。

6.4 第三步:实现(一次一步)

方案确认后,把自动化档位调到 acceptEditsauto,让它执行。这一段的纪律是第 3 章那条:一次只推进一步,每一步都要有可判断的产出。

如果计划里有五步,逐步放行,而不是说一句”按计划全做完”。

6.5 第四步:验证(本循环的核心)

要求证据,而不是结论。三种表述的效果依次递增:

❌ 做完了吗?
⚠️ 确认一下测试通过了
✅ 跑 npm test,把完整输出贴出来。如果有失败,先不要修,告诉我失败的是哪几个用例

官方文档给出了一条从轻到重的”验证阶梯”,你可以按任务重要性选一档:

  1. 在提示里写清验证方式(日常任务够用);
  2. 用一个明确的完成条件约束它;
  3. 用钩子在它宣布结束时强制跑检查(第 8 章);
  4. 用一个独立的子代理来审查产出。

第 4 档还有一个变体很好用:开一个新会话去 review 上一个会话的 diff。官方给的理由很有说服力——新会话不会偏袒它自己刚写的代码。

不过官方也给了配套的警告:如果你让一个审查者”去找问题”,它一定能找出一些。要限定它只报正确性问题和需求缺口,否则你会收获一堆过度工程的建议。

6.6 第五步:提交

把这次改动提交,commit message 说明修的是什么问题和为什么这样修。
然后开一个 PR,描述里包含复现步骤和测试结果。

一个建议:频繁地小提交。每个提交都是一个存档点,出问题时你回退的粒度就是提交的粒度。这也是多位实践者共同强调的一点——把版本控制当作和 AI 协作的基础设施,而不是收尾工作。

6.7 完整走一遍

假设任务是”修复切换账号后订单串号的问题”:

步骤你说的话你要看到的东西
探索“不要改代码,找出订单数据的来源链路”文件清单 + 调用链
计划(切 plan 模式)“给出修复方案,说明为什么改这里”一份你能读懂并同意的方案
实现“执行第一步:给中间件加 session 校验”一个小而完整的 diff
验证“写一个复现这个 bug 的失败测试,先跑给我看它失败”红色的测试输出
验证“现在修,再跑一次”绿色的测试输出
提交“提交并开 PR,描述里带复现步骤”一个可以给人 review 的 PR

注意”先让测试失败,再让它通过”这个顺序。它的价值不是形式,而是证明这个测试真的在测你以为的东西——一个从来没红过的测试,可能只是恒真。

6.8 五种常见失败模式

官方文档列出了一组失败模式,配上对策就是一张排错表:

失败模式表现对策
厨房水槽会话一个会话干了三件不相干的事/clear
反复纠正同一个问题纠正了三四次两次纠正规则:清空 + 重写提示
CLAUDE.md 过度规定写了两百条规则,它一条都不遵守精简,或改用钩子强制(第 7、8 章)
信任但没验证“看起来做完了”就合并提供可运行的检查;无法验证就不要发布
无限探索一直在读文件,不产出结论限定范围,或改用子代理

6.9 本章练习与检查点

你现在的成果:你有了一条可以每天重复的流水线。到这里,日常使用的核心内容已经完整了;接下来的章节是把它从”你会用”变成”你的团队会用”。

广告位 · Multiplex 关联广告