在真实场景中,我们应该让 Codex 自己根据项目情况做必要检查,并把结果讲清楚。

> 前置教程:让 Codex 完成任务验收

> 依据来源:OpenAI Codex 官方手册中关于任务执行、验证、审批、结果汇报和最小必要工作流的说明。

核心思路:最小必要检查

不是检查越多越好。

  • 只改 README -> 检查 Git 状态和 diff 即可。
  • 改接口逻辑 -> 需要相关测试或编译检查。

第 1 步:判断检查方式

让 Codex 先做只读判断:

``markdown

请先只读判断当前项目适合哪些检查方式。

要求:不要修改、只根据脚本判断、区分构建/测试/lint/类型检查、列出不确定项。

请按格式输出:项目可用检查、本次任务最小必要检查及原因。

`

第 2 步:将检查纳入任务指令

发任务时明确要求:

`markdown

请完成任务,并在完成后自行做最小必要检查。

要求:先完成任务,再选必要检查,不运行无关检查,未运行项说明原因。

如果检查失败,先分析是否由本次修改引入。

汇报格式:修改摘要、检查情况(运行了什么、结果、未运行项及原因)、结论。

`

第 3 步:如果 Codex 没主动检查

直接补一句:

`markdown

请不要只说“已完成”。请根据项目情况完成最小必要检查,并将结果用中文告诉我。

至少检查 Git 状态和 diff。

`

第 4 步:如果检查失败怎么办?

不要直接说“全部修掉”,要先分析:

`markdown

检查失败了。请先分析:哪项失败、关键错误、是否由本次修改引入。

如果是本次引入,给最小修复方案;如果不是,明确告诉我不顺便修。

`

通用提示词模板

`markdown

请完成当前任务。完成后请自行做必要检查。

要求:判断最小必要检查、不运行无关项、至少查 Git 和 diff、解释未运行原因。

如果失败,先分析原因和引入源,不要扩大修复范围。

汇报格式:修改摘要、检查情况、风险和建议。

``

建议接着看:Git 提交前检查