Agent Plugins（4分钟阅读）

# 介绍 Agent Plugins 来源：https://vercel.com/blog/introducing-agent-plugins 一种将 Agent Skills 和 MCP 服务器打包为可分发包插件的通用格式 今天，Agent Plugins 1.0.0 正式公开发布。Agent Plugins（https://agent-plugins.org/）是一种开放、与供应商无关的插件标准，用于扩展 AI 智能体。 Agent Skills（https://agentskills.io/home）为 AI 智能体提供可复用的指令和资源。MCP 服务器（https://modelcontextprotocol.io/docs/getting-started/intro）将智能体连接到工具和服务。两者都可以在不同客户端之间复用，但客户端通常以不同的方式打包和发现它们。 Agent Plugins 为兼容的客户端提供了一种通用格式：一个包含 `plugin.json` 清单（manifest）且各组件位置固定的目录。该格式刻意保持精简且易于实现，并将安装、分发、策略、用户体验以及客户端特有功能都留给各个客户端自行处理。 ## [一个包，承载可移植的部分](https://vercel.com/blog/introducing-agent-plugins#one-package-for-the-portable-parts) 扩展作者通常需要将同一个组件适配为多种客户端格式。尽管底层的 Skill 或 MCP 服务器完全相同，客户端往往期望不同的顶层元数据、发现路径或 MCP 配置。 Agent Plugins 为这些共享组件提供了一个可预测、结构化的统一归属地： `` my-plugin/ ├── plugin.json ├── skills/ │ └── summarize/ │ ├── SKILL.md │ ├── scripts/ │ └── references/ ├── mcp.json └── com.example.client/ `` 一个最小的 JSON 清单（`plugin.json`）标识规范版本并命名插件： `` { "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json", "name": "my-plugin" } `` 这两个字段是清单的最低要求，其余约定由目录本身的文件结构体现。可复用的组件不应为每个客户端重新打包，因此该格式只规定客户端发现并加载其中内容所需的信息。 每个兼容的客户端都会在插件根目录检查 `plugin.json`。支持 Skills 的客户端在 `skills/` 目录下发现它们。支持 MCP 服务器的客户端从 `mcp.json` 读取配置。客户端可以支持其中一种组件类型，也可以同时支持两者。在客户端验证清单后，各组件会被独立验证，因此一个无效组件不会禁用其他无关组件。 对于插件作者而言，这意味着同一个组件需要遵循的客户端专属约定更少。对于客户端实现者，该规范定义了一个小型的、确定性的契约，用于发现、验证和加载。 ## [刻意保持精简](https://vercel.com/blog/introducing-agent-plugins#small-on-purpose) Agent Plugins 定义了插件的可移植契约，而客户端的行为则由各个客户端自行决定。 版本 1 将契约聚焦于两类组件：Agent Skills 和 MCP 服务器。两者都已经拥有自己的规范和相当规模的应用，Agent Plugins 并不试图重新定义它们。Agent Plugins 提供了一种共享定义，说明客户端如何在一个可分发插件中共同找到这些组件。 其他组件（如命令、钩子和智能体）仍由客户端自行处理。技术指导委员会可能会在未来的版本中考虑增加其他组件类型，随着语义的收敛和可移植性需求的明确。 保持边界精简，使格式更易于实现，并为生态在增加更多可移植接口之前留出收敛的空间。 ## [客户端保留灵活性](https://vercel.com/blog/introducing-agent-plugins#clients-retain-flexibility) 在共享格式演进的同时，客户端需要创新的自由，因此 Agent Plugins 包含一种带命名空间的扩展机制，用于承载客户端特定的数据和文件。 扩展部分不属于可移植契约。每个客户端定义自己的命名空间，其他客户端会忽略该命名空间。这样可以防止客户端特定行为渗入公共格式，或阻碍共享组件的采用。客户端特定能力可以继续保持客户端特定，直到有理由和共识将其标准化。 ## [一个开放的多厂商项目](https://vercel.com/blog/introducing-agent-plugins#an-open,-multi-vendor-project) Vercel 发起了该提案，来自 Amazon Web Services (AWS)、Anysphere、GitHub、Microsoft、OpenAI 和 Vercel 的代表协作完善，最终形成 Agent Plugins 1.0.0。 初始技术指导委员会包括来自 AWS、Cursor、Microsoft、OpenAI 和 Vercel 的核心维护者。 该项目以开放许可发布，其维护者、贡献流程和技术决策都是公开的。没有任何一家公司的产品路线图能决定该格式的方向。 ## [使用 Agent Plugins 1.0.0 构建](https://vercel.com/blog/introducing-agent-plugins#build-with-agent-plugins-1.0.0) 规范、JSON Schema 以及面向插件作者和客户端实现者的指南可在 agent-plugins.org（https://agent-plugins.org/）获取。治理和贡献流程位于 GitHub 上的 Agent Plugins 规范仓库（https://github.com/agentplugins/agent-plugins-spec）中。 如果你编写智能体扩展，你可以使用该规范将 Skills 和 MCP 服务器打包在一个可移植清单之下。如果你构建智能体客户端，该规范的一致性检查清单定义了发现和加载 Agent Plugins 的最低要求。 发布之初，Agent Plugins 支持以下产品： - ChatGPT 和 Codex - Cursor - GitHub Copilot - Kiro - VS Code 插件作者只需打包一次组件，其插件即可自动在支持的客户端之间携带。 Agent Plugins 是构建智能体扩展的作者与加载这些扩展的客户端之间的契约。现在，该契约已经定义并向双方开放，供共同塑造。