Claude Code 插件

本文件夹包含完整的插件（Plugin）示例，将多个 Claude Code 功能打包为可安装的内聚组件。

概述

Claude Code 插件是定制化功能的捆绑集合（斜杠命令、子代理、MCP 服务器和钩子），可通过单条命令安装。插件代表了最高层级的扩展机制——将多个功能组合为内聚的、可共享的包。

插件架构

graph TB
    A["插件"]
    B["斜杠命令"]
    C["子代理"]
    D["MCP 服务器"]
    E["钩子"]
    F["配置"]

    A -->|捆绑| B
    A -->|捆绑| C
    A -->|捆绑| D
    A -->|捆绑| E
    A -->|捆绑| F

插件加载流程

sequenceDiagram
    participant User as 用户
    participant Claude as Claude Code
    participant Plugin as 插件市场
    participant Install as 安装器
    participant SlashCmds as 斜杠命令
    participant Subagents as 子代理
    participant MCPServers as MCP 服务器
    participant Hooks as 钩子
    participant Tools as 已配置的工具

    User->>Claude: /plugin install pr-review
    Claude->>Plugin: 下载插件清单
    Plugin-->>Claude: 返回插件定义
    Claude->>Install: 提取组件
    Install->>SlashCmds: 配置
    Install->>Subagents: 配置
    Install->>MCPServers: 配置
    Install->>Hooks: 配置
    SlashCmds-->>Tools: 就绪
    Subagents-->>Tools: 就绪
    MCPServers-->>Tools: 就绪
    Hooks-->>Tools: 就绪
    Tools-->>Claude: 插件已安装 ✅

插件类型与分发

类型	范围	共享范围	权限方	示例
官方	全局	所有用户	Anthropic	PR 审查、安全指导
社区	公开	所有用户	社区	DevOps、数据科学
组织	内部	团队成员	公司	内部标准、工具
个人	个人	单个用户	开发者	自定义工作流

插件定义结构

插件清单使用 JSON 格式，位于 .claude-plugin/plugin.json：

{
  "name": "my-first-plugin",
  "description": "A greeting plugin",
  "version": "1.0.0",
  "author": {
    "name": "Your Name"
  },
  "homepage": "https://example.com",
  "repository": "https://github.com/user/repo",
  "license": "MIT"
}

插件结构示例

my-plugin/
├── .claude-plugin/
│   └── plugin.json       # 清单（名称、描述、版本、作者）
├── commands/             # 以 Markdown 文件形式定义的技能
│   ├── task-1.md
│   ├── task-2.md
│   └── workflows/
├── agents/               # 自定义代理定义
│   ├── specialist-1.md
│   ├── specialist-2.md
│   └── configs/
├── skills/               # 包含 SKILL.md 文件的代理技能
│   ├── skill-1.md
│   └── skill-2.md
├── hooks/                # hooks.json 中的事件处理器
│   └── hooks.json
├── .mcp.json             # MCP 服务器配置
├── .lsp.json             # LSP 服务器配置
├── settings.json         # 默认设置
├── templates/
│   └── issue-template.md
├── scripts/
│   ├── helper-1.sh
│   └── helper-2.py
├── docs/
│   ├── README.md
│   └── USAGE.md
└── tests/
    └── plugin.test.js