ByteNoteByteNote

字节笔记本

2026年8月29日

MCP 和 AGENTS.md 进了 Linux 基金会

API中转
¥120

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 服务器,换一个代理是不是还能读懂。

相关链接

分享: