Plugins

Plugins 把 rules、skills、agents、commands、MCP servers 和 hooks 打包成可分發 bundle。官方文件說明：官方 plugins 在 Cursor Marketplace 瀏覽，社群 plugins 和 MCP servers 可以看 cursor.directory，也可以自己構建。

1. Plugin 可以包含什麼

官方列出的元件：

flowchart TD
  Plugin["Plugin bundle"] --> Rules["Rules"]
  Plugin --> Skills["Skills"]
  Plugin --> Agents["Agents"]
  Plugin --> Commands["Commands"]
  Plugin --> MCP["MCP servers"]
  Plugin --> Hooks["Hooks"]
  Plugin --> Marketplace["Marketplace / team distribution"]

Plugin 的價值是“分發一組能力”，不是給單個專案堆功能。如果只是當前 repo 的一條規則，Project Rule 就夠；如果一組能力要跨團隊複用，再考慮 plugin。

2. Marketplace 和安全審查

官方資料說明：

• Plugins 以 Git repositories 分發。
• 官方 Marketplace plugins 由 Cursor team 接收提交。
• 每個 plugin 上架前都會 manual review。
• 每次更新也會重新 review。
• 官方 Marketplace 在 cursor.com/marketplace。
• 社群 plugins 和 MCP servers 可看 cursor.directory。

這不等於你可以不審。Plugin 可能包含 MCP、hooks、commands，這些都會改變 Agent 能力邊界。

3. Team marketplaces

Team marketplaces 適用於 Teams 和 Enterprise plans。

Enterprise plan 中，只有 admins 可以從 Dashboard -> Settings -> Plugins 新增 team marketplaces。

匯入流程：

1. 進入 Dashboard -> Settings -> Plugins。
2. 在 Team Marketplaces 點選 Import。
3. 貼上 GitHub repository URL。
4. Review parsed plugins，可選設定 Team Access groups。
5. 設定 marketplace name 和 description，然後儲存。

4. Required 和 Optional

把 plugin 分配到 distribution group 時，可以設為 required 或 optional。

Distribution groups 可以由 SCIM-synced directory groups 控制。如果組織使用 SCIM（System for Cross-domain Identity Management，跨域身份同步標準），group membership 在 identity provider 中管理，Cursor 同步更新。

5. 安裝和管理

Plugins 可以 project scoped 或 user level 安裝。

管理入口：

如果 MCP server 被關閉，它不會 load，也不會出現在 chat 中。

6. 建立 Plugin

Plugin 是一個帶 .cursor-plugin/plugin.json manifest 的目錄。官方示例：

my-plugin/
├── .cursor-plugin/
│   └── plugin.json
├── rules/
│   └── coding-standards.mdc
├── skills/
│   └── code-reviewer/
│       └── SKILL.md
└── mcp.json

Manifest 只要求 name 欄位。元件會從預設目錄自動發現，也可以在 manifest 裡指定 custom paths。

{
  "name": "my-plugin",
  "description": "Custom development tools",
  "version": "1.0.0",
  "author": { "name": "Your Name" }
}

7. 本地測試和釋出

釋出前，把 plugin 放到本地目錄測試：

1. 建立 ~/.cursor/plugins/local/my-plugin。
2. 複製 plugin files，確認 .cursor-plugin/plugin.json 在 plugin root。
3. Restart Cursor，或執行 Developer: Reload Window。
4. 驗證 rules、skills、MCP servers 等 components 已 load。

為了更快迭代，可以 symlink：

ln -s /path/to/my-plugin ~/.cursor/plugins/local/my-plugin

準備好後，提交到 cursor.com/marketplace/publish。多 plugin repo 需要在 .cursor-plugin/marketplace.json 新增 marketplace manifest。

8. 驗收清單

上線或安裝 plugin 前檢查：

• 是否真的需要 plugin，而不是 project rule / skill。
• .cursor-plugin/plugin.json 是否在 root。
• 包含哪些 rules、skills、agents、commands、MCP servers、hooks。
• MCP 和 hooks 是否有許可權說明。
• 是否 open source，可審查。
• 是否經過 Marketplace 或團隊審查。
• Required plugin 的影響人群是否明確。
• Optional plugin 是否有安裝和解除安裝說明。
• 本地 ~/.cursor/plugins/local 已測試。
• 更新後是否重新 review。

本章自檢

完成本章後，用這 3 個問題檢查自己是否真正理解：

1. Plugin 和單個 Project Rule / Skill 的邊界是什麼？
2. Required plugin 和 Optional plugin 對團隊有什麼不同影響？
3. 為什麼包含 MCP servers 或 hooks 的 plugin 需要額外安全審查？

透過標準：你能判斷一個團隊能力包是否應該做成 plugin，並能列出安裝、測試、審查和分發路徑。

官方來源

• Cursor Plugins —— 官方說明 plugin 元件、Marketplace、team marketplace、安裝、管理、建立和本地測試。
• Cursor Help: Plugins —— Help Center 說明外掛組成、安裝、審查和入口。
• Marketplace Security —— 官方說明 Marketplace 審查和安全報告。
• Plugins Reference —— 官方 manifest schema、元件格式和提交清單。

接下來去哪