字节笔记本
2026年8月29日
MCP 和 AGENTS.md 进了 Linux 基金会
2025 年 12 月 9 日,Linux 基金会成立了 Agentic AI Foundation(AAIF)。Anthropic 把 MCP 交过去,OpenAI 把 AGENTS.md 交过去,Block 把 goose 交过去,Docker 以 Gold member 加入。基金会换招牌不会改你仓库里已经在跑的协议字节;真正要动手的是两件事:根目录放一份 AGENTS.md,以及如果你自己维护 MCP 服务,跟上 2026-07-28 那版无状态规范。
基金会里现在管什么
AAIF 是 Linux 基金会下面的 directed fund,治理模型和 Kubernetes、PyTorch 那一套接近:会员出钱,技术决策仍在各项目的维护者和委员会。官网是 aaif.io,组织仓库在 github.com/aaif。
成立时带进去的三个项目:
- MCP(Anthropic,2024 年 11 月开源):模型和外部工具、数据之间的协议。声明发布时公开服务器已经过万,Claude、Cursor、Copilot、Gemini、VS Code、ChatGPT 都在用。规范现在仍在 modelcontextprotocol.io,仓库还是 modelcontextprotocol/modelcontextprotocol。
- AGENTS.md(OpenAI,2025 年 8 月):给编码代理看的 Markdown 约定,不是给人类读的 README。按官网说法,发布四个月后已经有六万多个开源仓库在用,Codex、Cursor、Gemini CLI、GitHub Copilot、Jules、VS Code 都会找这个文件。
- goose(Block):本机跑的开源代理,桌面、CLI、API 都有,扩展走 MCP。代码已经迁到 aaif-goose/goose。
白金会员当时是 AWS、Anthropic、Block、Bloomberg、Cloudflare、Google、Microsoft、OpenAI。2026 年 8 月,Google 的 Agent2Agent(A2A)也作为托管项目进了 AAIF,和 MCP 同屋不同栈:MCP 连工具,A2A 连代理之间。线格式没有跟着这次搬家改,别把治理新闻当成要立刻改接口。
仓库里放一份 AGENTS.md
README.md 给人看。AGENTS.md 给代理看:怎么装依赖、怎么跑测试、提交信息怎么写、哪些目录别动。格式就是普通 Markdown,没有必填字段,也没有 YAML frontmatter。
在仓库根目录新建一份,按你项目实际命令写,不要抄通用空话。
建议至少覆盖这几块:环境(包管理器、Node 版本、怎么起开发服务)、测试(全量命令和单测命令)、提交(标题格式、哪些文件不要交)。写进文件里的命令要自己先跑通,代理会真的去执行。
一份常见骨架长这样(命令换成你仓库自己的):
- 环境:包管理器、运行时版本、启动开发服务的命令
- 测试:全量测试、单测、lint
- 提交:标题格式、不要提交的路径
写具体命令,不要写「按项目规范执行」。
大 monorepo 可以在每个包再放一份。代理从当前工作目录往上找,离正在改的文件最近的那份生效;聊天里你当面说的话优先级最高。OpenAI 自己的主仓库当时有 88 份。
已经有 AGENT.md 或 CLAUDE.md 的,可以改名为 AGENTS.md,再给旧文件名留一条指向新文件的符号链接,旧工具还能读到。
它和站内写过的 .agents/skills 目录 不是一回事。AGENTS.md 是项目说明书;Skills 是可安装的任务配方。两个可以同时存在。
几个编码代理怎么读它
多数工具默认就会找根目录的 AGENTS.md。少数要改一行配置。
Gemini CLI 在 .gemini/settings.json 里把 context.fileName 设成 AGENTS.md。Aider 在 .aider.conf.yml 里写 read: AGENTS.md。Docker Agent 可以用 add_prompt_files 每轮注入这份文件,解析规则是从当前目录往上找最近的一份,再叠加一份家目录的 AGENTS.md(如果有)。文件缺了就跳过,不会报错。
列进测试章节的命令,代理一般会真的去跑。写错一条测试命令,它就会在错误的目录里空转。
维护 MCP 服务的人要看哪一版规范
把 MCP 捐给基金会,不等于你的服务器可以不升级。对写服务的人来说,真正会改代码的是 2026-07-28 规范。
这版把协议核改成无状态:初始化握手和会话 ID 头拿掉了。每个请求自己带着协议版本、客户端信息和能力(放在 _meta 里),可以打到负载均衡后面任意一台实例。Streamable HTTP 现在要带 Mcp-Method 和 Mcp-Name,网关不用拆 JSON body 就能路由。需要跨多轮的交互走 Multi Round-Trip Requests;长任务走可选的 Tasks 扩展。
TypeScript、Python、Go、C# 四个 Tier 1 SDK 已经跟这版。新服务直接按 2026-07-28 写。旧服务如果把会话状态塞在进程里,要先把状态挪到外部存储,再按官方 changelog 迁。Roots、Sampling、Logging 进了 12 个月的废弃窗口,新代码别再依赖它们。
只当 MCP 客户端用、自己不写服务器的,继续连现有客户端即可。规范页面和 MCP 博客这篇发布说明 比二手摘要靠谱。
想在本机试 goose
goose 是三个创始项目里唯一装上就能聊的。桌面端从 安装文档 下,CLI 安装命令以 仓库 README 为准。它接 15 家以上模型提供商,扩展走 MCP。适合拿来验证你刚写的 AGENTS.md 和本地 MCP 服务器,换一个代理是不是还能读懂。