← 返回系统教程
系统教程项目指令App / CLI / IDE / Cloud入门

用 AGENTS.md 给 Codex 持久化仓库规则

把构建命令、范围限制、目录约定和验收要求放进可分层的 AGENTS.md,让每次任务从一致上下文开始。

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

写重复需要的事实

AGENTS.md 适合记录仓库结构、安装与验证命令、不可触碰区域、审查标准和交付格式。一次性的产品需求仍应放在当前任务提示中。

理解发现与覆盖

Codex先读取 Codex home 中的全局指导,再从项目根沿路径走到当前目录。每一层优先检查 AGENTS.override.md,再检查 AGENTS.md;越靠近当前目录的指导出现在后面,因此能覆盖更宽泛规则。

  • 空文件会被忽略。
  • 每个目录最多选取一个指令文件。
  • 指令链在每次新运行或 TUI 会话开始时构建。

保持短、准、可执行

删除过时命令,把专项流程放进被引用的文档或 skill。遇到重复错误时再增加规则,并把机械要求交给 lint、类型系统和测试执行。

参考来源

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

  1. OpenAI Codex AGENTS.md

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

  2. OpenAI Prompting Codex

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

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