你给 Cursor 写了一个 Skill,又接了一个 MCP。换到 Codex 或 VS Code 的 Copilot,往往还要再排一次目录、改一版元数据、对一下发现路径。
底层还是同一份 SKILL.md,还是同一套 MCP 配置。变的是各家客户端的包装约定。
组件能跨工具复用,包装却各写各的。
8 月 6 日,Agent Plugins 1.0.0 公开发布:一份开放、厂商中立的插件格式,专门把 Agent Skills 和 MCP servers 打进同一个可分发目录。规范站在 agent-plugins.org,提案由 Vercel 发起,AWS、Anysphere(Cursor)、GitHub、Microsoft、OpenAI、Vercel 一起打磨到 1.0.0。
这篇写我们关心的:对用 Cursor / Claude Code / Codex 的人,它解决什么、长什么样、怎么 3 步打出第一个 Plugin。
一、缺的不是又一个商店,是一套包装格式
Skills 解决「可复用的指令与资源」,MCP 解决「怎么连工具和外部服务」。两边各自有规范,也能跨客户端复用。
卡住的是中间层:扩展作者要把同一组件适配多种客户端格式——顶层元数据、发现路径、MCP 配置写法经常不一样。
Agent Plugins 的定位就一句:
一个目录 +
plugin.json+ 固定放法。 只约定「可移植部分」长什么样;安装来源、商店、权限弹窗、界面怎么露出来,全留给各客户端。
这和之前写的 《Google 发布 OKF》是同一类问题:OKF 标准化的是知识包怎么长;Agent Plugins 标准化的是 Skills + MCP 怎么打成一包。一个管上下文产物,一个管扩展分发。
二、Agent Plugins 长什么样(30 秒版)
一个 Plugin = 一个目录。规范示例:
my-plugin/
├── plugin.json
├── skills/
│ └── summarize/
│ ├── SKILL.md
│ ├── scripts/
│ └── references/
├── mcp.json
└── com.example.client/
最小清单只要两字段(其余 version、description、author 等可选):
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "my-plugin"
}
约定很死、也很小:
| 位置 | 装什么 |
|---|---|
根目录 plugin.json |
插件身份 + 规范版本($schema) |
skills/ |
每个直接子目录一个 Skill,且带 SKILL.md |
mcp.json |
MCP 服务器配置(stdio / Streamable HTTP 等) |
com.xxx.client/ 等反向域名目录 |
客户端私有扩展,其他客户端直接忽略 |
兼容客户端先找根上的 plugin.json。支持 Skills 的读 skills/,支持 MCP 的读 mcp.json,可以只支持一种。清单校验通过后,各组件再独立校验——一个坏组件不拖死整包。
坦率讲:就是把你们已经在写的 Skill / MCP,塞进一个「大家都认的鞋盒」,鞋带怎么系(安装、权限)还是各家自己来。
三、和你在用的东西怎么对应
| 你现在的做法 | Agent Plugins 里叫什么 |
|---|---|
单独一份 SKILL.md / skills 仓库 |
放进 skills/<name>/SKILL.md |
| 各客户端各写一份 MCP 配置 | 统一写根目录 mcp.json,客户端再映射到本地配置 |
| Claude Code 自己的 plugin 布局 | 另一套格式;启动支持名单里没有 Claude Code |
| Cursor / Codex / Copilot / VS Code 各自装扩展 | 同包可被多家「发现并加载」(装法仍看各客户端) |
| hooks、斜杠命令、自定义 agents | v1 不进可移植核心,走客户端扩展命名空间 |
Agent Plugins 不重写 Skills,也不重写 MCP。它只定义:它们在插件里住哪、怎么被发现、失败怎么隔离。
上线时官方点名已支持:
- ChatGPT 和 Codex
- Cursor
- GitHub Copilot
- Kiro
- VS Code
四、3 步:打你的第一个 Agent Plugin
不用等商店。最小可工作包只要两样文件(来自官方指南)。
1、建目录
hello-plugin/
├── plugin.json
└── skills/
└── greet/
└── SKILL.md
2、写 plugin.json
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "hello-plugin"
}
名字有硬约束:1–64 字符,小写字母/数字/连字符/点,首尾必须是字母或数字。my-plugin、acme.tools 可以;My-Plugin、-start 不行。
3、写一个 Skill
skills/greet/SKILL.md:
---
name: greet
description: Greet the user and offer help.
---
Greet the user and offer help.
支持 Skills 的客户端会加载清单、扫 skills/ 的直接子目录、按 Agent Skills 规范校验每个 SKILL.md。
要加 MCP:在根目录放 mcp.json,$schema 版本与 plugin.json 对齐。需要完整样例可看官方 agent-plugins-example 仓库。装进具体客户端时,以该客户端文档为准(路径、开关、市场源各不相同)。
五、我怎么看 Agent Plugins(以及它的边界)
值得盯的点:
- 故意做小。 v1 只钉 Skills + MCP——已经有独立规范、也有真实采用。commands / hooks / agents 先留在客户端,等语义收敛再谈要不要进可移植面。
- 扩展命名空间。
extensions与com.xxx.client/让各家继续创新,又不污染公共契约。这是标准能活下来的关键设计。 - 失败隔离。 清单致命错误才整包拒绝;单个 Skill 坏了、单个 MCP 起不来,不影响其余组件。排错时这点很实在。
- 和 OKF 同向。 都是「可移植层做薄、客户端行为做厚」。你搭复利系统时:知识用 OKF 思路打包,扩展用 Agent Plugins 打包,边界更清楚。
别指望它解决的:
- 不会自动帮你想清楚 Skill 该怎么写、MCP 该暴露哪些工具
- 不是统一安装器——商店、权限、沙箱仍是客户端的事
- 不是全宇宙已统一:Claude Code 启动名单不在列;各客户端对 MCP 传输类型的支持也可能不齐
- 规范文本与 schema 冲突时,以规范正文为准
如果你已经在 Cursor / Codex 里堆 Skills 和 MCP,我的建议是:别另起炉灶重写内容。 先拿一个现成 Skill,按上面三步套进 plugin.json + skills/,在已支持的客户端里走一遍发现/加载。一周就能判断:少维护几份客户端特供包装,值不值。
参考链接
- Vercel — Introducing Agent Plugins:https://vercel.com/blog/introducing-agent-plugins
- Agent Plugins 规范站:https://agent-plugins.org/
- Vercel — The Complete Guide to Agent Plugins:https://vercel.com/kb/guide/agent-plugins
- 规范仓库:https://github.com/agentplugins/agent-plugins-spec
- 示例仓库:https://github.com/agentplugins/agent-plugins-example
- Agent Skills 规范:https://agentskills.io/
- MCP 入门:https://modelcontextprotocol.io/