【Agent Plugins 1.0.0技术解析】用plugin.json统一打包Skills与MCP服务器
文章目录Agent Plugins 1.0.0技术解析用plugin.json统一打包Skills与MCP服务器一、引言二、统一的是打包不是所有能力三、plugin.json与版本选择四、MCP配置与安全边界五、与现有插件体系对比六、落地与迁移建议七、总结Agent Plugins 1.0.0技术解析用plugin.json统一打包Skills与MCP服务器一、引言亲爱的朋友们创作不容易若对您有帮助的话请点赞收藏加关注哦您的关注是我持续创作的动力谢谢大家有问题请私信或联系邮箱jasonai.fngmail.comAgent Skills 解决“教 Agent 怎么做”MCP 解决“让 Agent 能调用什么”但开发者仍要为不同 IDE 和编码智能体维护不同目录、清单与安装说明。Agent Plugins 1.0.0 提出一个很小但关键的互操作底座用根目录plugin.json声明插件身份在固定位置放置 Skills 与mcp.json让兼容客户端按同一规则发现和加载。它是开放、厂商中立的目录规范不是新的通信协议也不替代 MCP 或 Agent Skills。官网当前列出的首届技术指导委员会核心维护者来自 Amazon、Cursor、Microsoft、OpenAI 和 Vercel部分简讯所称 Google 已加入核心维护者截至 2026 年 8 月 7 日尚未在治理页得到确认。Google 的 Agents CLI、Data Agent Kit 等产品已体现插件化路线但应与规范治理成员资格分开表述。二、统一的是打包不是所有能力my-plugin/ ├── plugin.json ├── skills/ │ └── summarize/ │ ├── SKILL.md │ ├── scripts/ │ └── references/ ├── mcp.json └── com.example.client/ └── hooks/组件标准职责是否必需plugin.json名称、版本、作者、仓库与目标规范必需skills/按 Agent Skills 规范组织的知识与流程可选mcp.jsonstdio、Streamable HTTP 或 SSE 服务器可选反向域名目录客户端私有扩展如 hooks可选规范故意把安装、市场、权限界面、更新策略和客户端专有功能留给各家实现。它定义的是“最小可移植核心”避免为了追求大一统而把所有宿主差异塞进清单。三、plugin.json与版本选择一个最小 1.0.0 清单只有两个字段{$schema:https://agent-plugins.org/schemas/1.0.0/plugin.schema.json,name:hello-plugin}规范要求客户端先验证根清单再发现组件。顶层字段是封闭集合未知字段会被报告和忽略客户端私有元数据必须放进extensions并使用反向域名命名空间。设计选择解决的问题规范版本写入$schema客户端明确按哪套规则解释整个包固定目录无需每个宿主重新声明Skills位置闭合顶层字段防止不同客户端争抢同名字段语义extensions命名空间允许创新而不污染可移植核心组件失败非致命一个MCP启动失败时Skills仍可加载四、MCP配置与安全边界mcp.json可声明本地 stdio 或远程 Streamable HTTP 服务。${PLUGIN_ROOT}指向只读包内容${PLUGIN_DATA}指向客户端管理的可写持久数据。插件相对路径必须以./开头且不能逃逸根目录。{$schema:https://agent-plugins.org/schemas/1.0.0/mcp.schema.json,mcpServers:{validator:{type:stdio,command:./bin/validator,args:[--data,${PLUGIN_DATA}/validator],cwd:${PLUGIN_ROOT}}}}路径约束只保证包内文件不通过配置逃逸不等于沙箱。启动后的进程拥有什么系统权限仍由客户端和操作系统决定。规范也没有定义可移植 OAuth 或秘密引用Header 是可见包数据不得内嵌凭据。风险规范提供的防线宿主仍需负责目录逃逸路径包含性检查文件系统沙箱未知字段报告并忽略用户可理解的诊断秘密泄露禁止把Header当秘密机制凭据存储与授权交互远程重定向禁止未授权跨源转发Header网络策略与域名信任恶意进程无完整解决安装审查、签名与运行隔离五、与现有插件体系对比方案主要对象优势局限Agent Plugins 1.0SkillsMCP可移植包小、明确、跨客户端不统一市场、权限与hooksClaude/Copilot插件单一宿主完整扩展功能丰富、体验深跨宿主需适配Gemini/Antigravity插件Google Agent工具链与Google开发生态结合私有能力不自动可移植APM等包管理器安装、依赖与导出解决版本与分发需要额外工具链裸MCP配置单个工具服务器简单直接缺少配套技能和包元数据Agent Plugins 最适合同时包含知识流程和工具连接的能力包例如“云数据库运维”可包含诊断 Skill、只读审查规则和监控 MCP。只有一个远程 MCP 地址时直接配置可能更简单。六、落地与迁移建议第一步先抽出真正可移植的 Skills 与 MCP宿主专有 hooks 放入反向域名扩展。第二步用官方 JSON Schema 做 CI 校验并测试组件单独失败时的降级行为。第三步建立来源、版本、哈希、权限和更新记录目录格式统一不代表插件天然可信。面向多个 IDE 时不要立刻删除旧封装。可先以 Agent Plugins 为源格式在发布流程中生成各宿主兼容层等目标客户端完成 1.0.0 一致性验证后再减少重复目录。七、总结维度核心结论定位面向AI Agent扩展组件的开放可移植包格式核心根plugin.json、skills/与mcp.json固定布局兼容用最小核心承载Skills和MCP私有能力走命名空间安全有路径和配置规则但不替代进程沙箱与供应链审查治理官网当前列出Amazon、Cursor、Microsoft、OpenAI、Vercel核心维护者Agent Plugins 1.0.0 的价值类似早期软件包清单它没有替开发者解决所有运行时问题却让“同一份 Agent 能力到处打包”第一次拥有可检查的共同合同。真正决定它能否成为标准的不是plugin.json有多少字段而是各家客户端是否愿意对同一个小核心做一致实现。参考资料Agent Plugins 官方网站Agent Plugins Specification 1.0.0Build an Agent PluginAgent plugins in VS Code — MicrosoftAgent Plugins for AWS — GitHubAgents CLI in Agent Platform — Google Developers Blog
)
