AllWorkin / Articles / 2026.08.07

Agent Plugins 发布:Skills + MCP 终于能打一个包了(附 3 步打第一个 Plugin)

Agent Plugins 1.0 把 Skills 和 MCP 打进同一个可移植目录:plugin.json + skills/ + mcp.json。安装和权限仍归各客户端,但作者少维护几份特供包装。Cursor / Codex / Copilot / VS Code 等已支持。这篇对照你现在的写法,并给出 3 步打第一个 Plugin。

2026.08.07约 6 分钟#Skills#MCP#Agent#Cursor

你给 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(以及它的边界)

值得盯的点:

  1. 故意做小。 v1 只钉 Skills + MCP——已经有独立规范、也有真实采用。commands / hooks / agents 先留在客户端,等语义收敛再谈要不要进可移植面。
  2. 扩展命名空间。 extensions 与 com.xxx.client/ 让各家继续创新,又不污染公共契约。这是标准能活下来的关键设计。
  3. 失败隔离。 清单致命错误才整包拒绝;单个 Skill 坏了、单个 MCP 起不来,不影响其余组件。排错时这点很实在。
  4. 和 OKF 同向。 都是「可移植层做薄、客户端行为做厚」。你搭复利系统时:知识用 OKF 思路打包,扩展用 Agent Plugins 打包,边界更清楚。

别指望它解决的:

  • 不会自动帮你想清楚 Skill 该怎么写、MCP 该暴露哪些工具
  • 不是统一安装器——商店、权限、沙箱仍是客户端的事
  • 不是全宇宙已统一:Claude Code 启动名单不在列;各客户端对 MCP 传输类型的支持也可能不齐
  • 规范文本与 schema 冲突时,以规范正文为准

如果你已经在 Cursor / Codex 里堆 Skills 和 MCP,我的建议是:别另起炉灶重写内容。 先拿一个现成 Skill,按上面三步套进 plugin.json + skills/,在已支持的客户端里走一遍发现/加载。一周就能判断:少维护几份客户端特供包装,值不值。


参考链接

AI工具实战派

觉得有用?每周的新笔记先发公众号。

每周的实战笔记先发在这里。扫码关注,新文章第一时间推给你。

关注 / 加入社群 →