agentmentoragentmentor

第 03 节:看懂 plan 和 status

本节 objectives:

  • 能区分 plan、status、命令输出和最终总结。
  • 能在计划不合理时及时打断 Codex。
  • 能要求 Codex 用短状态更新保持你在回路里。

先修:会让 Codex 先读项目并返回证据 | 上一节 << 02 | 下一节 04 >>

计划不是礼貌,是你审方向的窗口

Codex 常会先说明计划,再做编辑或运行命令。CLI 官方文档把"看 Codex 解释计划并内联批准或拒绝步骤"列为交互会话里的核心动作之一。1 这不是形式感:计划是你在代价还低时纠偏的地方。

status 也一样。长任务里,你不需要每秒盯着屏幕,但你要能看懂 Codex 正在读文件、改代码、跑测试、还是卡在权限/网络上。界面和措辞可能变,所以本课不记按钮名;你要练的是判断信号。

讲解

把 Codex 输出分成四类:

输出说明你该看什么
Plan接下来要做的步骤是否先读再改、是否越界、是否有验证
Status当前正在做什么是否卡住、是否需要你批准或补信息
Command output工具或测试结果失败原因是不是被正确理解
Final summary完成后报告改了什么、跑了什么、还有什么风险

好计划通常有 3-5 步,每步能被执行。坏计划有两个信号:第一步就大改;最后没有验证。你可以直接打断:

text
先停。这个计划范围太大。请只定位原因,不要改代码;读完后给我两个可选修复点。

对长任务,你可以在任务开头加一句:

text
每完成一个阶段给我一句 status: 读到了什么、下一步做什么、是否需要我决定。

跟我做一遍(worked example)

你给 Codex 的任务:

text
修复搜索框在移动端溢出。只改搜索组件和相关 CSS;跑现有测试;最后列 diff 摘要。

Codex 的计划:

text
1. 扫描所有移动端样式。2. 重构全局布局。3. 顺手统一按钮圆角。4. 运行测试。

你应该打断:

text
先停。请把计划收窄到搜索框问题:1. 定位搜索组件和它的容器样式。2. 复现或截图确认溢出条件。3. 做最小 CSS/组件改动。4. 跑相关测试或至少做桌面/移动截图。不要统一按钮圆角,不要重构全局布局。

你不是在微管理 Codex,你是在保护任务边界。计划阶段改一句话,比 diff 阶段退一大片轻得多。

换你补全(faded example)

Codex 的 status 显示它准备安装一个新依赖来修复一个小样式问题。请补全你的回复:

text
先停。这个任务的安全边界是 ____________________。请改成无新依赖方案:先 ____________________,再 ____________________,最后 ____________________。

参考答案:

text
先停。这个任务的安全边界是不新增生产依赖。请改成无新依赖方案:先确认现有 CSS/组件能力,再做最小样式改动,最后用截图或现有测试验证。

关键判断点是把"我不喜欢这个方向"说成可执行边界。

小结 + 通向下一节

Plan 是方向审查,status 是过程信号。你不需要知道 Codex 内部怎么想,但要会在计划越界、状态卡住、验证缺失时插一句清楚的话。

下一节进入 diff:Codex 改了文件后,你怎么审、怎么给行级反馈。

Footnotes

  1. Codex CLI features — https://developers.openai.com/codex/cli/features

练习

Level 1: 找一个小任务,让 Codex 先只给计划。

提示 1

计划看顺序。

提示 2

status 看阻塞。

提示 3

最终总结看证据。

自评