一年前 OpenAI 定了个行业标准，一年后被最大用户逼着"改不改就禁用"。这不是一场工具口水仗，而是每个跑多模型 Coding Agent 的团队都要回答的问题：仓库里的指令层，归模型厂商还是归仓库自己。
一封"封杀令"，砸开近一年的僵局
Shopify CEO Tobi Lütke 在 X 上公开放话：要么支持行业标准，要么在拥有数千开发者的 monorepo 里禁用这款工具。36氪 沉默了近一年的 Anthropic 随即回应：正在提高可定制性，未来会更方便地使用 AGENTS.md——但开发者听完更气了，因为"未来"的代价已经有人在用脚本硬扛。
这个切片里的你大概不陌生：手里同时用着两三种 Coding Agent，在仓库里维护 CLAUDE.md 或 AGENTS.md 这类指令文件，把构建命令、测试规范、禁区写进去，让 Agent 少问两句。这场争论之所以值得停下来看，是因为它决定了你这套维护成本以后归谁付。
为什么它敢叫"指令层"
先补一句事实背景：AGENTS.md 不是某家私货，OpenAI 于 2025 年 8 月推出、当年 12 月就宣布被超 6 万个开源项目采用，此后移交给 Linux 基金会旗下的 Agentic AI Foundation，成了跨工具的中立约定。机器之心 而 Claude Code 坚持只认自家的 CLAUDE.md，GitHub 上那条兼容性请求攒了近 5000 个用户点赞，换来的是"不予修复"和"暂无计划"。36氪
中文社区的体感更直接："还在同时维护CLAUDE.md和AGENTS.md？"这样一条吐槽，在小红书编程话题下拿到 511 赞、841 收藏。小红书 一项覆盖 2926 个 GitHub 仓库的 2026 年研究给出的结论更干脆：上下文文件已经是开发者给编程 Agent 递指令的最常见方式，AGENTS.md 已被多种工具采用。36氪
也就是说，指令文件不是锦上添花的配置，而是 Agent 干活前"看见什么"的总闸：哪些目录归谁管、测试怎么跑、什么不能碰，都从这里装配进上下文。闸门放在厂商手里还是放在仓库手里，工作流的可控度完全是两个量级。
复杂度税：开发者替格式不兼容写的"无用"代码
Anthropic 给出的变通是两条：CLAUDE.md 里写 @AGENTS.md 做导入，或者干脆建符号链接。开发者 Ian Nuttall 把兼容做成了工程：递归查找所有 AGENTS.md，在同一目录创建指向它的 CLAUDE.md 符号链接；用 fswatch 持续监控新文件；设置 launchd 代理开机自动运行；再把生成的 CLAUDE.md 加入全局 Git 忽略列表。36氪 这套东西每多一台机器就要多复制一份一致性，Lütke 管这叫"愚蠢的复杂度税"——原本根本不该付。
而 Anthropic 拒收标准也有自己的逻辑：团队认为不同模型需要不同的指令，Thariq 此前透露，已为最新一代 Claude 5 模型删掉了大约 80% 的 Claude Code 系统提示词。36氪 顺着这个"一模型一配方"逻辑推下去，一个项目理论上要同时维护 17 份指令文件，每次模型更新还得重新评测改写——反驳他的那位开发者说得很直白："没有人会这么做。"模型差异的适配，本来就应该是 Harness 在产品内部消化的事。
反证与重估：指令层的价值不在长度，也不在听话
对指令层还有两拨冷水，值得一起看进决策里。第一拨来自日常实践：见过最难维护的 AGENTS.md 往往不是没写规则，而是背景、价值观、流程、模型名单、价格、临时通知全塞在一起，真正要紧的三五条要求反而被淹没。知乎 写得越长不等于越听话，指令层的正确形态是"管选路"而不是"管走路"：沉淀稳定的边界和验收标准，把易变的事实留在实时页面。
第二拨更扎心：2026 年的审计把编程 Agent 榜单的遮羞布扯了下来——被塞进评测默认加载指令文件里的答案，把通过率从 71.7% 抬到"第一名"。知乎 同一份文件，在你审过的生产环境里是地图，在别人塞给你的评测环境里就是泄题口。所以别拿榜单截图当换工具的依据：你该看的是它读不读你仓库里的指令层、能不能告诉你这一次任务到底加载了哪些文件。
按你的身份站队：指令层归属清单
个人项目、单工具：维持现状。你的 CLAUDE.md 或 AGENTS.md 只有一份，没有同步问题，这轮争议对你只是谈资。
小团队、2-3 种工具：统一以 AGENTS.md 为唯一事实源，Claude 侧用 @AGENTS.md 导入或符号链接补齐，把维护动作收进一处，别再各写各的。
monorepo / 平台工程角色：这正是 Lütke 的处境。要么自建递归加载+符号链接自动化并长期养着它，要么把兼容性写进采购标准：下一个季度评审 Coding Agent 时，"默认读取跨标准指令文件"应该是一项硬指标。
正犹豫要不要从 Claude Code 换到 Codex/Cursor：指令层归谁确实该进你的换仓成本表，但反证同样成立——换过去之后，先别迷信榜单分，拿自己仓库的真实任务跑一轮，看它读没读你写的文件、行为差异在哪。
接下来盯三个信号：Anthropic 是否给出默认读取 AGENTS.md 的具体时间表；.agents/skills 目录标准会不会被下一轮跟进；以及评测圈会不会把"指令文件审计"变成榜单标配。标准之争不会一周分出胜负，但每一次"不予修复"，都在给仓库侧的方案加分。
