AGENTS.md怎么写2026年10月19日提问追问3次3次类似提问

我把鸭哥的context infrastructure发给codex让它帮我安装,对话是在codex一个新建的项目中打开的,我发现它能够帮我安装好但却无法很好让这个上下文系统运行,我还是没办法体验到“使用鸭哥的上下文系统”有什么不同。然后我检查了文档的位置,发现鸭哥的context-infrastructure/在我所在工作区文件夹内,而AGENTS.md在context-infrastructure/子目录下。所以我应该怎么让codex帮我调整呢?

问题多半不在安装,而在加载路径:Codex 只从工作区根目录读 AGENTS.md,你的规则藏在子目录里,等于没被加载。先让 Codex 把入口文件放到根目录并指向子目录,再用一个小任务验证它是否真的读到了。

AI根据立正公开的文章和视频整理,不是他本人回复。重要的判断,请回到出处核对。

规则文件放错层,系统就不会被加载

AI推演

Codex 这类工具默认从项目根目录找 AGENTS.md 之类的入口文件,子目录里的文件不会自动生效。你的 AGENTS.md 在 context-infrastructure/ 下面,工作区根目录没有入口,所以 Codex 装好了文件却不知道要按这套规则工作,表现就是“能装不能用”。可以这样让它调整:把 context-infrastructure 当作规则库,在工作区根目录放一个 AGENTS.md,写明这套上下文系统在哪、什么时候读哪些文件、遇到任务先查什么。让 Codex 先读子目录里的原文件,再据此生成根目录入口,而不是把内容复制一份,避免以后两处不同步。这对应的是分层管理:原始材料留在子目录,根目录只放加载规则和索引⁠1。

用一个小任务验证它是否真的加载了

AI推演

改完路径后,不要直接上正式工作,先挑一个能暴露“有没有读到上下文”的小任务。比如让它按这套系统回答一个只有读过你材料才知道的问题,或让它说明这次任务会加载哪些文件、为什么。如果它答得出、能说清加载了哪几份,说明入口生效;如果还是泛泛而谈,问题就在入口文件写得不够具体,而不是安装没成功。立正讲自己用 Manus 时,前十四次都不够好,靠一轮轮迭代才调顺,并把原因归到自己使用 AI 的方式上,而不是产品本身⁠2。同样,这套系统跑不起来,先当作加载和描述的问题去改,而不是换工具。

上下文系统要能自动找到该读的部分

装好只是第一步。这套架构的核心是渐进式加载:AI 执行任务时自动找到并加载需要的那部分上下文,不多不少,靠索引、分类和加载策略实现⁠1。所以根目录的入口文件不该把所有内容一股脑塞进去,而应写清“什么任务读哪个目录、先读索引再读细节”。文件是 what,skill 是 how,还要有把任务分配到对应材料上的机制⁠3。你可以在入口文件里先只写三件事:材料在哪、按什么顺序读、什么情况下不该读。跑通后再补规则。

现有材料讲的是上下文架构的分层与加载原则,没有针对 Codex 读取 AGENTS.md 的具体路径规则;根目录入口的具体写法需以鸭哥项目文档为准。

出处

  1. 1你团队的 AI 效果不好,问题不在模型,在 Context

    超线性学院 · 会员2026-04-09

    讲清分层管理、渐进式加载和 AGENTS.md 在工具链中的位置,适合核对入口文件该承担什么。

  2. 2E195|从工具到伙伴:七位AI Agent深度使用者的思考

    xiaoyuzhoufm.com发言:立正2025-06-10

    用反复迭代调顺工具的经历,说明先改使用方式而不是换工具。

  3. 3从焦虑到上手: 白领/投资者的AI实战第一课【串台课代表立正】

    xiaoyuzhoufm.com发言:立正2026-04-20

    区分 context 文件是 what、skill 是 how,以及任务如何分配到材料上,帮助理解为何只放文件不够。

追问2026年10月19日

根目录的 AGENTS.md 具体该写哪几行,才能让 Codex 稳定找到子目录里的材料?

根目录 AGENTS.md 不必抄长文,写清“入口在哪、何时读、读哪份”三件事即可:声明子目录是上下文系统、给出索引文件路径、要求先读索引再按任务取材料。

根目录只放指针,细节留在子目录

AI推演

Codex 从工作区根目录加载 AGENTS.md,所以根目录这份的角色是“总入口”,不是把 context-infrastructure 里的规则全搬上来。可以写三到五行:第一行说明本工作区使用 context-infrastructure 子目录作为上下文系统;第二行给出该目录下索引文件的相对路径,比如 context-infrastructure/AGENTS.md 或其中的 README;第三行要求开始任务前先读这份索引,再按索引决定读哪些材料;第四行写明子目录里的规则对本工作区有效。这样根目录文件短、稳定,子目录内容更新时不用反复改入口。立正提到 AGENTS.md 的价值在于把经验变成系统记忆、定义 AI 的行为规范,而不是多一个文档⁠1。

让索引承担“按需加载”,避免一次全塞

如果子目录里材料很多,根目录 AGENTS.md 不要写“读完所有文件”,而是指向一份索引,由索引说明哪类任务读哪份材料。立正讲过一个具体教训:guideline 越加越多,模型同时满足所有要求,产出反而变平均;后来把材料分成当前必须遵守的 active contract 和需要时才读的 reference⁠2。他也把这种做法叫渐进披露:先加载最关键的前置约束,随任务推进再引入细节⁠1。放到你的情况,根目录那几行可以要求 Codex 先读索引里的“当前任务约束”,再按索引取参考材料,而不是把整个 context-infrastructure 一次性读进来。

用一个小任务验证它真的读到了

AI推演

写完入口后,不要只看 Codex 说“已安装”。给它一个只有读到子目录材料才能做对的小任务,比如让它按 context-infrastructure 里的规则整理一份材料,或回答一个索引里才有的约定;观察它是否引用了子目录里的具体文件、是否按索引取材料。立正提到 Codex 这类 agentic 工具能调度本地文件、灌注大量上下文,但前提是上下文真的被接上⁠3。如果它仍然只按通用习惯回答,说明入口路径或索引指向有问题,再回头改根目录那几行。

现有材料没有给出 context-infrastructure 这个具体项目的目录结构和索引文件名,上面是写法原则,具体路径要按你子目录里的实际文件填。

出处

  1. 1AI User 与 AI Builder 的 5 个差距,和背后具体技术原因 | 科技大厂打工人版

    超线性学院2026-04-10

    说明 AGENTS.md 作为系统记忆和行为规范的作用,以及渐进披露为什么要先加载关键约束。

  2. 269 个版本,99 次 commit后,我做好了Stay Superlinear的主页

    超线性学院2026-07-18

    提供 guideline 过多导致产出变平均的具体教训,支撑“根目录只放指针、细节按需读”的写法。

  3. 3用豆包还是Codex,正在加速两极分化…

    视频发言:立正2026-08-07

    说明 Codex 能调度本地文件和上下文,可用来核对入口是否真的把子目录材料接上。

追问2026年10月19日

未来这个工作区的规则要修改会自动更新到context-infrastructure 子目录里对应的文件夹中,还是更新在工作区根目录下?如果还是在工作区根目录下更新,那这个上下文系统就变成是静态的了吧,它如何进化呢

根目录的 AGENTS.md 只做入口,规则本身应放在子目录的对应文件里;系统靠“每次纠正回流到文件”来进化,而不是靠根目录那份入口文件不断变长。

根目录只留入口,规则住在子目录

AI推演

你担心的“静态”其实来自把规则都堆在根目录那一份文件里。更合适的做法是:根目录 AGENTS.md 只写清子目录是上下文系统、索引在哪、什么任务先读哪份材料,具体规则按主题放进子目录对应文件夹。这样根目录文件几乎不用改,改的是它指向的那份材料,Codex 每次按索引加载,读到的就是最新版。目录名本身也是对内容的承诺,放错位置会让人和 AI 都靠记忆找东西⁠1。

进化靠纠正回流,不靠入口文件变长

立正讲上下文基础设施时,把“持续提炼”列为技术架构的一环:原始材料要定期被加工成有效经验、踩过的坑和判断标准,AI 调用时才更准⁠2。新版课程里对应的说法是 backflow——每次纠正都沉淀回系统,而不是只留在当次对话里⁠3。所以规则更新的正确路径是:你在某个任务里纠正了 Codex,让它把这条纠正写进子目录里对应的规则文件,并在索引里登记;根目录入口不变。这样系统会随使用变厚,而不是停在安装那天。

自治要有边界,改规则也该有人把关

AI推演

立正遇到 Codex 擅自发布对外内容时,没有收紧权限,而是加了一道 approval gate,并让 AI 把这条规则写进 AGENTS.md⁠4。同理,你可以让 Codex 提议修改规则文件,但由你确认后再落盘;同时明确哪些改动可以直接写、哪些必须你批准。这样既保留自动沉淀,又不会让规则被悄悄改歪。

现有材料讲的是上下文基础设施的一般原则,没有专门说明鸭哥这套目录里规则文件的具体更新位置,需以你手上的实际目录结构为准。

出处

  1. 1把500多集视频全都转成了播客

    超线性学院2025-12-07

    讲目录名是对内容的承诺,适合判断规则文件该放子目录哪个位置。

  2. 2你团队的 AI 效果不好,问题不在模型,在 Context

    超线性学院 · 会员2026-04-09

    讲三层上下文架构,含持续提炼与渐进式加载,适合核对规则该放哪层、怎么被调用。

  3. 3AI Builders第13轮更新(2026.8)

    超线性学院2026-08-11

    说明新版课程里 facts/skills/perspectives 与 backflow 的定位,适合理解系统如何随纠正进化。

  4. 4Codex“背着我”发了个帖,但我不怪她…

    视频发言:立正2026-07-21

    立正处理 Codex 越权发布的具体做法,适合参考改规则时如何设审批边界。

追问2026年10月19日

怎么让 Codex 在每次纠正后自动把经验写回子目录的规则文件?

让纠正自动回流,靠的是在规则文件里写一条“何时写、写到哪、写什么”的约定,并让 Codex 在每次纠正结束时执行它;单靠 AGENTS.md 不会自动记住。

把“纠正后写回”写成一条可执行的约定

Codex 不会因为被纠正就自动改文件,它需要一条明确指令。可以在子目录的规则文件里加一段:当用户指出我的做法不对、或我犯了错并已改正时,在结束前把这次纠正提炼成一句可复用的规则,追加到对应主题的规则文件里,并说明改的是哪个文件。关键是写“什么算纠正、写到哪个文件、写成什么形式”,而不是只说“记得更新”。立正提到,经验要沉淀成规则、模板和检查清单,系统才会越跑越强,而不是每次重新摸索⁠1。他还主张告诉 AI 什么是好的、什么是容易犯的错误,少教它具体怎么做⁠2,所以写回的内容宜是判断标准和边界,不是操作步骤。

先在一个小任务上验证回流是否真的发生

AI推演

可以先挑一件你最近纠正过 Codex 的小事,比如它把文件放错了目录。纠正后直接要求它把这次纠正写进子目录里对应的规则文件,然后打开那个文件看:写进去的是不是一句下次能直接用的判断,而不是这次任务的流水账。再换一个同类任务,看它是否不再犯同样的错。目录本身也要能说明用途,立正说目录名是对里面内容的承诺,按操作性质划分比按场景堆在一起更可靠⁠3;规则文件放在哪个子目录,也应让 Codex 一眼知道该往哪写。如果它写到了根目录入口文件,说明入口里没写清“规则正文在子目录”,需要补这一句。

现有片段没有给出“纠正后自动写回”的具体文件写法或触发机制,上面是按立正关于经验沉淀和规则写法的判断做的推演,需在你的工作区里实测。

出处

  1. 1AI User 与 AI Builder 的 5 个差距,和背后具体技术原因 | 科技大厂打工人版

    超线性学院2026-04-10

    说明经验要沉淀成规则、模板和检查清单,以及 AGENTS.md 这类文件为何能把个人技巧变成系统记忆。

  2. 2从结果确定性到通用智能:和韦晓亮老师聊AI、产品与教育

    超线性学院2026-09-09

    说明写规则时应侧重好坏标准和常见错误,少写具体步骤,决定写回内容的形式。

  3. 3把500多集视频全都转成了播客

    超线性学院2025-12-07

    用目录命名即承诺的例子,帮助判断规则文件该放在哪个子目录、怎么让结构本身说明用途。

你也有想问的?

卡住的时候,问问立正:回答附有出处,可以点回原文核对。

也可以接着问:

所有问题 →