TL;DR大仓库的解法不是把 AGENTS.md 写厚，而是拆薄：根目录放地图与全局约定，子目录放模块细节。r/codex 实战帖走通了这条路，这篇把做法拆成七步。

来源信号 SOURCES

以下内容整理自社区公开讨论，本页只做拆解与核实，不搬运原帖；观点归属原作者。

事实性知识 FACTS

这些说法可回到所列来源核对；涉及限额算法时，官方账户页面优先于社区归纳。

社区讨论里的概念不全是事实——每条都标注了它的性质，读之前先看标签。

静态仓库分析来源可核对

让代理只读不改，产出目录职责、入口文件与依赖关系的仓库地图。r/codex 实战帖的起点动作。

分层指令来源可核对

全局约定放根目录，模块特有约定放子目录，让指令跟着模块走。实战帖采用、社区指南支持的做法。

大仓库迷路个人观点

社区对「代理在大型代码库里读错文件、改错模块」现象的统称。现象被广泛报告，但成因分析与解法效果多为个人经验。

拆分命中率待验证假设

「分层之后代理首次命中正确文件的比例明显提高」这类断言，目前以单点经验为主，缺公开对照数据。

目标把一个大仓库改造成 Codex 能自助导航的形态：一层地图、多层模块说明，新会话不再从零摸。

前提仓库较大（多模块或多目录）；有根目录 AGENTS.md 或准备从零建。

结果根目录一份地图、核心模块各一份说明；换模块提需求时 Codex 能自行定位，不再从头摸起。

想知道今天的重置判定？回到首页实时雷达。