verification_loop与completeness_contract如何防止Codex半途而废的完整指南【免费下载链接】codex-plugin-ccUse Codex from Claude Code to review code or delegate tasks.项目地址: https://gitcode.com/GitHub_Trending/co/codex-plugin-cccodex-plugin-cc 是一个让 Claude Code 直接调用 Codex 进行代码审查和任务委托的插件。很多新手把任务交给 Codex 后常会遭遇半途而废只定位了 bug 却没动手修或者只给出一个看似合理的猜测、从未验证就交差。本文带你认识两个关键的提示词约束块——verification_loop与completeness_contract教你用极少的配置让 Codex 有始有终并附可直接套用的提示词配方。一、为什么 Codex 会半途而废把任务委托给 Codex 时最常见的两种翻车场景症状具体表现 停在第一个看似正确的答案只识别出问题就停下没有应用修复没有处理边界情况 直接提交初稿没有对照任务要求和实际改动文件做校验答案看起来对实际没验证项目内的提示词技能文件里有一条核心规则说得很直白Tell Codex what done looks like. Do not assume it will infer the desired end state.告诉 Codex 什么才算完成别假设它会自己推断出你想要的终点— 见 SKILL.md。好消息是你不需要写一大段自然语言去劝它做完只需要在提示词里加入两个结构化的约束块。二、completeness_contract把做完写进合同completeness_contract完整性合同的原始定义在 prompt-blocks.mdcompleteness_contract Resolve the task fully before stopping. Do not stop at the first plausible answer. Check whether there are follow-on fixes, edge cases, or cleanup needed for a correct result. /completeness_contract通俗理解它就是给 Codex 立的三条验收标准解决完整才能停—— 不是有思路就行必须是问题闭环别停在第一个合理答案上—— 直接针对半途而废这一病根主动检查后续工作—— 追问有没有连带修复、边界情况、需要清理的东西。按官方技能文档的建议调试、实现类任务或多步骤任务都应该加上这个块并搭配missing_context_gating防止 Codex 凭空猜测SKILL.mdCoding or debugging: addcompleteness_contract,verification_loop, andmissing_context_gating.三、verification_loop提交前的质检环节verification_loop验证循环的定义同样在 prompt-blocks.mdverification_loop Before finalizing, verify the result against the task requirements and the changed files or tool outputs. If a check fails, revise the answer instead of reporting the first draft. /verification_loop它相当于给 Codex 加了一道出厂前的质检先验证再定稿—— 对照任务要求和实际改动的文件 / 工具输出逐项核对✏️检查不通过就返工—— 而不是把第一稿直接报给你。两者分工非常清晰completeness_contract 管做没做完verification_loop 管做得对不对。一个保证闭环一个保证质量正好是防止 Codex 半途而废的组合拳。四、配方速查三种任务场景直接套用项目把这两个块封装成了可直接复制的完整提示词模板存放在 codex-prompt-recipes.md核心差异如下场景关键约束效果 最小修复Narrow FixDo not stop after identifying the issue without applying the fix只找到问题不修就不算完防止诊断完就跑 故障诊断Diagnosisverify that the proposed root cause matches the observed evidence根因必须与证据吻合防止拍脑袋定根因 根因审查Root-Cause Reviewverify that each finding is material and actionable每条发现必须真实且可行动防止凑数式报告例如最小修复配方中两个块是这样搭配使用的codex-prompt-recipes.mdcompleteness_contract Resolve the task fully before stopping. Do not stop after identifying the issue without applying the fix. /completeness_contract verification_loop Before finalizing, verify that the fix matches the task requirements and that the changed code is coherent. /verification_loop可以看到官方做法是在通用模板基础上用一句任务相关的话把约束钉死而不是笼统地说请做完再停。五、反模式别用想得更聪明点代替约束新手最容易犯的错误是用模糊的激励代替明确的合同。项目的反模式清单 codex-prompt-antipatterns.md 给出了典型对照❌ 坏写法Think harder and be very smart.再努力想要非常聪明✅ 好写法加上一个verification_loop块要求答案与观察到的证据、任务要求相符同样的道理也适用于没有后续默认策略——只说Debug this failure而不告诉它证据不足时怎么办Codex 很可能查一半就停下来向你提问。正确的姿势是补上default_follow_through_policy块明确默认按最合理的低风险解释继续干只有影响正确性的细节缺失才停下来问codex-prompt-antipatterns.md。六、自动化场景codex-rescue 会帮你组装这些块如果你通过/codex:rescue把任务委托出去其实不需要手动写这些块。插件的codex-rescue子代理加载了gpt-5-4-prompting技能codex-rescue.md在转发任务前会按规则把请求收紧成带约束的提示词诊断 / 实现类任务 → 自动补上completeness_contract、verification_loop等块审查类任务 → 改用grounding_rules每个论断都要有证据加dig_deeper_nudge找完第一个问题继续挖第二层问题研究类任务 → 改用research_mode加citation_rules。也就是说手动委托任务时参考配方自己加块走/codex:rescue时由技能自动补全——两种路径最终都落到同一套约束体系上。七、新手快速上手清单 明确完成的定义在task里写清期望的终点状态别指望模型自己脑补实现/调试任务必加completeness_contractverification_loop两个块审查/研究任务用grounding_rules替代确保论断有证据、假设要标注能加约束就别加废话优先收紧提示词合同而不是把推理等级调高或写长篇解释SKILL.md一次只跑一件事审查、修复、写文档拆成独立任务混合任务最容易导致中途分心丢目标。结语防止 Codex 半途而废的本质不是催它而是把验收标准前置completeness_contract划定什么才算做完verification_loop保证交出来的东西经得起核验。这两个块都只有两三行却能显著减少做一半交差和初稿即终稿两类返工。建议先把 codex-prompt-recipes.md 里的四个配方收藏起来下次委托任务时按需取用即可。【免费下载链接】codex-plugin-ccUse Codex from Claude Code to review code or delegate tasks.项目地址: https://gitcode.com/GitHub_Trending/co/codex-plugin-cc创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考