展开知识库目录
AI 说完成了？用测试、命令和真实页面证明
验收 AI 的结果不能只听它说“完成了”。要求它给出测试退出码、构建结果、改动 diff 和真实页面状态，你自己再操作一遍关键流程，两项都对才算完成。
要求测试、构建和 diff 作为证据
让 AI 改完代码，它回一句“已完成”，你信不信？我的建议是：礼貌地信，然后自己验。终端工具很容易在“代码看起来对了”时就收工，而验收这件事，只有命令输出和 diff 能证明。
把验收写进任务要求，让 AI 交付四样东西：改动清单、命令退出码和输出、diff、手动验证路径。你再亲自跑一遍，四样都对，才算真的完成。
这些情况适合用，另外几种先停一下
适合用
- AI 完成了代码改动，需要验收
- 改动涉及构建、测试或页面展示
- 任务要交付给他人或合并到主干
先别急着用
- 纯文档或文案改动，不需要跑构建测试
- 你还没权限运行项目，先解决环境
用测试退出码、diff 和真实页面状态四件套验收，不只听“已完成”
为什么这样安排
Codex 官方工作流强调在项目里运行测试验证结果；这里把官方建议变成任务里的验收清单，AI 的“完成”才有凭证。
- 01
验收要求写进任务
任务开头就写明：交付时给出改动清单、命令退出码、diff 和手动验证路径。
- 02
跑命令并贴输出
让 AI 运行构建和测试，粘贴完整输出与退出码，失败就继续修，不标记完成。
- 03
diff 逐行审查
用 git diff 核对每个文件，确认范围正确、无生成产物、无他人未提交改动被覆盖。
- 04
你亲手复验
自己再跑一遍关键命令或操作关键页面，记录实际结果，与 AI 的输出互相印证。
复制前先替换 {占位}
AI 改动验收提示词（复制后改 {占位}）
你刚完成了任务{任务名}。请按下面的验收清单交付，不要只说“完成了”：
1. 列出你改动和新增的所有文件；
2. 运行构建命令{构建命令}和测试命令{测试命令}，粘贴完整输出和退出码；
3. 给出 git diff（如果改动大就按文件给摘要+关键片段）；
4. 说明如何手动验证：打开哪个页面/调哪个接口，预期看到什么；
5. 如果任何命令失败，不要标记完成，先修复或说明原因。验收记录（示例）
下面是已经填过变量的示例。复制时请换成自己的文件名、数字和材料位置，别把示例数据原样交出去。
看清格式再改
验收记录（示例）
任务：设置页补空状态 改动文件：src/pages/settings/（仅此一个目录） 测试：npm test → 32 passed, 0 failed 构建：npm run build → exit 0 diff：无多余文件，无生成产物 手动验证：360px 与 1440px 下无溢出，按钮可点击
先对症状，别一上来重写整段提示词
它说完成但构建是红的
- 常见原因
- 没把运行结果当验收项
- 怎么修
- 要求粘贴退出码和输出，非 0 就不算完成。
改了三个文件，任务只需要一个
- 常见原因
- 没在任务里限制范围
- 怎么修
- 任务里写明“只改 X”，验收时用 git diff 核对。
页面显示正常但功能是坏的
- 常见原因
- 只看了表面没操作流程
- 怎么修
- 验收清单加一步：你亲自操作关键路径，记录实际结果。
最后五分钟，逐项打勾
这篇具体参考了什么
正文按公开教程和官方文档重新整理，并换成了可以直接操作的中文场景。产品能力、规则和投稿要求会更新，真正执行前请再打开原始页面核对一次。