8月6日,OpenAI 开发者账号发了一条推文,配了一段95秒的视频。
视频里一个叫 Corey Ching 的开发者坐在 OpenAI 办公室里,对着镜头说了一句话:"Build a plugin once and use it across compatible agent clients." 写一次插件,到处能用。
然后屏幕切到 VS Code,展示了一个只有三个文件的目录结构。
就这么简单。
PART 01
这事到底解决什么问题
做过 AI Agent 开发的人应该都有这个痛点:你在 Cursor 里写了个插件,想在 Claude Code 里用?对不起,格式不兼容,得重新包装一遍。想在 ChatGPT 里也用?再来一遍。
每个 Agent 客户端都有自己的插件格式。哪怕底层是完全相同的技能(Skill)或 MCP 服务器,换一个客户端就得重新适配一遍目录结构、元数据字段、发现路径。这不是技术问题,这是生态碎片化。
Agent Plugins 1.0.0 就是要解决这件事。
它定义了一个共享格式:一个目录,一个 plugin.json 清单文件,加上固定位置的组件。所有兼容客户端用同一套规则去发现和加载插件。
PART 02
包结构长什么样
视频里演示的 hello-plugin 目录结构极其简洁:
hello-plugin/
├── plugin.json ← 必须,插件身份清单
├── skills/ ← 可选,技能目录
│ └── greet/
│ └── SKILL.md
├── mcp.json ← 可选,MCP 服务器配置
└── com.openai/ ← 可选,客户端专属扩展
plugin.json 最小只需要两个字段:
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "hello-plugin"
}
完了。没有多余的配置,没有复杂的构建步骤。
技能(Skills)放在 skills/ 目录下,每个技能一个子文件夹,里面放 SKILL.md 和脚本。MCP 服务器配置写在 mcp.json 里。如果需要针对特定客户端做定制,用反向域名命名空间隔开——比如 com.openai/ 放 OpenAI 专属配置,com.cursor/ 放 Cursor 专属配置。
视频里特别演示了这个场景:同一个插件,plugin.json 里的 extensions 字段同时定义了 OpenAI 平台的短描述和图标、Cursor 编辑器的图标。一份配置,多个客户端各取所需。
PART 03
谁在支持
"SUPPORTED BY"——AWS、Cursor、GitHub、Microsoft、OpenAI、Vercel 六家 logo 并排。
首批兼容客户端名单:ChatGPT、Codex、Cursor、GitHub Copilot、Kiro、VS Code。
这不是某个公司的单方面提案。Vercel 发起了这个项目,AWS、Anysphere(Cursor 母公司)、GitHub、Microsoft、OpenAI 六家联合打磨成 1.0.0 版本。技术指导委员会(TSC)的初始成员来自 AWS、Cursor、Microsoft、OpenAI 和 Vercel。
没有一家公司的产品路线图能单独决定这个格式的走向。
PART 04
规范设计的克制
Agent Plugins 1.0.0 刻意保持了极小的接口面。
它只打包两种组件:Agent Skills 和 MCP 服务器。这两者各自已经有成熟的规范和大量采用。Agent Plugins 不重新定义它们,只是给它们找了一个共同的容器。
至于命令(commands)、钩子(hooks)、Agent 定义这些组件——规范明确说,留给各家客户端自己处理。反向域名扩展机制让每个客户端可以加自己的东西,但不会污染共享格式。
这种设计选择很务实。与其一开始就试图包罗万象,不如先把最容易标准化的部分做扎实。未来如果某种组件的跨客户端复用需求足够强,再纳入规范不迟。
安全边界也考虑到了:插件目录内的文件路径必须留在插件根目录内,不允许通过符号链接逃逸。一个组件加载失败不会拖垮其他组件。
PART 05
开发者怎么看
推文发出几小时就拿到了将近90万次浏览。评论区最火的一条引用了 xkcd 第927号漫画——那幅著名的"又一个标准"的梗图:工程师说"我要做一个通用的统一标准",旁边已经有15个标准了。
这个调侃不无道理。AI Agent 生态确实已经有 MCP 了,而 MCP 本身就是解决连接问题的协议。现在又多了一个 Agent Plugins。
但仔细看会发现它们解决的是不同层级的问题。MCP 是通信协议——Agent 怎么连接外部工具和服务。Agent Plugins 是打包格式——怎么把技能和 MCP 服务器打成一个可分发的包,让不同客户端都能认。
一个管管道,一个管包裹。
PART 06
对国内 Agent 生态意味着什么
国内的 Agent 开发者目前主要聚焦在百度文心、通义千问、智谱等平台上,插件格式各不相同。Agent Plugins 作为 OpenAI 主导的开放标准,短期来看直接影响有限——它首先在海外主流 Agent 客户端之间建立互通。
但长期信号很明确:Agent 生态正在走向标准化。
如果未来主流 Agent 框架(LangChain、CrewAI、AutoGen 等)开始支持这个格式,插件作者的分发成本会大幅降低。写一次,到处用——这正是 npm 之于 Node.js、Docker 之于容器化曾经做过的事。
对于正在做 Agent 开发的团队,现在值得关注两件事:一是 agent-plugins.org 上的规范和示例仓库,了解格式细节;二是留意你使用的客户端工具何时宣布兼容。一旦你的主力工具支持了,迁移成本几乎为零——因为格式本身就是为零适配设计的。
PART 07
写在最后
AI Agent 领域的标准之争才刚开始。MCP 解决了 Agent 和工具之间的对话问题,Agent Plugins 解决了插件的分发问题。但 Agent 之间的协作、Agent 的身份管理、Agent 的安全边界……还有太多问题没有答案。
三个文件的包结构、六家巨头的联合——Agent Plugins 1.0.0 不是终点,但它可能是 AI 插件生态走向互通的第一步。
值得关注。
THANKS FOR READING
⚡ 爱马仕 · Hermes Agent 技术分享
夜雨聆风