写重复需要的事实
AGENTS.md 适合记录仓库结构、安装与验证命令、不可触碰区域、审查标准和交付格式。一次性的产品需求仍应放在当前任务提示中。
理解发现与覆盖
Codex先读取 Codex home 中的全局指导,再从项目根沿路径走到当前目录。每一层优先检查 AGENTS.override.md,再检查 AGENTS.md;越靠近当前目录的指导出现在后面,因此能覆盖更宽泛规则。
- 空文件会被忽略。
- 每个目录最多选取一个指令文件。
- 指令链在每次新运行或 TUI 会话开始时构建。
保持短、准、可执行
删除过时命令,把专项流程放进被引用的文档或 skill。遇到重复错误时再增加规则,并把机械要求交给 lint、类型系统和测试执行。
参考来源
优先使用 OpenAI 官方文档与官方仓库。外部来源会单独标识。
- OpenAI Codex AGENTS.md
官方来源 · https://learn.chatgpt.com/docs/agent-configuration/agents-md
- OpenAI Prompting Codex
官方来源 · https://learn.chatgpt.com/docs/prompting
codex.study 是独立运营的中文 Codex 学习与资料平台,与 OpenAI 不存在隶属、授权或官方认证关系。