发布日期2026-08-10 | 数据来源agent-plugins.org、OpenAI 官方博客 | 话题Agent Plugins 1.0 · AI 插件标准 · 跨客户端兼容Agent Plugins 1.0 是 OpenAI 联合 AWS、Cursor、GitHub、微软VS Code、Vercel 于 2026 年 8 月 6 日发布的开放式、厂商中立的 AI 智能体插件标准定义了一套以plugin.json为清单、skills/name/SKILL.md为工作流描述、mcp.json为外部工具连接的可移植目录结构使开发者写一套插件配置就能在 VS Code、Cursor、GitHub Copilot、ChatGPT/Codex 和 Kiro 五个主流客户端中被发现和加载其核心定位是终结过去各家客户端各搞一套专有格式的碎片化局面而非取代 MCP——MCP 解决客户端如何连接外部工具Agent Plugins 解决插件文件如何被跨平台识别和组织两者互补共存。Agent Plugins 是什么2026 年 8 月 6 日OpenAI 携手五家合作伙伴AWS、Cursor、GitHub/微软、Vercel发布了 Agent Plugins 1.0 标准。这是一个开放的、厂商中立的规范任何 AI 客户端都可以实现它任何开发者都可以按照它打包插件。标准试图解决一个具体问题在 2026 年的 AI 开发工具生态里一个 Cursor 插件到了 VS Code 里就用不了一个 GitHub Copilot 扩展到了 ChatGPT 里就得重写一遍。每个客户端有自己的格式、自己的发现机制、自己的配置字段。对开发者来说这意味着同一个功能要维护三四套代码。Agent Plugins 的答案是定义一套最小可移植目录结构客户端按这个格式解析开发者按这个格式打包中间不再需要适配层。plugin.json 最小配置两个字段就能启动Agent Plugins 插件的核心文件是plugin.json最小合法配置只需两个字段{$schema:https://agent-plugins.org/schemas/1.0.0/plugin.schema.json,name:research-tools}$schema声明规范版本name是插件的唯一标识符。一个能被五大客户端识别的插件从这两行开始。完整插件的目录结构如下my-plugin/ ├── plugin.json # 清单文件必须 ├── skills/ │ └── code-review/ │ └── SKILL.md # 技能描述可选 ├── mcp.json # MCP 服务器配置可选 └── extensions/ # 客户端特定扩展可选 ├── vscode/ └── cursor/关键设计原则客户端特定的配置放在extensions/命名空间不进plugin.json顶层字段。这保证了顶层格式的跨平台稳定性——一个不认识某客户端扩展的工具可以直接忽略extensions/目录而不影响其他部分的加载。五大客户端兼容性一览Agent Plugins 1.0 发布时五个主流 AI 开发工具已同步支持客户端Agent SkillsMCP stdioStreamable HTTPLegacy SSEVS Code✅✅✅✅Cursor✅✅✅✅GitHub Copilot✅✅✅✅ChatGPT / Codex✅✅✅❌Kiro✅✅✅✅目前唯一的差异点ChatGPT / Codex 不支持 Legacy SSE 传输其余四个客户端四项全绿。对大多数新插件来说这不是问题——Streamable HTTP 是更新的标准Legacy SSE 主要用于兼容较早的 MCP 服务器。值得注意的是标准页面标注为 “Working Draft”官方明确说明不保证每个客户端实现每个组件和每种 MCP 传输。可移植性意味着客户端能按共同约定发现和加载插件而不是保证所有客户端行为完全一致。Agent Skills 和 MCP什么情况用哪个这是 Agent Plugins 生态里最容易混淆的问题。规范给出了一个清晰的定义Skill 智能体应该知道什么、应该怎么工作MCP 智能体如何连接外部能力对应到文件层面维度Agent SkillsSKILL.mdMCP 服务器mcp.json核心定位可复用的指令、工作流、领域知识连接数据库、API、浏览器等外部服务典型场景代码审查规范、文档生成模板、操作流程数据库查询、部署工具、第三方 API 调用网络依赖无需要本地进程或远程 HTTP 端点失败隔离单个无效 Skill 被跳过其余继续单个无效 MCP 条目不影响其他服务器一个实际决策建议如果你要打包的是给 AI 的工作说明书用 SKILL.md如果你要打包的是AI 调用的工具用 mcp.json。两者可以在同一个插件里共存——大多数生产级插件会同时包含两者。Agent Plugins 和 Codex 插件是同一回事吗不完全是但两者密切关联有必要区分清楚。Codex 插件Codex Plugin是 OpenAI 于 2026 年 3 月推出的 ChatGPT/Codex 产品层功能有自己的.codex-plugin/plugin.json规范、三层 Marketplace 体系个人/团队/公共目录和$plugin-creator脚手架工具。它是 OpenAI 旗下产品的插件发行和管理机制。Agent Plugins 1.02026 年 8 月 6 日是在此基础上推动的跨厂商开放标准目标是让同一套插件格式能被非 OpenAI 客户端Cursor、VS Code、Kiro 等识别。可以理解为Codex 插件是 OpenAI 的产品实现Agent Plugins 是多方共同确认的开放规范两者在文件格式层面高度兼容但 Agent Plugins 去掉了 OpenAI 专有字段保留了可跨客户端移植的最小核心。对开发者的实际影响如果你已经在按 Codex 插件格式开发迁移到 Agent Plugins 1.0 的成本很低——主要差别是把客户端特定配置移入extensions/目录并使用agent-plugins.org的 schema URL。运行时环境变量Agent Plugins 规范定义了两个运行时环境变量插件 Hooks 和脚本中可以直接使用变量说明PLUGIN_ROOT已安装插件的根目录路径PLUGIN_DATA插件的可写数据目录这两个变量由客户端在加载插件时注入使插件脚本能在不硬编码路径的前提下定位自身文件和持久化存储。1.0 版本的已知局限Agent Plugins 1.0 是一个工作草案状态的规范几个重要功能明确不在 v1 可移植核心范围内Hooks 和命令目前仅作为客户端特定扩展存在不在跨客户端保证范围内子进程沙箱隔离规范未定义安全责任下放给各客户端实现插件签名验证v1 无内置签名机制无法验证插件来源的真实性这意味着安装插件前用户仍需自行判断来源可信度。规范的保守设计有其合理性——让五家厂商在发布日当天就全部支持一个复杂的安全模型门槛会高得难以实现。沙箱和签名预计在后续版本中加入。开发者现在值得上手吗几个参考判断维度你在同时支持多个客户端Cursor VS Code GitHub Copilot现在上手最合算。一套格式覆盖三个客户端是 Agent Plugins 最直接的价值。你只用 ChatGPT / Codex不需要跨客户端Codex 插件格式已经成熟没有迁移的紧迫性。Agent Plugins 与其兼容未来需要跨平台时再迁移成本也不高。你在构建需要调用外部工具的 Agent 工作流SKILL.md mcp.json 的组合是目前最被广泛认可的结构已有五大主流客户端支持。构建 Agent 工具后端时选用支持多款主流大模型标准接口的 API 平台如七牛云 Token Planqiniu.com/ai/plan可以让插件在不同模型之间切换而无需改动调用代码。你在意规范稳定性Working Draft 状态意味着字段可能调整。核心字段$schema、name、skills/、mcp.json稳定性最高extensions/内的客户端特定字段变更概率更高。常见问题QAgent Plugins 和 MCP 是竞争关系吗不是是互补关系。MCPModel Context Protocol定义客户端如何与外部工具服务器通信连接生命周期、传输协议Agent Plugins 定义插件文件如何组织和跨客户端识别目录结构、清单格式。一个 Agent Plugins 插件可以在mcp.json中声明 MCP 服务器两者在同一个插件中共存。Qplugin.json 放在哪个位置根据 Agent Plugins 1.0 规范plugin.json放在插件根目录不是.codex-plugin/子目录。Codex 插件的plugin.json放在.codex-plugin/下是 OpenAI 产品层的约定两者有细微差别开发时注意对应关系。QSKILL.md 必须写什么格式推荐包含 frontmattername和description字段加自然语言工作流描述格式与 Codex 插件中的 SKILL.md 相同。内容越具体AI 客户端的执行结果越稳定。Q五个客户端加载同一个插件行为会完全一样吗不保证完全一致。可移植性意味着五个客户端都能发现和加载这个插件不意味着每个客户端对同一个 SKILL.md 的理解和执行方式完全相同。跨客户端测试仍然必要。Q现在有没有 Agent Plugins 的公共市场可以发布插件规范本身不定义发布渠道。各客户端有自己的发现机制——Codex/ChatGPT 有 Universal Plugin DirectoryCursor 和 VS Code 有各自的扩展市场。发布时需参考目标客户端的具体要求。小结Agent Plugins 1.0 在 2026 年 8 月 6 日解决了一个真实存在的碎片化问题开发者不再需要为每个 AI 客户端维护一套专有插件格式。五大客户端在发布当日同步支持多厂商背书让这个标准比单一厂商推出的格式有更强的生命力。当前版本是工作草案沙箱隔离和签名验证尚未纳入规范Hooks 和命令不在跨客户端保证范围。对于同时服务多个 AI 开发工具的插件作者现在是合适的上手时机对于只在单一客户端部署的场景可以等规范稳定后再迁移成本不高。本文数据截至 2026 年 8 月 10 日规范处于 Working Draft 阶段字段定义以 agent-plugins.org 最新版本为准。延伸阅读Agent Plugins 1.0 官方规范https://agent-plugins.org/OpenAI Agent Plugins 发布公告2026-08-06https://openai.com/blog/agent-pluginsMCP 官方文档与 Agent Plugins 互补https://modelcontextprotocol.io/七牛云 Token Plan多模型 API可用于 Agent 工具后端https://qiniu.com/ai/plan
