Agent Plugins

Summary

Agent Plugins 是一个开放、厂商中立的标准，用于将可复用组件打包为可移植的插件。其 v1.0.0 规范定义了 agent-skills 和 mcp-model-context-protocol 服务器的共享格式，让兼容的客户端能够一致地发现和加载这些组件。该项目由 Amazon、Cursor、Microsoft、OpenAI、Vercel 的核心维护者组成的 Technical Steering Committee 领导开发。

Key Facts

• 规范版本: v1.0.0 (Working Draft)
• 创建日期: 2026-04-03
• 网站: agent-plugins.org
• 规范仓库: github.com/agentplugins/agent-plugins-spec
• Stars: 660+
• Forks: 40+
• 技术指导委员会: Amazon, Cursor, Microsoft, OpenAI, Vercel

Why Agent Plugins?

AI agent 客户端各自发展了自己的插件格式，即使插件包含相同的底层组件。作者必须为每个客户端重新排列或重复这些组件——为一个客户端打包的插件可能需要适配才能被另一个客户端使用。

Agent Plugins 定义了一个小的互操作性底线，让可移植的部分使用一个可预测的结构，而分发、安装、权限、用户体验和客户端特定能力仍由每个客户端控制。

Plugin Package Structure

my-plugin/
├── plugin.json          # 必需：标识插件和目标版本
├── skills/              # Agent Skills（按 Agent Skills 规范格式）
│   └── summarize/
│       ├── SKILL.md
│       ├── scripts/
│       └── references/
├── mcp.json             # MCP 服务器描述（stdio/Streamable HTTP/legacy SSE）
└── com.example.client/  # 客户端扩展命名空间
    └── hooks/

manifest (plugin.json)

• 必需字段: $schema, name
• 可选字段: version, description, author, homepage, repository, license, keywords, extensions
• Schema URL: https://agent-plugins.org/schemas/1.0.0/plugin.schema.json
• Schema 是封闭的：未知顶层字段会被报告和忽略

Component Types

1. Agent Skills — skills/ 目录，格式由 agent-skills 规范定义
2. MCP Servers — mcp.json 清单，支持 stdio、Streamable HTTP、legacy HTTP+SSE 传输

Client Extensions

• 使用反向域名命名空间（如 com.example.client/）
• 每个客户端可以添加行为而不改变可移植核心
• 扩展数据放在 manifest 的 extensions 下或专用顶层目录中

Design Principles

1. 最小互操作性 — 只标准化可移植的部分，其余留给客户端
2. 安全 containment — 插件文件系统路径必须留在插件根目录内
3. 开放治理 — 提案和技术决策公开，参与对更广泛的生态系统开放
4. 渐进式采纳 — 客户端可以增量支持便携组件类型

Compatible Clients

客户端	Agent Skills	MCP transports
VS Code	✅	stdio, Streamable HTTP, legacy SSE

Relationship to Other Standards

• mcp-model-context-protocol — Agent Plugins 将 MCP 服务器作为核心组件类型之一，MCP 是其下层协议
• Agent Skills — Agent Plugins 将 Agent Skills 作为另一个核心组件类型，定义在 agentskills.io

Open Development

• 提案和技术决策在 GitHub Discussions 中公开
• 参与对更广泛的生态系统开放
• 新功能和实质性变更的构想要建立具体的可移植性需求和实现者支持

Related Pages

• mcp-model-context-protocol — Agent Plugins 的 MCP 服务器组件类型
• coding-agents — Agent Plugins 服务的 AI 编码 Agent 生态系统
• mcp-model-context-protocol — 工具集成协议和标准

---

Evidence Timeline

• 2026-08-09: Ingested from agent-plugins.org (sources/articles/agent-plugins-org-2026.md)