Coding Agent 跑偏了怎么办:用 diff 把它拉回任务
Coding agent 跑偏时,不要继续补需求。先停、看 diff、回到任务卡。
你让它“改首页按钮文案”,它却开始:
- 重构整个页面。
- 新增设计系统。
- 修改多个无关文件。
- 顺手改导航、样式、依赖。
- 没有运行验证,只说“完成了”。
这时不要继续推进。
第一句:停止
Section titled “第一句:停止”先停。不要继续修改文件,也不要运行新的命令。第二句:对照原始任务和 diff
Section titled “第二句:对照原始任务和 diff”请对照我的原始任务和当前 diff,列出:1. 哪些改动是必要的2. 哪些改动可疑3. 哪些改动应该撤回4. 哪些文件和原始任务无关
不要继续修改。如果 agent 没有主动看 diff,补一句:
请先查看当前 git diff,再回答。不要基于记忆猜测。第三句:回到最小交付
Section titled “第三句:回到最小交付”请回到原始任务,只保留今天能交付的最小版本。
约束:1. 最多改 1-3 个文件2. 不重构3. 不新增生产依赖4. 不处理无关问题5. 改完必须给验证方式如果已经改了很多
Section titled “如果已经改了很多”先让它做撤回方案,而不是继续修:
请给撤回方案,不要直接执行。
输出:1. 建议保留的文件2. 建议撤回的文件3. 撤回后如何重新做最小版本4. 撤回和重做的风险如果你看不懂 diff:
请用新手能懂的话解释当前 diff。按文件分组,每个文件只说:为什么改、是否必要、如何验证。- agent 不再继续乱改。
- 它能指出哪些改动和任务无关。
- 改动范围回到 1-3 个文件。
- 它给出明确验证方法。
- 你能根据 diff 判断是否继续。
下次如何预防
Section titled “下次如何预防”在任务开始前加这两句:
改代码前必须先列出会修改的文件,等我确认后再改。改完后必须基于 git diff 做自检,找无关改动和回归风险。- 来源:Codex Best Practices、Codex CLI Slash Commands、Claude Code Common Workflows、Claude Code Best Practices。
- 分享日期:2026-06-16。
- 复测日期:2026-06-16。