如果你以为 `cursor/plugins` 又是一个「主题 / 代码片段」收集仓库，那就看走眼了。这是 **Cursor 把"插件"这个词重新定义了一遍** 的地方——它开源的不是一堆扩展，而是一整套**代理插件规范（plugin specification）**，外加 112 个官方/第三方插件作为活样例。仓库全名就叫 "Cursor plugin specification and official plugins"。

它最反直觉的地方有两处：第一，这里的"插件"几乎不是 UI 控件，而是 **MCP 连接器 + Agent 技能包**；第二，这套格式从第一行就**不是给 Cursor 独占的**——同一份目录结构，换一个 `.claude-plugin/` 清单就能直接喂给 Claude Code。

下面全部基于一手源码，并且我**真的跑了仓库自带的校验器**。

## 先看数字：这不是小打小闹

| 指标 | 值 |
|:-----|:---|
| Star | 12,785 |
| Fork | 1,258 |
| 主语言 | TypeScript |
| 协议 | MIT |
| 创建 | 2026-01-23 |
| 最近提交 | 2026-10-19 |
| Cursor 插件清单数 | **112** |
| `SKILL.md` 总数 | **167** |

仓库根目录是 `.cursor-plugin/marketplace.json`（市场清单），下面每个插件是一个独立目录，各自带一份 `.cursor-plugin/plugin.json`。读起来像一份"插件市场白皮书 + 实现"。

## 核心：一份被 JSON Schema 钉死的 plugin.json

整个规范的心脏是 `schemas/plugin.schema.json`（Draft-07）。它规定了插件长什么样，而且**非常严格**：

```json
{
  "type": "object",
  "required": ["name"],
  "additionalProperties": false,
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "pattern": "^[a-z0-9]([a-z0-9.-]*[a-z0-9])?$"
    },
    "skills":   { "$ref": "#/$defs/stringOrStringArray" },
    "rules":    { "$ref": "#/$defs/stringOrStringArray" },
    "agents":   { "$ref": "#/$defs/stringOrStringArray" },
    "commands": { "$ref": "#/$defs/stringOrStringArray" },
    "hooks":    { "oneOf": [ { "type": "string" }, { "type": "object" } ] },
    "mcpServers": { "$ref": "#/$defs/mcpServers" },
    "variables": { "type": "object", "required": ["type"] },
    "minClientVersions": { "$ref": "#/$defs/minClientVersions" }
  }
}
```

两个细节值得注意：

1. **`additionalProperties: false`**。任何不在白名单里的字段都会被判非法——你没法偷偷塞一个 `secretApiKey` 字段进去。这和很多"宽松 JSON 配置"的基调完全相反。
2. **`name` 被正则锁死为 kebab-case**：`^[a-z0-9]([a-z0-9.-]*[a-z0-9])?$`。小写字母数字 + 连字符 + 点号，且首尾不能是符号。这正是后面"校验器能核对 name==目录名"的基础。

一份最小可用的插件清单大概长这样（取自 `create-plugin` 脚手架的示例）：

```json
{
  "name": "create-plugin",
  "displayName": "Create Plugin",
  "version": "1.0.0",
  "description": "Scaffold and validate new agent plugins.",
  "author": { "name": "Cursor", "email": "plugins@cursor.com" },
  "license": "MIT",
  "category": "developer-tools",
  "skills": "./skills/",
  "rules": "./rules/",
  "agents": "./agents/"
}
```

## 插件由"六件套"组成，但主角只有两个

规范允许挂载这些组件：

- **skills** —— Agent 技能（`SKILL.md`，用的是开放 Agent Skills 标准的前置信息 `name`/`description`）
- **rules** —— Cursor 规则（`.mdc` 文件，带 `description` 和 `alwaysApply` 等前置信息）
- **agents** —— 子代理定义
- **commands** —— 斜杠命令
- **hooks** —— 生命周期钩子（`hooks.json`）
- **mcpServers** —— MCP 服务器配置

我对 112 份真实清单做了一次统计，结论很说明问题：

| 组件 | 声明它的插件数 |
|:-----|:--------------|
| `mcpServers` | **89** |
| `skills` | 24（对应 167 个 `SKILL.md`） |
| `agents` | 8 |
| `rules` | 3 |
| `hooks` | 3 |
| `variables` | 14 |
| `commands` | 0 |

**89 / 112 的插件本质是"把某个 SaaS 的 MCP 服务器打包进来"。** 从 Gmail、Google Drive、Salesforce、GitHub、Slack、Zoom，到 Coinbase、Robinhood、Interactive Brokers——第三方集成几乎全是"声明一个 `mcpServers`，再配几段技能说明怎么用"。这与传统编辑器的"UI 扩展"叙事彻底脱钩：Cursor 插件搬运的是**能力**，不是界面。

顺带一提，`commands` 字段规范允许，但 112 个插件里**一个都没用**——目前插件一律走 skills/agents 入口。

### Skills 是用开放标准写的，Cursor 只加了少量扩展

`SKILL.md` 的前置信息仍是开放 Agent Skills 标准的 `name` + `description`。Cursor 在其上加了少量自有键，比如 `disable-model-invocation: true`（禁止模型在无用户触发时自动调用该技能）。下面是 `thermos` 插件里一个真实技能的头部：

```markdown
---
name: thermos
description: "Launch both thermo-nuclear review subagents in parallel, then synthesize their findings. Use for thermos, double thermo review, or combined bug/security and code-quality branch audits."
disable-model-invocation: true
---

# Thermos

Run the two thermo review passes as async background subagents in parallel, then synthesize their results.
```

换句话说，你在 Anthropic 生态、K-Dense-AI 的 scientific-agent-skills 里见过的同一套技能格式，在这里能直接复用——这是 Cursor 押注"开放代理插件层"而非私有格式的一个信号。

## 反直觉点①：MCP 才是默认，UI 不是

传统 IDE 插件=往编辑器里塞面板、按钮、视图。这里的默认心智模型是：**插件 = 一组能被 Agent 调用的工具（MCP）+ 一组教 Agent 怎么用的技能（skills/rules）+ 可选子代理**。连 `pstack` 这种"工程师工作流"插件，也是把几十条 `principle-*` 技能（根因优先、类型系统纪律、先减后加……）和一组 agents 打包，全程没有一个新面板。

## 反直觉点②：一份代码，瞄准多个 AI 客户端

规范里有个 `minClientVersions` 字段，键名是 `cursor` / `grokbot` / `sand`（后者是 Grok Bot 的废弃别名），值可以是一个语义版本号，也可以是字面量 `"never"`——意味着"对某个客户端彻底隐藏这个插件"。例如 `hunter` 插件要求：

```json
{
  "name": "hunter",
  "minClientVersions": { "cursor": "3.13.0" }
}
```

而仓库根目录**同时存在**两套市场清单：

- `.cursor-plugin/marketplace.json` —— 112 个插件
- `.claude-plugin/marketplace.json` —— 目前只有 2 个：`origin-apps` 和 `harness/pstack/claude-code`（pstack 的手工 Claude Code 移植版）

所以结论很清楚：**格式层面是客户端无关的**，同一份 `skills/` + `mcpServers` 几乎不用改就能挂到 Claude Code 下。`create-plugin` 的脚手架甚至把"本地安装路径"默认写成 `~/.cursor/plugins/local/<plugin-name>/`，装完立即生效。

不过要诚实：跨客户端目前仍是**早期**。112 个插件里，真正在插件目录级别带 `.claude-plugin/plugin.json` 的只有 `origin-apps` 一个；Claude 市场里的 pstack 是放在 `harness/` 下单独手工移植的。所以"一份代码喂多个客户端"在规范上已经打通，在规模化落地上才刚起步。

## 验证是一等公民：自带 Ajv 校验器，我真的跑了

仓库不是"文档说要严格"，而是**把严格做成了可执行脚本**：`scripts/validate-plugins.mjs` 用 Ajv + ajv-formats 干四件事：

1. 校验根 `.cursor-plugin/marketplace.json` 符合 `marketplace.schema.json`；
2. 逐个校验 112 份 `plugin.json` 符合 `plugin.schema.json`；
3. 核对 **marketplace 里的 name == 插件 `plugin.json` 的 name == 目录名**；
4. 核对同一插件若有多份清单（`.cursor-plugin/`、`.claude-plugin/`、`plugin.json`），**版本号必须一致**。

我在本地装好 `ajv`/`ajv-formats` 后真实执行了它：

```bash
node scripts/validate-plugins.mjs
# → All plugins validated successfully.   (exit 0)
```

**112 份清单 + 两份市场清单全部通过**。这比"我看了一遍 JSON"有力得多：它证明规范不是纸面约束，而是 CI 真会拦的硬门槛。

## 造一个插件：create-plugin 元工具

仓库自带 `create-plugin` 元插件，安装方式是约定俗成的：

```bash
/add-plugin create-plugin
```

它提供 `/create-plugin`（脚手架，生成 `plugin.json` + 组件目录）、`review-plugin-submission`（发布前质量门）和 `plugin-architect` 子代理。质量门里明确列了要查的清单：manifest 存在且合法、`name` 是合法 kebab-case、skills 在 `skills/*/SKILL.md`、rules 在 `rules/`、MCP 配置在 `mcp.json`、README 写清用途与安装……基本就是把上面那套 schema 翻译成了人话。

## 实跑证据（诚实三档）

- ✅ **规范一致性**：在 macOS 上用仓库自带 `validate-plugins.mjs`（Ajv）校验全部 112 份 `plugin.json` + 双市场清单，输出 `All plugins validated successfully.`，退出码 0。
- ✅ **格式可读**：直接读取 `schemas/*.json`、`marketplace.json`、多个 `plugin.json`、`SKILL.md`、`.mdc` 规则，确认 `additionalProperties:false` / kebab-case 正则 / 开放技能标准等描述属实。
- ⚠️ **未验证**：没有真实 Cursor / Claude Code 客户端，因此"安装进客户端并实际触发技能/MCP"这一步没做；跨客户端落地程度仅靠清单文件统计（Claude 市场目前 2 个插件），未做端到端联调。

## 结语：它赌的是"开放代理插件层"

`cursor/plugins` 的价值不在"又一个示例集合"，而在它把"给 AI 编辑器装能力"这件事，**从私有扩展模型改成了一份可被 schema 校验、可被多个客户端共享的开放包格式**。技能复用开放 Agent Skills 标准、`mcpServers` 让 SaaS 连接变成声明式、校验器把规范变成硬门槛——这套组合拳指向一个判断：未来编辑器的"插件"，拼的是**Agent 能调用的工具和知识**，界面上的按钮多少会退居其次。

只是眼下，112 个插件里绝大多数仍是 Cursor 独占、且以 MCP 连接器为主；通往 Claude Code 的桥刚搭了两根桩。规范已经就位，生态才刚起跑。

> 本文所有结论均来自 `cursor/plugins` 仓库一手源码（commit `6b78e9f`，main 分支），检索与实跑日期 2026-10-18。


如果你以为 cursor/plugins 又是一个「主题 / 代码片段」收集仓库，那就看走眼了。这是 Cursor 把"插件"这个词重新定义了一遍 的地方——它开源的不是一堆扩展，而是一整套代理插件规范（plugin specification），外加 112 个官方/第三方插件作为活样例。仓库全名就叫 "Cursor plugin specification and official plugins"。

1.3 万 star 的 cursor/plugins：一份 plugin.json 凭什么同时喂饱 Cursor 和 Claude Code？

如果你以为 cursor/plugins 又是一个「主题 / 代码片段」收集仓库，那就看走眼了。这是 Cursor 把"插件"这个词重新定义了一遍 的地方——它开源的不是一堆扩展，而是一整套代理插件规范（plugin specificat…

软件研发

人工智能

Cursor开源112个MCP连接器插件规范，重新定义AI编辑器插件为Agent技能包而非UI控件，支持Claude Code跨客户端复用。

代码解释

TypeScript 

服务器

GitHub

MacOS

Agent

SaaS

JSON

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

1.3 万 star 的 cursor/plugins：一份 plugin.json 凭什么同时喂饱 Cursor 和 Claude Code？-腾讯云开发者社区-腾讯云

1.3 万 star 的 cursor/plugins：一份 plugin.json 凭什么同时喂饱 Cursor 和 Claude Code？

1.3 万 star 的 cursor/plugins：一份 plugin.json 凭什么同时喂饱 Cursor 和 Claude Code？

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐