要让codex稳定交付可运行的应用,必须拆分为准备→实现→验证→交付四个边界清晰、每步可验证的阶段,各阶段配硬性验收标准,缺一则卡在plan阶段;用done when句式、checklist.md或agents.md固化规则。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要让Codex稳定交付可运行的应用,必须把开发过程拆成边界清晰、每步可验证的阶段,每个阶段都配具体验收目标,不能只说“做完一个登录功能”。
明确划分四个核心阶段
Codex不接受模糊的“开发应用”指令,它需要你把整个流程切成四段:准备→实现→验证→交付。这四段对应Codex内部的Prompt→Plan→Execute→Verify闭环,跳过任一段都会导致它擅自扩范围或跳过检查。
准备阶段:只读取必要文件、确认权限、建立Git检查点;【不运行任何命令、不修改任何代码】
实现阶段:按任务契约写代码、补测试、改配置,仅限AGENTS.md声明的目录;
验证阶段:必须执行指定命令(如npm test或pytest tests/auth),输出必须含PASS或具体失败行号;
交付阶段:生成diff摘要、列出所有改动文件、标注风险项(如是否动了.env)。
为每个阶段设定不可绕过的验收标准
验收标准不是建议,是Codex启动执行前必须看到的硬性条件。缺一条,它会卡在Plan阶段反复追问,而不是强行推进。
方法一:用Done when句式写在Prompt最开头
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像,然后保存
Done when: 1. src/auth/login.py新增validate_email函数;2. tests/auth/test_login.py新增test_valid_email_returns_true测试用例并运行通过;3. diff中不出现对src/api/或.env的修改;4. 输出包含“✅ All tests passed”字样。
方法二:在项目根目录放CHECKLIST.md,Codex会自动读取
内容示例: - [ ] 必须调用git status确认无未提交变更 - [ ] 所有新函数需有Google风格docstring - [ ] 修改后必须运行make fmt && make lint - [ ] 交付前生成./evidence/verify_log.txt记录命令输出
【CHECKLIST.md若缺失或格式错误(如用中文顿号代替英文逗号),Codex将拒绝执行】
用AGENTS.md固化长期验收规则
重复性验收要求别每次写进Prompt,直接写进项目根目录的AGENTS.md里,Codex启动时自动加载。
第一步:在项目根目录新建AGENTS.md文件
第二步:粘贴以下结构化内容(注意缩进和空行):
```markdown ## 验收规则 - 所有前端改动必须触发npm run build且无error - src/core/目录下的文件禁止新增import语句 - 每个新增函数必须有对应单元测试,覆盖率不低于85% - 修改config.py后必须运行python -m pytest tests/config/ ```
第三步:保存后,在Codex中新建任务时,它会主动引用这些规则,并在Plan阶段输出“已加载AGENTS.md中的3条验收规则”。
第四步:执行过程中,Codex每完成一个动作都会对照AGENTS.md检查——比如它想往src/core/utils.py加一行import,就会被规则拦截并提示“违反AGENTS.md第2条:src/core/目录禁止新增import语句”。










