进阶教程 · 任务纠偏

Codex 走偏后怎样纠正方向并保住已有成果

先停止扩大错误范围,再说明错误假设、保留内容和新验收条件,让任务从可靠状态继续。

发现 Codex 走偏时,先阻止它继续扩大改动。随后保存当前状态,指出哪条理解有误,也要说明已经完成且应保留的部分。纠偏消息越具体,越容易沿用有价值的工作。

本文内容核对到 2026 年 8 月。桌面端的跟进消息、Goal mode 和分叉入口可能调整,使用前请查看当前设置和斜杠命令列表。

Codex 走偏后怎样纠正方向并保住已有成果的入口、目标与准备条件操作示意图
图 1 · 进入任务前先确认目标、范围和准备条件

先判断要立即纠正还是等本轮结束

Codex 工作时发送的新消息,可以加入当前执行,也可以排到下一轮。桌面端的默认行为由跟进消息设置决定。路径选错、准备删除文件或正在修改无关模块,需要立即纠正。补一份后续文档或增加低优先级检查,可以放进队列。

Goal mode 可暂停或编辑目标。任务已经碰到高风险边界时先暂停,再查看文件和操作记录。不要一边让旧方向继续执行,一边发送相反的新要求。

保存能够证明现状的证据

Git 项目查看当前分支、未提交改动和最近提交。审查面板会显示仓库里的全部变化,其中可能包含任务开始前已有的内容。先区分来源,再决定哪些改动保留。

运行到一半的测试或构建也要保存结果。失败命令能说明偏差发生在哪个阶段。若已经生成可用页面或文档,记录路径并暂时停止进一步润色,避免后续纠正把它一起覆盖。

Codex 走偏后怎样纠正方向并保住已有成果的三步关键操作与请求骨架示意图
图 2 · 把关键操作拆成三步,并给每一步留下可观察结果

不要用整批撤回清理现场

工作区里可能同时存在你的改动和 Codex 的改动。发现方向错误后,先按文件和差异块确认来源。整批重置会把任务开始前的内容一起抹掉,删除未跟踪文件也可能伤到尚未提交的素材。

让 Codex 列出建议保留、需要修正和来源未知的改动。来源未知的部分先不动。确定撤回目标以后,只处理对应文件或差异块,并再次查看 Git 状态。

纠偏消息要改正一个具体假设

下面是一条使用中性占位项目名的示例纠偏消息。

当前任务应修改 project-a,你刚才检查的是 project-b。请停止继续修改 project-b。保留已经整理的排查清单,切回指定项目后先做只读路径检查,得到我确认再改文件。

这段话指出了错误项目,也保留了可复用结果。若错误来自视觉理解,可以补上标注截图。若遗漏了业务约束,把真实数据字段或现有行为一起提供。

分叉与新聊天各有用途

旧聊天里已经积累大量有效上下文,只需更正一项约束时,留在原聊天继续最省事。新目标会产生独立结果,或需要完全不同的文件权限时,另开聊天更清楚。当前环境提供 /fork 时,也可以从已有历史复制一个分支方向,原聊天保持不动。

涉及代码写入时,新方向仍要使用正确工作区和分支。两个方向都需要继续修改仓库,就给它们独立 worktree,避免互相覆盖。

继续前重新声明验收条件

纠偏完成后,让 Codex 复述当前项目、允许修改的文件和验证方法。先检查它理解的路径,再恢复写入。任务结束时,对比最初目标和纠偏后的目标,确认保留内容仍然有效。

Codex 走偏后怎样纠正方向并保住已有成果的结果验收与交付证据清单示意图
图 3 · 用结果、检查与交付证据确认任务真的完成

官方参考