AGENTS.md 不生效

症状可能是「不知道项目检查命令」，也可能是「知道命令却没有运行」。前者需要检查规则是否进入上下文，后者还需要检查任务与实际行为。不要只凭一次回答，就把所有问题归为文件名错误。

先固定启动位置

在启动 Codex 的同一终端记录 pwd、git rev-parse --show-toplevel 和 codex --version。随后检查从项目根到当前目录的指令文件，尤其是同目录的 AGENTS.override.md。不要导出私人全局规则，只记录相关文件是否存在以及本方检查标记。

OpenAI 官方指令文档 说明：每层优先选 override，再选普通文件，每目录至多一份；项目规则按根目录到当前目录组合。空文件、总字节限制和自定义后备文件名也影响发现结果。本文于 2026-10-18 复核这部分依据。

复现一个真实加载问题

下载 指令加载练习 v1.0.0，解压后先读 README。需要 Node 22+、Git 与支持 codex debug prompt-input 的 CLI；在你已经信任的 Git 项目里运行：

node run.mjs

脚本在该项目的 artifacts/ 新建实验目录，写入独有标记，依次调用 CLI 自己的上下文调试接口。它不改原项目规则、不调用模型。本站在 macOS、Node v22.23.3、CLI 0.163.0 得到的 原始记录 为：

实验条件	普通标记进入上下文	override 标记进入上下文
文件名是 AGENTS.txt	false	false
只改名为 AGENTS.md	true	false
同目录新增 AGENTS.override.md	false	true

第一组证明本次默认发现规则没有加载这个 .txt 文件；第二组将变化限定为文件名；第三组解释了「普通文件写对了却没出现」的一种具体原因。结果不能扩大为所有版本、客户端的保证。

根据观察处理

区分性检查	对应处理	复测信号
文件根本未被发现	改正文件名、确认非空和启动目录	独有标记出现在新上下文
同目录 override 被选中	核对它是否仍有用途，协调后调整规则	新上下文包含预期来源
只有后半段规则缺失	按官方字节限制检查，删去重复说明	关键规则完整出现
规则已经加载，检查仍未执行	将检查命令写入具体任务验收并核对结果	有真实退出码、输出和 diff

每次只改一个条件，再开启新调用复测。保留改名前后的目录结构与版本，确认比较的是同一个项目。不要通过删掉所有层级规则来制造看似干净的结果，也不要把文件里的文字加强为「必须必须」当成诊断。

加载检查的边界

本练习只证明 CLI 将哪些文字放进上下文，不能证明模型在任务中必然遵循。执行层应选一个小任务，要求报告准确命令，并由维护者核对实际检查与 diff；没有运行就如实写未运行。IDE、App 与其他版本需记录各自启动方式，不能套用本次布尔值。

需要重新组织规则时读 第 6 课，需要一份短文件时用 起步模板。仍有差异则填写 问题报告，附上脱敏的最小目录结构与复测结果。