Agent插件开放标准正式发布

一种将 Agent Skills 和 MCP servers 打包为可分发插件的通用格式。

今天，Agent Plugins 1.0.0 正式公开发布。Agent Plugins 是一项开放、厂商中立的插件标准，用于扩展 AI agents。

Agent Skills 为 AI agents 提供可复用的指令和资源。MCP servers 将 agents 连接到工具与服务。两者都可以跨客户端复用，但不同客户端通常采用不同的打包和发现方式。

Agent Plugins 为兼容客户端提供了一种通用格式：一个包含 plugin.json manifest，并为各组件规定固定位置的目录。该格式刻意保持精简且易于实现，同时将安装、分发、策略、用户体验和客户端特有能力交由各客户端自行决定。

为可移植部分提供统一的软件包

扩展作者经常需要将同一个组件适配成多种客户端格式。即使底层的 Skill 或 MCP server 完全相同，不同客户端通常也会要求不同的顶层元数据、发现路径或 MCP 配置。

Agent Plugins 为这些共享组件提供了一个位置固定、结构清晰的统一归宿：

my-plugin/├── plugin.json├── skills/│   └── summarize/│       ├── SKILL.md│       ├── scripts/│       └── references/├── mcp.json└── com.example.client/

一个最小化的 JSON manifest（plugin.json）会标明规范版本和插件名称：

1{2  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",3  "name": "my-plugin"4}

这两个字段是 manifest 的最低要求，其余约定则通过目录本身的文件结构来表达。可复用组件不应为了适配每个客户端而重新打包，因此，该格式只规定客户端发现并加载其中内容所必需的信息。

所有兼容客户端都会检查插件根目录下的 plugin.json。支持 Skills 的客户端会在 skills/ 下发现它们；支持 MCP servers 的客户端则会从 mcp.json 读取其配置。客户端可以支持其中一种组件类型，也可以同时支持两种。客户端验证 manifest 后，会分别验证各个组件，因此某个组件无效并不会导致其他无关组件被禁用。

对插件作者而言，这意味着同一个组件需要遵循的客户端特有约定更少。对客户端实现者而言，该规范为发现、验证和加载定义了一套小巧且确定的约定。

刻意保持精简

Agent Plugins 定义了插件的可移植约定，同时将客户端的具体行为交由各客户端自行决定。

1.0 版本将这一约定聚焦于两种组件类型：Agent Skills 和 MCP servers。两者都已经拥有各自的规范，并得到了一定规模的实际采用，Agent Plugins 无意重新定义它们。Agent Plugins 提供的是一套共享定义，用于规定客户端如何在一个可分发插件中同时找到这些组件。

其他组件，例如 commands、hooks 和 agents，仍由客户端自行处理。随着相关语义逐渐趋同，并出现经过实际验证的可移植需求，Technical Steering Committee 可能会在未来版本中考虑加入更多组件类型。

保持较小的边界能让这一格式更容易实现，同时也为生态系统留出充分空间，使其在扩展更多可移植能力之前逐步形成共识。

客户端仍保有灵活性

在共享格式持续演进的同时，客户端也需要拥有创新的自由。因此，Agent Plugins 为客户端特有的数据和文件提供了一套带命名空间的扩展机制。

这些扩展不属于可移植约定。每个客户端定义自己的命名空间，其他客户端则会忽略它。这样可以防止客户端特有行为渗入通用格式，或阻碍共享组件的采用。某项客户端特有能力可以继续保持为客户端专属，直到有充分理由并形成共识将其标准化。

一个开放的多厂商项目

Vercel 发起了这项提案，随后来自 Amazon Web Services（AWS）、Anysphere、GitHub、Microsoft、OpenAI 和 Vercel 的代表共同完善了提案，最终形成 Agent Plugins 1.0.0。

首届 Technical Steering Committee 包括来自 AWS、Cursor、Microsoft、OpenAI 和 Vercel 的 Core Maintainers。

该项目采用开放许可证，其维护者、贡献流程和技术决策均向公众公开。不存在由任何一家公司的产品路线图决定该格式发展方向的情况。

使用 Agent Plugins 1.0.0 进行构建

该规范、配套的 JSON Schemas，以及面向插件作者和客户端实现者的指南，均可在 agent-plugins.org 获取。治理方式与贡献流程则位于 GitHub 上的 Agent Plugins 规范仓库中。

如果你开发 agent 扩展，可以使用该规范，通过一个可移植 manifest 打包 Skills 和 MCP servers。如果你开发 agent 客户端，该规范提供的符合性检查清单定义了发现和加载 Agent Plugins 所需满足的最低要求。

发布之初，以下平台已支持 Agent Plugins：

插件作者只需打包一次组件，其插件便可自动在支持该规范的客户端之间迁移。

Agent Plugins 是构建 agent 扩展的作者与加载这些扩展的客户端之间的一份约定。现在，这份约定已经得到明确定义并完全开放，双方都可以共同塑造它的未来。

Eric Dodds、Andrew Qu