记清 AGENTS.md 的发现顺序
全局一份,再从 Git 根走到 cwd。每一层优先 override,后出现的更具体规则覆盖前面的。
每次启动(TUI 通常是每个会话一次)重建指令链:
- 全局:
$CODEX_HOME/AGENTS.override.md,否则AGENTS.md。这一层只取第一份非空文件。 - 项目:从项目根(通常是 Git 根)走到当前目录。每一层按
AGENTS.override.md→AGENTS.md→ fallback 文件名查找,每层最多一份。 - 合并:从根拼到 cwd,靠近当前目录的文件更靠后,因此覆盖更通用的规则。
空文件会被跳过。合并大小达到 project_doc_max_bytes(默认 32 KiB)就停止追加。
验证:
codex --ask-for-approval never "列出你加载的指令来源,并按优先级复述规则。"
改完文件要新开会话。运行中的会话不会持续重扫。