第 02 模块 · 1 节

计划模式的机制与价值

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

为什么说「想清楚再动手」

程序员最怕的不是代码难写,而是方向错了——埋头写了一大堆,发现根本不是要的东西,全部返工。

AI 也一样。让它上来就改,它可能兴冲冲改了半天,结果和你想要的不一样。计划模式就是治这个的:动手之前,先让它出一份计划,你确认了再让它动。

在 codex-review 里,「想清楚再动手」体现在一个具体的地方:评审开始之前,先规划好「这场评审怎么审」——审哪些文件、派几路子 Agent、每路重点查什么、结论怎么汇总。没规划就开审,容易审漏、审乱、审到一半才发现方向错了。

贯穿项目codex-review 的每个评审任务,都用计划模式先走一遍「规划评审流程」:先让 Claude 出一份评审计划(审谁、怎么审、谁来审、怎么验收),你确认了再真正开审。这一节理解计划模式的机制,是 M02 用它规划评审流程的地基。

计划模式是什么

计划模式让 Claude Code 只规划、不执行。它先分析现状,产出一份「做什么、按什么顺序、涉及哪些文件、有什么风险」的计划,停下来等你的确认。

  • 规划阶段:它只读、只分析、只写计划,不动你的文件
  • 确认阶段:你审计划,改顺序、删步骤、提风险
  • 执行阶段:你确认后,它才真正动手

这样把「决策」和「执行」分开了,决策权在你手里。

对评审场景,「只规划、不执行」有一个额外的价值:评审本身是只读的,但你仍希望先让 Claude 说清「我打算审哪些文件、重点审什么」,而不是它一上来就闷头把整个仓库翻一遍。 计划模式让「审什么」先和你对齐。


它带来的三个好处

好处 说明
少返工 方向先对齐,不会写完才发现不对
更可控 你能提前看到它会碰哪些文件
更安全 计划阶段不碰文件,风险前置暴露

这三个好处套到 codex-review 的评审规划上:

  • 少返工:先对齐「审哪些、重点查什么」,不会审到一半发现「你根本想审的是另一个模块」。
  • 更可控:评审计划里会列出「要读哪些文件、派几路子 Agent」,你能提前看到范围,砍掉不该审的。
  • 更安全:评审虽然只读,但会消耗大量 token 和时间。先在计划里确认范围,就不会让三路子 Agent 白读一堆无关文件。

什么时候用计划模式

不是每次都要。什么时候值得用:

  • 改动大:涉及多文件、多模块的重构
  • 方向不明确:你还不完全清楚该怎么做
  • 有风险:改数据库、改核心逻辑、动生产
  • 新功能:从零实现一个有规模的东西

小改动、方向明确、低风险 → 直接做,别走计划模式,反而快。

对评审,一个可用的判断:

  • 改动大 / 跨模块 / 想让评审更可控 → 先出评审计划,确认「审什么」再开审。
  • 小改动 / 你心里很清楚要看哪几个文件 → 直接审,别为评审再套一层规划。
判断标准要不要用计划模式,就看「试错成本高不高」。评审大规模改动的试错成本(token、时间、审漏的风险)高,值得先规划;小改动的试错成本低,直接做。

进入计划模式

在 Claude Code 里,通常通过指令让它在「规划模式」下工作,或者直接要求它「先给计划,不要动手」:

先别改代码。帮我把「给项目加 CI 检查」这件事做个计划:
要做哪些事、按什么顺序、会碰哪些文件、有什么风险。
列出计划就行,等我确认再动手。

它会产出一份计划,然后停下来等你的指令——这就是「先想清楚」。

对 codex-review,你在每次开审前可以这样让它出「评审计划」:

先别开审。帮我把「评审 src/ 这次 30 个文件的改动」出一个评审计划:
准备派几路子 Agent(逻辑 / 安全 / 风格)?每路审哪些文件、重点查什么?
结论怎么汇总、怎么验收?
列出计划就行,等我确认再开审。

关键一步:确认计划后再开审。计划阶段它只读、只分析,你确认后它才真正派子 Agent 动起来。

一份评审计划的实际产出,长这样:

评审计划:src/ 本次 30 个文件改动
【目标】审出逻辑/安全/风格三类问题,输出按三档分的可修清单
【步骤】
  1. 派逻辑子 Agent:扫 src/ 业务改动,查边界/异常/一致性,输出三档
  2. 派安全子 Agent:扫输入/敏感信息,给触发路径,输出三档
  3. 派风格子 Agent:查命名/格式/重复代码,输出三档
  4. 三路汇总,做冲突对账
【范围】审 src/ 本次改动;不审 test/、docs/
【风险】三路共读文件可能拥挤导致审漏;如某路结论薄,单独重审该范围

这份计划覆盖了「审什么、谁审、怎么审、怎么验收」,你确认后再开审,就是「先想清楚」。


计划模式与子 Agent 的关系

上一模块你学了子 Agent,这里自然有个疑问:先计划,再并行派子 Agent,会不会冲突? 不会,顺序反而是绝配:

  1. 计划阶段:主会话只读、只分析,产出「评审计划」——这本身不派子 Agent。
  2. 执行阶段:你确认后,主会话才按计划把任务派给多个子 Agent 并行。

也就是说,计划管「怎么干」,子 Agent 管「谁来干」。 先想清楚怎么干,再决定派谁去干。codex-review 的完整链路正是如此:先出计划,确认后派三路子 Agent 并行审。


落地练习

练习① 三步走:第 1 步,挑一个改动较大的分支,假装你要评审它;第 2 步,用「先别开审,给我一份评审计划」让 Claude 出一份计划,明确「审哪些文件、派几路、每路重点、怎么汇总验收」;第 3 步,自己审这份计划——砍掉不需要审的文件、调整每路重点,再让 Claude 按修订后的计划重出。

② 怎么判断做对了:计划里能清楚说出「范围、分工、验收方式」,而不是笼统的「我准备认真审一遍」;你能直接指出「这个不用审、这个重点要加」,计划可被你对齐和修订。

③ 卡住了怎么办:如果 Claude 直接开始读文件/出结论而不是给计划,就说「现在只是规划阶段,先不要读文件、不要给结论,只出计划」;如果计划太笼统,让它「把每个子 Agent 的范围和验收标准都写出来」。

常见坑:把「规划评审」和「直接开审」混在一起

很多人明明说了「先给我一份评审计划」,结果 Claude 还是顺手读文件、顺便给了一堆初步结论。这就是没让计划模式真正生效——计划阶段一读文件、一出结论,范围就悄悄定死了,你想改也来不及,计划模式的意义就没了。

计划模式的纪律是:规划阶段只允许「读范围、出计划」,不允许「深入分析、下结论」。 一旦发现它越界,就叫停,让它回到「只规划」。

做法在 codex-review 里把「出计划」和「开审」分成两次明确的指令,中间隔着你的一次确认。看到 Claude 在规划阶段就开始逐行审代码,就说「现在只出计划,先别深入分析单个文件」。

小结

  1. 计划模式 = 动手前先规划,只读不改
  2. 好处:少返工、更可控、更安全
  3. 大改动/方向不明/有风险时用
  4. 小改动直接做,别走计划
  5. 计划管「怎么干」,子 Agent 管「谁来干」,先计划再并行

下一节,学怎么写一份高质量的执行计划——用它把 codex-review 的评审流程规划清楚。