03 · AGENTS.md 进阶

分层、monorepo 与"活文档"运营

📚 《Codex 进阶玩法》第 3/20 篇 · 下一篇：04 · config.toml 高级旋钮

AGENTS.md 从"写了"到"体系"。

01 三层加载

全局（~/.codex 级：你的通用偏好）、仓库根（项目宪法）、子目录（局部规矩）。根文件写前端规范会污染后端任务——层级各管各的。

02 monorepo 实战

每个 package 一份局部 AGENTS.md：构建命令、测试路径、该包的约定。跨包任务不再重复解释规矩。

03 活文档

每次纠正后回写规则；规则要具体到命令和路径——"注意代码质量"式空话执行不了。万行说明书没人读得完，精简是遵守率的朋友。

04 动手

为一个 monorepo 设计三层 AGENTS.md → 验收：跨包任务零重复解释。

05 小结

规矩焊进文件，才能焊进流程。下一篇拧旋钮。

📎 实战案例

根目录 AGENTS.md 写了前端规范，后端任务也被污染。工程师改成三层（全局/仓库/子目录）、monorepo 每个 package 一份局部说明、纠正后回写后，跨包任务不再重复解释规矩。

踩坑

• 我的根文件混装了三种规范，后端任务频频被前端规矩带偏——分层后立愈。
• 规矩写了不回写不迭代——同一个错误纠正了五次才醒悟。