第 02 模块 · 2 节

编写高质量执行计划

《Claude Code 进阶实战》02 计划模式 · 本节时长 34 分钟

计划贵在「可执行」,不是「好看」

上一节讲了计划模式是什么。这一节解决:怎么让 Claude Code 产出一份真正高质量的、可执行的计划

一份空话套话的计划毫无价值,比如「我们要认真优化系统、提升质量」——说了等于没说。真正的计划要具体到能照着做。

对 codex-review 来说,「评审计划」的好坏直接决定评审质量:一份可执行的评审计划,审出来的是能照着修的报告;一份空话计划,审出来的也是空话。 这一节把「好计划的四要素」套到评审规划上。

贯穿项目codex-review 的「评审流程规划」就是一份执行计划:目标(审出什么问题)、步骤(派几路、每路怎么审)、涉及文件(审哪些)、风险与回滚(审漏/审偏了怎么办)。用这一节的四要素,就能把评审计划写到位。

一份好计划的四个要素

1. 目标明确

一句话说清「做完后是什么样」。要可验证,而不是形容词。

❌ 「提升性能」 ✅ 「让首页首屏加载时间从 2s 降到 1s 以内」

对评审,目标不是「认真审一遍」,而是「明确审出哪几类问题」:

❌ 「把这次改动审一遍」 ✅ 「对 src/ 本次 30 个文件改动,审出逻辑、安全、风格三类问题,输出按『必须改 / 建议改 / 可不改』分档、可直接照着修的清单」

2. 步骤可执行

每一步都要有「怎么做」和「怎么验证」。不行的步骤,等于没计划。

❌ 「优化首页」 ✅ 「第1步:用 Chrome 性能面板找出首屏瓶颈;第2步:对图片做懒加载;第3步:用 Lighthouse 复测首屏时间」

对评审,步骤要具体到「谁、审什么、怎么审、怎么算审完」:

❌ 「并行审一下」 ✅ 「第1步:派逻辑子 Agent,扫 src/ 业务改动,重点查边界和异常,输出三档清单;第2步:派安全子 Agent,扫输入和敏感信息,输出触发路径;第3步:派风格子 Agent,查命名格式;第4步:三路汇总并做冲突对账」

3. 涉及文件清单

明确「会碰哪些文件」,让你提前预判风险——尤其别让它动不该动的文件。

涉及文件:
- src/index.html    (加懒加载属性)
- src/assets/img/   (图片处理)
- 不动:src/api/、数据库

对评审,就是明确「审哪些文件、范围到哪里为止」:

评审范围:
- 审:src/ 下本次改动涉及的 30 个文件
- 也扫一眼:package.json 的依赖安全(旁路)
- 不审:test/ 下已有测试文件、docs/ 文档

明确「不审什么」,防止子 Agent 把无关文件也翻一遍、浪费 token。

4. 风险与回滚

写清「哪里容易出问题、出了问题怎么办」。

⚠️ 懒加载可能影响首屏图片闪动;如出问题,回滚到上一步、保留原图属性。

对评审,风险不是「改坏了回滚」,而是「审漏 / 审偏了怎么办」:

⚠️ 三路并行可能因读同一批文件导致上下文拥挤、审漏;如发现某路结论明显单薄,让该路子 Agent 单独重审该范围;如审偏(审了不该审的模块),重新限定范围再审一次。


判断一份计划好不好

拿到计划后,用三个问题审它:

  1. 我能照着做吗?每一步都具体可执行吗?
  2. 会不会碰错东西?文件清单合理吗?有没有越界?
  3. 出问题有退路吗?风险点有没有写、回滚方案有没有?

三个都通过,才放行。有一个含糊,就让它改。

对评审计划,把三个问题翻成评审语境再问一遍:

  1. 照着这个计划审,能审出可修的问题吗? 每路的范围和重点够具体吗?
  2. 会不会审错范围? 该审的审到了吗?「不审什么」写清楚了吗?
  3. 审漏了 / 审偏了有补救吗? 风险与回滚写了没?

让 Claude Code 出高质量计划

你可以直接给出「计划要求」,引导它产出规范的计划:

请按下面格式出计划,先不要动手:
【目标】……
【步骤】1… 2… 3…
【涉及文件】……
【风险与回滚】……

给它一个模板,它更容易给出可执行的计划,而不是泛泛而谈。

对评审,给一个「评审计划模板」尤其有效——它能逼 Claude 把范围、分工、验收都写清楚:

请按下面的评审计划格式出计划,先不要开审:
【评审目标】要审出哪几类问题、输出什么格式
【评审步骤】派几路子 Agent、每路审什么、重点查什么、怎么验收
【评审范围】审哪些文件 / 目录;明确不审什么
【风险与回滚】可能审漏/审偏什么、发现后怎么补救

把模板固化下来,就成了 codex-review 的「评审计划」雏形——到模块 03,我们会把这个模板做成一个技能。


落地练习

练习① 三步走:第 1 步,选一个真实分支,把「评审它」作为目标;第 2 步,用上面的「评审计划模板」让 Claude 出一份计划,要求四要素齐全(目标 / 步骤 / 范围 / 风险回滚);第 3 步,自己用三问审这份计划,挑出至少一处「太笼统」或「范围不清」,让它改到可执行。

② 怎么判断做对了:计划的每一步都有「怎么审 + 怎么验收」;范围里明确写了「不审什么」;你能照着这份计划预判「审出来大概是什么样子」,而不是两眼一黑。

③ 卡住了怎么办:如果某步还是笼统(比如「审一下逻辑」),让它「把重点拆成具体检查点(分支、边界、异常、数据一致性)」;如果范围没写清「不审什么」,直接补一句「请明确列出不审的目录和文件」。

常见坑:目标写成形容词,验收就没抓手

评审计划最常见的败笔,是把目标写成形容词——「确保代码质量」「认真审一遍」。这种目标没法验收:审完了,你凭什么说「审好了」?没有明确的、可验证的目标,你连「这次评审到底做没做完、做得好不好」都判断不了。

对策是把目标写成可勾选、可量化的验收项:明确「要审出哪几类问题、输出什么格式、每路要覆盖哪些检查点」。目标一旦落到「能对着打勾」,评审计划就真正可执行了。

做法给 codex-review 的每个评审计划都定一句「可验收的目标」,例如:「输出一份按三档分、每条含位置+问题+建议、且覆盖逻辑/安全/风格三类问题的清单」。有了它,评审做没做完、做得好不好,一目了然。

小结

  1. 好计划四要素:目标明确、步骤可执行、文件清单、风险回滚
  2. 用三问审计划:能做吗?会碰错吗?有退路吗?
  3. 给 Claude Code 一个计划模板,引导它规范输出
  4. 评审计划要写清「范围 + 不审什么 + 可验收目标」,并可固化成一个模板

下一节,看从计划到执行的完整链路——把评审计划真正落地成一次评审。