正在打开每日关注
正在打开每日关注
通过规范化清单、Skills 与 MCP 配置,示范如何将既有插件增量迁移到 Agent Plugins v1。
@OpenAIDevs @awsdevelopers @cursor_ai @github @code @vercel For plugin devs: We built a plugin to help you convert your existing plugin to support the new spec - https://t.co/nJ7tAPbZ8g
是什么 这是一个可复制的 GitHub 参考包,同时承担 Agent Plugins Specification v1.0.0 的迁移指南作用。仓库明确说明它是示例实现,规范文本具有更高优先级;推文强调的价值,是帮助既有插件适配新规范。
架构与核心设计
最小插件只需要根目录 plugin.json。示例进一步采用 skills/ 存放直接子目录下的 Agent Skills,并以可选的根目录 mcp.json 配置 MCP 服务器。plugin.json 使用闭合 Schema,禁止把 hooks、agents、commands、mcpServers 等客户端字段直接塞入顶层;客户端专属数据应放入 extensions,专属文件则放进客户端拥有的反向域名命名空间。
关键洞察 迁移策略是增量式的:先添加并验证可移植清单,再复制可复用 Skills,转换 MCP 配置,同时保留 Hooks、UI、LSP 与市场元数据等平台能力。这样能把跨客户端共享核心与客户端适配层分开,降低一次性重构风险。
边界与风险 该仓库不是规范替代品,也没有证明所有客户端都已支持这些扩展。迁移前应核对目标客户端实际实现,明确 MCP 传输类型,验证路径、Schema、Skills 及各客户端集成;只有在测试完成后,才适合移除旧文件或兼容包。