← 返回系统教程
系统教程提示与协作App / CLI / IDE / Cloud入门

给 Codex 写任务契约:目标、范围、约束与验收

把模糊需求改写成可执行任务契约,让 Codex知道先读什么、只改什么、如何证明完成。

30 分钟阅读核验于 2026/07/16

四块必要信息

高质量任务通常包含背景与目标、相关文件或入口、明确约束、可观察验收。Codex能够自己探索仓库,但任务越含糊,探索成本和误改风险越高。

  • 背景:用户遇到什么问题。
  • 范围:允许修改的模块与必须保持不变的契约。
  • 验证:具体命令和手工行为。
  • 报告:要求区分已验证、未验证和推断。

复杂任务分阶段

先让 Codex调查和提出计划,再实施最小改动,最后单独审阅与测试。阶段之间保留一个可以停止或修正方向的检查点。

阶段 1 只调查:找出数据流、权限检查和现有测试,不编辑文件。阶段 2 在我确认后实施。阶段 3 运行指定检查并按证据报告。

避免用提示替代工程约束

提示负责表达意图,类型、测试、权限检查和 CI 才负责机械执行。把重复出现的仓库规则沉淀到 AGENTS.md,把可自动检查的要求交给工具。

参考来源

优先使用 OpenAI 官方文档与官方仓库。外部来源会单独标识。

  1. OpenAI Prompting Codex

    官方来源 · https://learn.chatgpt.com/docs/prompting

  2. OpenAI Codex AGENTS.md

    官方来源 · https://learn.chatgpt.com/docs/agent-configuration/agents-md

codex.study 是独立运营的中文 Codex 学习与资料平台,与 OpenAI 不存在隶属、授权或官方认证关系。