为什么说「想清楚再动手」
程序员最怕的不是代码难写,而是方向错了——埋头写了一大堆,发现根本不是要的东西,全部返工。
AI 也一样。让它上来就改,它可能兴冲冲改了半天,结果和你想要的不一样。计划模式就是治这个的:动手之前,先让它出一份计划,你确认了再让它动。
在 codex-review 里,「想清楚再动手」体现在一个具体的地方:评审开始之前,先规划好「这场评审怎么审」——审哪些文件、派几路子 Agent、每路重点查什么、结论怎么汇总。没规划就开审,容易审漏、审乱、审到一半才发现方向错了。
计划模式是什么
计划模式让 Claude Code 只规划、不执行。它先分析现状,产出一份「做什么、按什么顺序、涉及哪些文件、有什么风险」的计划,停下来等你的确认。
- 规划阶段:它只读、只分析、只写计划,不动你的文件
- 确认阶段:你审计划,改顺序、删步骤、提风险
- 执行阶段:你确认后,它才真正动手
这样把「决策」和「执行」分开了,决策权在你手里。
对评审场景,「只规划、不执行」有一个额外的价值:评审本身是只读的,但你仍希望先让 Claude 说清「我打算审哪些文件、重点审什么」,而不是它一上来就闷头把整个仓库翻一遍。 计划模式让「审什么」先和你对齐。
它带来的三个好处
| 好处 | 说明 |
|---|---|
| 少返工 | 方向先对齐,不会写完才发现不对 |
| 更可控 | 你能提前看到它会碰哪些文件 |
| 更安全 | 计划阶段不碰文件,风险前置暴露 |
这三个好处套到 codex-review 的评审规划上:
- 少返工:先对齐「审哪些、重点查什么」,不会审到一半发现「你根本想审的是另一个模块」。
- 更可控:评审计划里会列出「要读哪些文件、派几路子 Agent」,你能提前看到范围,砍掉不该审的。
- 更安全:评审虽然只读,但会消耗大量 token 和时间。先在计划里确认范围,就不会让三路子 Agent 白读一堆无关文件。
什么时候用计划模式
不是每次都要。什么时候值得用:
- 改动大:涉及多文件、多模块的重构
- 方向不明确:你还不完全清楚该怎么做
- 有风险:改数据库、改核心逻辑、动生产
- 新功能:从零实现一个有规模的东西
小改动、方向明确、低风险 → 直接做,别走计划模式,反而快。
对评审,一个可用的判断:
- 改动大 / 跨模块 / 想让评审更可控 → 先出评审计划,确认「审什么」再开审。
- 小改动 / 你心里很清楚要看哪几个文件 → 直接审,别为评审再套一层规划。
进入计划模式
在 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,会不会冲突? 不会,顺序反而是绝配:
- 计划阶段:主会话只读、只分析,产出「评审计划」——这本身不派子 Agent。
- 执行阶段:你确认后,主会话才按计划把任务派给多个子 Agent 并行。
也就是说,计划管「怎么干」,子 Agent 管「谁来干」。 先想清楚怎么干,再决定派谁去干。codex-review 的完整链路正是如此:先出计划,确认后派三路子 Agent 并行审。
落地练习
② 怎么判断做对了:计划里能清楚说出「范围、分工、验收方式」,而不是笼统的「我准备认真审一遍」;你能直接指出「这个不用审、这个重点要加」,计划可被你对齐和修订。
③ 卡住了怎么办:如果 Claude 直接开始读文件/出结论而不是给计划,就说「现在只是规划阶段,先不要读文件、不要给结论,只出计划」;如果计划太笼统,让它「把每个子 Agent 的范围和验收标准都写出来」。
常见坑:把「规划评审」和「直接开审」混在一起
很多人明明说了「先给我一份评审计划」,结果 Claude 还是顺手读文件、顺便给了一堆初步结论。这就是没让计划模式真正生效——计划阶段一读文件、一出结论,范围就悄悄定死了,你想改也来不及,计划模式的意义就没了。
计划模式的纪律是:规划阶段只允许「读范围、出计划」,不允许「深入分析、下结论」。 一旦发现它越界,就叫停,让它回到「只规划」。
小结
- 计划模式 = 动手前先规划,只读不改
- 好处:少返工、更可控、更安全
- 大改动/方向不明/有风险时用
- 小改动直接做,别走计划
- 计划管「怎么干」,子 Agent 管「谁来干」,先计划再并行
下一节,学怎么写一份高质量的执行计划——用它把 codex-review 的评审流程规划清楚。