你还在给每个AI工具单独喂规则？60,000个开源项目已经把“Agent说明书”统一成一份文件了，连Linux基金会都下场接管，而国内大部分团队还在用复制粘贴的方式伺候三四个不同的AI编码工具。
最近海外AI开发圈真正值得聊的话题，不是又出了什么新模型，而是一份长得不能再朴素的Markdown文件——AGENTS.md。
它的官网就一句话定位："Think of AGENTS.md as a README for agents"——给AI Agent看的README。你在仓库根目录放一个 AGENTS.md，里面写清楚怎么装依赖、怎么跑测试、代码风格是什么，所有支持的AI编码工具会自动读取并照办。
听起来平平无奇？看数据：
更关键的信号是：AGENTS.md 现在由 Linux 基金会旗下的 Agentic AI Foundation（Agentic AI 基金会）托管。官网页脚写的是 "AGENTS.md a Series of LF Projects, LLC"。一个格式被中立基金会收编，意味着它已经不是某家的私产，而是要按行业标准来维护的公共设施——参照历史上 OSI、Cloud Native 的路径，进了 Linux 基金会的格式，基本就是“事实标准”的盖章仪式。
如果你过去一年同时用过两三个AI编码工具，一定干过这种事：
.cursorrules 或规则文件；同样的构建命令、同样的测试口径、同样的代码风格，写了三四遍，还各自会漂移——改了A忘了B，然后纳闷为什么Cursor生成的代码总是不过lint。
AGENTS.md 的思路简单粗暴：写一份，所有工具都认。它的由来也说明这一点——官网明确写着，这个格式是 OpenAI Codex、Amp、Google Jules、Cursor、Factory 等团队“协作催生”的，也就是说，竞对们罕见地坐下来一起定了个君子协定，因为碎片化对谁都没好处。
和 README 的分工也很清晰：README 是给人看的（项目介绍、快速上手），AGENTS.md 是给Agent看的（构建步骤、测试命令、约定俗成）。有些细节写进README会污染人类读者的阅读体验，但它恰恰是Agent最需要的那种“啰嗦”。
官网给出的接入流程，几乎是零成本：
第1步：在仓库根目录创建 AGENTS.md。 大部分Agent工具你只要开口说“帮我生成一份AGENTS.md”，它自己就能给你搭好骨架。
第2步：写真正有用的部分。 官方推荐的几个高频板块：
# AGENTS.md
## Setup commands
- Install deps: `pnpm install`
- Start dev server: `pnpm dev`
- Run tests: `pnpm test`
## Code style
- TypeScript strict mode
- Single quotes, no semicolons
- Use functional patterns where possible
第3步：把“你会怎么交代新同事”的都写进去。 commit message规范、PR标题格式、安全红线、部署步骤——你在茶水间会叮嘱实习生的东西，都属于这里。
第4步：老文件迁移。 FAQ里直接给了命令，把旧格式改名并做个软链接保持兼容：
mv AGENT.md AGENTS.md && ln -s AGENTS.md AGENT.md
个别工具需要一行配置指路，官网也给现成答案：
.aider.conf.yml 里写 read: AGENTS.md.gemini/settings.json 里配置 { "context": { "fileName": "AGENTS.md" } }这是我认为信息密度最高的部分——monorepo支持。
规则很简单：Agent 自动读取目录树里离被改文件最近的那份 AGENTS.md，就近优先。于是每个子包可以带自己的定制说明。官网举的例子相当有说服力：OpenAI 主仓库在撰写时放了 88个 AGENTS.md 文件，一个子项目一份。
冲突时的仲裁规则也定得干净利落：
还有个隐藏福利，FAQ里写得明白：如果你在文件里列了测试命令，Agent会主动执行这些检查，失败了自己修。也就是说AGENTS.md不只是“风格建议”，它更像一张Agent的完工验收清单——你写什么命令，它就跑什么命令。
flowchart TD
A[Agent 收到任务: 修改 packages/web/src/api.ts] --> B{沿目录树向上找 AGENTS.md}
B --> C[找到 packages/web/AGENTS.md 就近优先]
C --> D[读取: 子包专属规则<br/>测试命令/风格约定]
D --> E{根目录还有 AGENTS.md?}
E -->|有, 补充读取| F[合并规则: 子包覆盖根目录]
E -->|无| G[只用就近文件]
F --> H[Agent 执行任务]
G --> H
H --> I{聊天框里有显式指令?}
I -->|有, 优先级最高| J[按聊天指令覆盖一切]
I -->|无| K[按 AGENTS.md 规则完工]
J --> L[自动运行文件中列出的测试/lint]
K --> L
L --> M{全部通过?}
M -->|是| N[交付结果]
M -->|否| O[自行修复后重跑]
O --> L
这是国内用户最容易懵的点。直说我的判断：这不是替换关系，是收敛关系。
AGENTS.md 官网的兼容名单里，Cursor、Copilot、Windsurf、Aider 这些工具全部在列——它们此前各有各的规则文件写法，现在同时把 AGENTS.md 作为一份通用的输入。你的 CLAUDE.md 这类工具私有文件依然可以保留工具专属的偏好，但跨工具通用的那部分（构建、测试、规范）应该抽出来放进 AGENTS.md，一份维护，处处生效。
对中国从业者的现实意义有三层：
| 维度 | 你可能以为的 | 实际情况 |
|---|---|---|
| 规则文件 | 每个AI工具各配一份 | AGENTS.md 一份通用，20+工具认 |
| 采用度 | 小众社区实验 | 60,000+开源项目采用，含apache/airflow等顶级仓库 |
| 归属 | 某家公司的私货 | Linux基金会旗下Agentic AI Foundation托管 |
| 大仓库 | 一份规则管全局 | 支持嵌套，OpenAI主仓库放了88个 |
| 作用 | 风格建议 | 列出的测试命令Agent会自动执行并修错 |
| 成本 | 需要平台/工具链 | 零成本，一个Markdown文件 |
ls 一下你最活跃的仓库根目录——没有AGENTS.md就建一个，先把“装依赖/跑测试/代码风格”三段写上，10分钟的事；本文由「51学通信」技术团队出品。51学通信由通信行业18年老兵爱卫生（微信ID: gprshome201101）维护。 聚焦5G/6G核心网、3GPP标准、AI工具实战。知识星球「51学通信」提供深度技术答疑和行业洞察。
[!tip] 51学通信知识星球 星主：爱卫生（微信：gprshome201101）——公众号「51学通信」创办者，19 年通信行业运维与讲师经验，著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书（各大电商平台有售）。 星球定位：深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域，主打运维岗位与信令分析。 当前规模：5200 篇主题 / 990 个回答，198 元/年。 加入福利：加入星球后请加爱卫生微信，拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题，另有群内分享。 AI 加持：51学通信知识星球已作为 skill 接入 WorkBuddy，使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例，做总结、找文档和 PPT 等场景全覆盖。