Agent Plugins 1.0.0：给 AI 插件定「USB-C 接口」，一份打包五家通用

my-plugin/
├── plugin.json   ← 清单文件（只有 2 个必填字段）
├── skills/       ← 技能目录（可选，放 Agent Skills）
└── mcp.json      ← MCP 配置（可选，声明 MCP Server）

规则就三条：根目录必须有 plugin.json；技能全放 skills/；MCP 配置写在 mcp.json。客户端只支持其中一种组件类型时，可以忽略另一种——技能坏了不会拖垮同包的 MCP，各自独立检查。

{
  "schema": "https://agent-plugins.org/schemas/plugin.json",
  "name": "weekly-report-assistant"
}

schema 指向规范的 JSON Schema 地址（声明「我遵守这个标准」），name 是插件名（建议用英文短横线命名，如 weekly-report-assistant）。这就是全部必填内容——想加描述、版本、作者等元信息，按规范里的可选字段补充即可。

如果你已经在 Cursor、Codex 或 Claude Code 里写过 Agent Skill，它的结构（如 SKILL.md 主文件 + 参考资料/脚本目录）可以直接平移到 skills/ 下，无需重写：

my-plugin/
├── plugin.json
├── skills/
│   └── weekly-report/        ← 技能名目录
│       ├── SKILL.md          ← 技能主文件（指令）
│       └── templates/        ← 配套资源
└── mcp.json

如果你想让插件里带一个连数据库、查接口的 MCP 服务，把它在 mcp.json 里声明出来：

{
  "mcpServers": {
    "sales-db": {
      "command": "npx",
      "args": ["-y", "@yourorg/sales-db-mcp"],
      "env": {
        "DB_URL": "${DB_URL}"
      }
    }
  }
}

结构和你在别处配 MCP 的写法一致：command 指定启动方式，args 传参数，env 放环境变量。这样「技能 + 工具」就被打包成一个整体分发了。

目前官方兼容列表包含：VS Code、Cursor、GitHub Copilot、ChatGPT、Codex、Amazon Kiro。谷歌也已宣布在 Agents CLI 和 Data Agent Kit 中采用。具体安装方式各家略有差异，但通常就是「把插件文件夹放进客户端指定的插件目录」：

# 示例：把插件包放进行业常见的插件目录约定
~/.agent-plugins/
└── weekly-report-assistant/   ← 整个文件夹拷进来即可
    ├── plugin.json
    ├── skills/
    └── mcp.json

三点实操提醒：① 安装市场插件前务必看清来源和作者——插件里的 MCP Server 会在你本机执行代码；② 各家对 stdio / StreamableHTTP 等传输方式支持不完全一致，跨端跑不动时先查传输兼容；③ 规范正文还标着「工作草案（Working Draft）」，别把 1.0.0 当成最终盖章版，留意后续版本更新。