要点速览
- AGENTS.md 是一个用于指挥 AI 编码代理的开放标准——一份「给机器看的 README」，与 README.md 并列而非取代它。它于 2025 年 8 月由 OpenAI、Google、Cursor、Factory 和 Sourcegraph 共同正式确立。
- 采用速度很快：到 2025 年 12 月，已有超过 6 万个开源项目采用，20 多个 AI 编码工具支持它，包括 GitHub Copilot（2025 年 8 月起原生支持）、OpenAI Codex、Cursor、Google Jules 与 Gemini、Factory、Amp、Windsurf、Zed 和 RooCode。
- 2025 年 12 月，该规范被捐赠给 Linux Foundation 的 Agentic AI Foundation，从厂商约定升级为中立治理。
- 它不是 SEO 或 AI 可见度文件。 AGENTS.md 指挥的是在你的代码仓库内部工作的代理，对「ChatGPT 是否引用你的网站」毫无作用。那是
llms.txt的地盘，把两者混为一谈是常见且代价不小的错误。 - 比这个文件更重要的是可迁移的那条经验：对你的部分内容而言，机器读者已经多于人类读者，而机器读者在你显式写出指令时表现更好，而不是指望它去推断。
AGENTS.md 是什么
AGENTS.md 是放在代码仓库根目录的一个 Markdown 文件，告诉 AI 编码代理该如何在这个代码库里工作。它是对 README.md 的补充而非替代：README 面向人类开发者，给出概览和快速开始；AGENTS.md 承载代理真正需要的细节技术指令——构建命令、测试命令、代码规范、各目录含义、哪些东西不能碰。
该格式于 2025 年 8 月通过 OpenAI、Google、Cursor、Factory 和 Sourcegraph 的协作正式确立——值得注意的是这是一次跨厂商努力，而不是某一家公司的约定。在此之前，每个编码助手都想要自己的指令文件，一个要支持三个代理的仓库就得维护三份近乎重复、且会逐渐漂移的文件。
采用随之而来。GitHub Copilot 在 2025 年 8 月加入原生支持。到 2025 年 12 月，已有超过 6 万个开源项目采用该格式，20 多个 AI 编码工具会读取它。同月，规范被捐赠给 Linux Foundation 的 Agentic AI Foundation，纳入中立治理。
被反复报告的实际效果是一致的：代理跳过摸索阶段、生成的代码从第一次尝试就符合团队规范、评审轮次缩短。
里面该写什么
它没有刚性 schema，这既是这个格式的长处也是短处。成熟仓库普遍收敛到以下几类内容：
- 真正能跑通的命令。 精确的构建、测试、lint 和开发命令，包括用哪个包管理器。代理经常猜错，而一次猜错会烧掉一整轮。
- 规范。 命名、格式、文件布局，哪些模式是本项目风格、哪些是不该照抄的历史遗留。
- 目录语义。 什么在哪里、为什么。「自动生成——请勿编辑」是你能写下的最高价值的一行之一。
- 硬约束。 什么绝不能改、哪些文件是 vendored 的、哪些目录不走 lint、什么情况必须走迁移而不是直接改。
- 验证步骤。 代理该如何确认自己的改动生效了，尤其是在没有测试运行器的项目里。
有两种失败模式反复出现。第一种是为人类而写——大段关于项目理念的散文，代理无法据此行动。第二种是放任腐坏：一份描述着半年前就删掉的构建命令的 AGENTS.md，比没有这个文件更糟，因为代理会相信它。
值得澄清的一个混淆
2026 年有不少营销内容把 AGENTS.md 当成「下一个 llms.txt」。它不是，而且这个区别一说就清楚：
AGENTS.md | llms.txt | |
|---|---|---|
读者 | 在你仓库里工作的 AI 编码代理 | 读取你网站的 AI 爬虫与助手 |
位置 | 仓库根目录 | 站点根目录（ |
用途 | 如何构建、测试、修改这份代码 | 这个站点有什么、规范内容在哪里 |
影响 AI 对你网站的引用吗？ | 不影响 | 可能有，见下文 |
治理 | Linux Foundation Agentic AI Foundation | 社区提案，无正式标准机构 |
采用度 | 6 万+ 仓库、20+ 工具（2025 年 12 月） | 发布广泛，被消费得不一致 |
如果你的目标是让 ChatGPT 或 Perplexity 引用你的网站，AGENTS.md 完全不相关。发布一份不会给你的 AI 可见度带来任何一条引用。如果有人把 AGENTS.md 当 GEO 战术卖给你，这足以让你对他卖的其他东西都保持警惕。
也把这个对比说直白：llms.txt 是一份提案，很多站点在发布它，但很少有引擎被证实在消费它。我们写过llms.txt 到底有没有用，而不是默认它有用。相比之下，AGENTS.md 有可验证的消费方——二十多个指名工具会读它——因为读它的那些代理，是你主动请进自己仓库的。
这就是结构性差异：AGENTS.md 之所以有效，是因为读者是配合的，而上下文在你手里。面向公网的文件则取决于引擎是否愿意遵守。
营销团队为什么仍该关心
不是为了去发这个文件，而是为了注意它证明了什么。
机器读者响应显式指令，而不是推断。 AGENTS.md 之所以有效，根本原因就是「直接写出构建命令」胜过「指望代理从 package.json 里推出来」。这条规律对你的商品页同样成立。模型不会从一张尺寸表推断出你的产品适合小户型——而我们的接地查询数据显示，ChatGPT 自行生成的搜索中 58.4% 含「best」、26.9% 含「review」，说明引擎要找的是显式的、已被消化过的判断，而不是让它自己去推理的原始参数。
单一权威源胜过散落的真相。 AGENTS.md 之所以诞生，是因为三份近乎重复的指令文件逐渐漂移，代理跟了错的那份。你的价格同时存在于商品页、feed、schema 标记和三家零售商的列表里。当它们互相矛盾时，模型最安全的做法就是丢掉你。请指定一个权威源，并让其他地方向它对齐。
过期的机器指令比没有更糟。 代理信任 AGENTS.md，助手信任你的结构化数据。「错得很自信」在两种场景下都是代价最高的状态——没有日期、内容过期的常青页在检索中会被惩罚，而 ChatGPT 有 18.2% 的接地查询显式带年份。
标准会收敛。 五家厂商在不到一年内就统一到一个文件上，并把它交给了基金会。在商务层和内容层也要预期同样的压缩过程。请把投入押在已有跨厂商共识且有可验证消费方的部分；把单一厂商的约定视为临时方案。
常见问题
AGENTS.md 是官方标准吗？ 自 2025 年 12 月起它是 Linux Foundation Agentic AI Foundation 下的一份开放规范，最初由 OpenAI、Google、Cursor、Factory 和 Sourcegraph 于 2025 年 8 月正式确立。这是真正的中立治理，但它并不是 IETF 或 W3C 标准。
AGENTS.md 会取代 README.md 吗？ 不会。README 给人看，AGENTS.md 给代理看。两者都留着，不要在它们之间重复内容。
哪些工具会读它？ 截至 2025 年 12 月超过二十个，包括 GitHub Copilot、OpenAI Codex、Cursor、Google Jules 与 Gemini、Factory、Amp、Windsurf、Zed 和 RooCode。
AGENTS.md 对我的 AI 搜索可见度有帮助吗？ 没有。读它的是你仓库内部的代理，不是为你站点建索引的网络爬虫。站点级别的机器指令，要看 robots.txt（可达性）、结构化数据（事实）和 llms.txt（内容地图）。
AGENTS.md 和 llms.txt 都该发吗？ 如果你维护着一个会有 AI 代理在其中工作的代码库，发 AGENTS.md——它的价值清晰且可验证。如果你想发布一份内容地图，可以发 llms.txt，但要对它被消费得多不一致抱有现实预期。
下一步
面向网站的对应做法可以读如何为 GEO 创建 llms.txt 文件，以及更审慎的llms.txt 到底有没有用。想先确认 AI 爬虫到底能不能触达你的页面——这是上述一切的前提——请用AI 爬虫可达性检测。