人工生成AGENTS.md: 智能体在读代码前先读的文件
README留给人看。旁边从2025年8月起多了一份文件，从2025年12月9日起它归Agentic AI Foundation所有。
AGENTS.md是仓库根目录里一份普通的Markdown文件。 里面写着这个项目怎么构建、测试和动手改。OpenAI在2025年8月和Codex一起发布了它。据OpenAI和Linux Foundation称，到2025年12月9日它已经出现在超过60.000个开源项目里，OpenAI已把它交给 Agentic AI Foundation 了。
没有必填字段。下一个智能体读你放进去的文本。
一份README向人解释怎么开始、目的是什么、怎么参与。AGENTS.md是补充，以防下一个同事不是人：构建、测试、约定，这些会把README塞满。agents.md页面说，名字和格式是故意选成这样的，好让每个工具都能用。没有必填字段。标题随便起。智能体解析文本。
团队往里放什么，页面复述成常见清单：概览、构建和测试、风格、安全，再加上提交规则、坑、大数据、部署。就是你第一天会对新同事说的那些。你要是列出测试命令，智能体就会试着跑它们、修错误，然后才把任务当完成。以后改这份文件是预期中的。活文档，不是带版本号的合同。
Codex需要一个固定位置。其他工具也有同样的缺口。
OpenAI把2025年12月9日的起点描述成Codex里一个实际缺口。智能体需要一个可预期的地方放项目特有的东西：约定、构建、测试，好在陌生代码库里干活，不用每次重新猜。文件应该挨着README.md。一开始是内部方案，后来就留在生态里了。
agents.md页面点名了格式出自的那一圈：OpenAI Codex、Amp、Google的Jules、Cursor和Factory。Linux Foundation把发布时间定在2025年8月，并列出采用方Amp、Codex、Cursor、Devin、Factory、Gemini CLI、GitHub Copilot、Jules和VS Code。同一份名单也在OpenAI那边，还带数字：从发布到2025年12月9日，超过60.000个开源项目。
Nick Cooper交出的是一份文件，不是协议。
Nick Cooper，OpenAI的Member of the Technical Staff，出现在Linux Foundation的新闻稿里代表移交。他的话：健康的智能体生态需要共同的、由社区推动的协议，所以OpenAI公开了Codex CLI、Agents SDK，现在又公开了AGENTS.md。这份文件是Agentic AI Foundation的第三项创始贡献，旁边是Anthropic的MCP和Block的goose。它不是协议。 MCP 是通向工具的导线。 A2A 是代理之间的导线。AGENTS.md 是仓库的阅读规则。
基金持有它们，以便在采用扩大时没有哪家单一公司掌控方向。agents.md 页面用现在时说着同一句话：Steward 是 Linux Foundation 下的 Agentic AI Foundation。维护和继续开发承诺保持为开放格式，不管你用哪个编程代理。
更近的文件胜过更上面的。你在聊天里的句子胜过两者。
在大仓库里不是一个文件，而是每个包一个。代理从它动手的文件到根的路径上读取最近的 AGENTS.md。更近的获胜。你在聊天里的明确句子胜过两者。页面举当时 OpenAI 主仓库为例：文本当时有 88 个这样的文件。旧的 AGENT.md 通过重命名和符号链接一起带上，好让现有工具不扑空。
图 01 · 三层，一条规则。黄色是对 src 里改动算数的那份文件。聊天里的句子在其上，这里没画出来。
在 McGrinsey，这样一份文件放在项目文件夹根目录。同一类文本：下一个代理开始前必须知道什么。跟基金会的差别不在形式上。差别在于，当成千上万仓库用同一约定时，谁握着方向。基金就是干这个的，不是为了你文件里的内容。
文件，日期，数字。
| 说法 | 篮子 | 来源 |
|---|---|---|
| AGENTS.md 是没有必填字段的 Markdown。README 留给人。更近的文件获胜，聊天胜过文件。 | 事实 | agents.md，FAQ 和解释。 |
| 源自 Codex、Amp、Jules、Cursor 和 Factory。发布于 August 2025。 | 事实 | agents.md (这一轮). Linux Foundation 和 OpenAI (这个月). |
| 超过 60.000 个开源项目，截至 2025 年 12 月 9 日。工具：Amp, Codex, Cursor, Devin, Factory, Gemini CLI, GitHub Copilot, Jules, VS Code. | 事实, 移交状态 | OpenAI 和 Linux Foundation, 2025 年 12 月 9 日. |
| OpenAI 将文件移交给 AAIF。Nick Cooper 为引语署名. | 事实 | Linux Foundation 的新闻稿, 2025 年 12 月 9 日. |
| OpenAI 主仓库中的 88 个 AGENTS.md 文件. | 事实, 页面时点 | agents.md, 其文本时点. |
| Steward 是 Linux Foundation 下的 Agentic AI Foundation. | 事实 | agents.md, About 部分. |
- OpenAI, 共同创立2025 年 12 月 9 日. Codex 作为契机, 2025 年 8 月, 60.000 个项目.https://openai.com/index/agentic-ai-foundation/
- Linux Foundation2025 年 12 月 9 日. Nick Cooper, 同一数字, 同一工具列表.https://www.linuxfoundation.org/press/linux-foundation-announces-the-formation-of-the-agentic-ai-foundation
截点: 2026 年 9 月 30 日.
