指令链默认只有 32 KiB

超限会静默截断。调大 project_doc_max_bytes,或把大段说明拆到更靠近 cwd 的文件。

# ~/.codex/config.toml
project_doc_max_bytes = 65536
project_doc_fallback_filenames = ["TEAM_GUIDE.md", ".agents.md"]

症状:后半段规则「没生效」,尤其是子目录里的文件根本没被拼进去。

处理:

  • 提高上限
  • 把规划、审查、架构文档外链到独立 markdown,主文件保持短
  • 用 nested AGENTS.md 代替一份巨型根文件

主文件应是索引和硬约束,不是小说。

来源