Claude Code插件生态全实战：从发现到发布

┌─────────────────────────────────────────────────┐
│                  Plugin（插件）                    │
│  一个可分发的扩展包，是最大粒度的封装单元            │
│                                                   │
│  ┌──────────┐ ┌──────────┐ ┌──────────────────┐ │
│  │  Skills   │ │  Agents  │ │   MCP Servers    │ │
│  │ (能力)    │ │ (子代理)  │ │   (工具集成)      │ │
│  └──────────┘ └──────────┘ └──────────────────┘ │
│                                                   │
│  ┌──────────┐ ┌──────────────────────────────┐  │
│  │  Hooks   │ │    Commands (遗留格式)        │  │
│  │ (事件)   │ │    斜杠命令                    │  │
│  └──────────┘ └──────────────────────────────┘  │
└─────────────────────────────────────────────────┘

graph TB
    subgraph "Anthropic Official"
        A[claude-plugins-official<br/>官方插件目录]
    end

    subgraph "Community"
        B[Third-party Marketplaces<br/>社区市场]
        C[Private Marketplaces<br/>私有机房]
    end

    subgraph "Claude Code Client"
        D[/plugin install]
        E[/plugin discover]
        F[/plugin marketplace]
        G[~/.claude/plugins/]
    end

    A --> D
    B --> D
    C --> D
    D --> G
    E --> A
    E --> B
    F --> A
    F --> B
    F --> C

    subgraph "Plugin Components"
        H[Skills]
        I[Agents]
        J[Hooks]
        K[MCP Servers]
    end

    G --> H
    G --> I
    G --> J
    G --> K

claude-plugins-official/
├── plugins/              # Anthropic 官方维护的插件
│   └── example-plugin/
├── external_plugins/     # 社区提交的第三方插件
│   └── .../
├── README.md
└── LICENSE

# 浏览可用插件（交互式）
/plugin discover

# 安装指定插件
/plugin install {plugin-name}@claude-plugins-official

# 示例：安装官方示例插件
/plugin install example-plugin@claude-plugins-official

# 列出已安装插件
/plugin list

# 更新指定插件
/plugin update example-plugin

# 更新整个 marketplace 索引
/plugin marketplace update claude-plugins-official

# 卸载插件
/plugin uninstall example-plugin

# 1. 查看插件是否出现在列表中
/plugin list

# 2. 查看新增的斜杠命令
/help

# 3. 检查 MCP 服务是否启动
# Claude Code 会自动加载插件中的 .mcp.json 配置

my-plugin/
├── .claude-plugin/
│   └── plugin.json          # 插件元数据（必须）
├── .mcp.json                # MCP 服务配置（可选）
├── skills/                  # 技能定义
│   ├── code-review/
│   │   └── SKILL.md
│   └── deploy/
│       └── SKILL.md
├── agents/                  # 代理定义
│   └── test-runner.md
├── hooks/                   # 事件钩子
│   └── post-commit.sh
├── commands/                # 遗留斜杠命令格式
│   └── legacy-cmd.md
└── README.md                # 文档

{
  "name": "my-deploy-plugin",
  "description": "一键部署到多环境的CI/CD插件，支持蓝绿部署和金丝雀发布",
  "version": "1.2.0",
  "author": {
    "name": "张三",
    "email": "[email protected]"
  },
  "homepage": "https://github.com/zhangsan/claude-deploy-plugin",
  "license": "MIT",
  "keywords": ["deploy", "ci-cd", "devops"],
  "requires": {
    "claude-code": ">=1.0.55"
  },
  "permissions": [
    "bash:execute",
    "file:read",
    "file:write",
    "network:outbound"
  ]
}

---
name: smart-test-gen
description: 当用户编写新函数或修改现有函数时，自动生成对应的单元测试
version: 1.0.0
---

# 智能测试生成

## 触发条件
当检测到以下场景时自动激活：
- 用户编写了新的函数或方法
- 用户修改了现有函数的签名或逻辑
- 用户明确要求生成测试

## 执行步骤
1. 分析目标函数的输入输出类型
2. 识别边界条件和异常路径
3. 生成覆盖以下场景的测试用例...

---
name: deploy
description: 部署当前项目到指定环境
argument-hint: <environment> [--canary] [--rollback]
allowed-tools: [Bash, Read, Glob, Grep]
---

# 部署命令

## 使用方式
/deploy staging          # 部署到预发布环境
/deploy production       # 部署到生产环境
/deploy production --canary  # 金丝雀发布

## 执行流程
1. 检查当前分支和 Git 状态...

{
  "my-database-tool": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "mcp-server-postgres", "postgresql://localhost/mydb"]
  },
  "my-api-tool": {
    "type": "http",
    "url": "https://api.example.com/mcp"
  }
}

#!/bin/bash
# hooks/post-commit.sh
# 每次 Git commit 后自动运行测试

echo "Running post-commit checks..."
npm test -- --coverage
if [ $? -ne 0 ]; then
  echo "⚠️ Tests failed! Consider fixing before pushing."
fi

# 创建插件目录
mkdir -p code-review-pro/.claude-plugin
mkdir -p code-review-pro/skills/auto-review
mkdir -p code-review-pro/skills/review-command
mkdir -p code-review-pro/hooks

cd code-review-pro
git init

{
  "name": "code-review-pro",
  "description": "智能代码审查插件，支持自动审查、差异审查和PR审查",
  "version": "1.0.0",
  "author": {
    "name": "Your Name",
    "email": "[email protected]"
  },
  "homepage": "https://github.com/you/code-review-pro",
  "license": "MIT",
  "keywords": ["review", "code-quality", "pr-review"],
  "requires": {
    "claude-code": ">=1.0.55"
  }
}

---
name: auto-review
description: 当用户完成代码编辑并准备提交时，自动触发代码审查建议
version: 1.0.0
---

# 自动代码审查

## 触发条件
当检测到用户执行以下操作时激活：
- 用户准备 git commit
- 用户明确说"帮我审查代码"
- 用户完成一段较长的代码编辑

## 审查维度

### 1. 安全性检查
- SQL 注入风险
- XSS 漏洞
- 敏感信息泄露（硬编码密钥、token）
- 不安全的反序列化

### 2. 代码质量
- 函数复杂度（圈复杂度 > 10 标记为警告）
- 重复代码检测
- 命名规范一致性
- 未使用的导入和变量

### 3. 性能
- N+1 查询模式
- 不必要的同步操作
- 大循环内的内存分配
- 缺少索引的数据库查询

### 4. 错误处理
- 未捕获的异常
- 空值检查缺失
- 错误信息过于笼统

## 输出格式
使用以下标记分级：
- 🔴 CRITICAL：必须修复，存在安全或正确性问题
- 🟡 WARNING：建议修复，影响可维护性或性能
- 🔵 INFO：优化建议，不影响功能正确性

---
name: review
description: 对指定文件或Git差异执行深度代码审查
argument-hint: <file-path | --diff | --staged> [--focus security|performance|all]
allowed-tools: [Read, Glob, Grep, Bash]
---

# 代码审查命令

## 使用方式
/review src/auth/login.ts                  # 审查指定文件
/review --diff                             # 审查当前未暂存的修改
/review --staged                           # 审查已暂存的修改
/review --diff --focus security            # 仅审查安全相关问题
/review --staged --focus performance       # 仅审查性能问题

## 执行流程

### 当参数为文件路径时
1. 读取目标文件完整内容
2. 识别文件类型和使用的框架
3. 按审查维度逐一分析
4. 生成结构化审查报告

### 当参数为 --diff 或 --staged 时
1. 运行 `git diff` 或 `git diff --staged` 获取变更
2. 逐个文件分析变更内容
3. 重点关注新增和修改的代码
4. 生成差异审查报告

### 当指定 --focus 时
仅输出对应维度的审查结果，跳过其他维度

## 输出格式

#!/bin/bash
# pre-commit hook: 在用户执行 git commit 前触发

echo "🔍 Running code review pre-commit check..."

# 获取暂存文件列表
STAGED_FILES=$(git diff --cached --name-only --diff-filter=ACM | grep -E '\.(ts|tsx|js|jsx|py|rs|go)$')

if [ -z "$STAGED_FILES" ]; then
  echo "No source files to review."
  exit 0
fi

# 检查明显的安全问题
for FILE in $STAGED_FILES; do
  # 检查硬编码密钥
  if grep -nE '(password|secret|api_key|token)\s*=\s*["\x27][^"\x27]{8,}' "$FILE" 2>/dev/null; then
    echo "🔴 CRITICAL: Potential hardcoded secret in $FILE"
    exit 1
  fi

  # 检查调试代码
  if grep -nE '(console\.log|print\(|dbg!)' "$FILE" 2>/dev/null; then
    echo "🟡 WARNING: Debug statement found in $FILE"
  fi
done

echo "✅ Pre-commit checks passed."

# Code Review Pro

智能代码审查插件 for Claude Code。

## 功能
- 🤖 自动代码审查：编辑完成后自动触发
- 📋 差异审查：审查 Git 暂存或未暂存的修改
- 🔒 安全聚焦：专门检查安全漏洞
- ⚡ 性能聚焦：识别性能瓶颈
- 🪝 Pre-commit Hook：提交前自动检查

## 安装
/plugin install code-review-pro@your-marketplace

## 使用
- 编辑代码后，审查建议自动出现
- `/review <file>` - 审查指定文件
- `/review --staged` - 审查暂存修改
- `/review --diff --focus security` - 安全审查

## 配置
无需额外配置，安装即用。

code-review-pro/
├── .claude-plugin/
│   └── plugin.json              # 插件元数据
├── skills/
│   ├── auto-review/
│   │   └── SKILL.md             # 自动审查能力
│   └── review-command/
│       └── SKILL.md             # /review 斜杠命令
├── hooks/
│   └── pre-commit.sh            # 提交前钩子
└── README.md                    # 文档

flowchart LR
    A[准备插件代码] --> B[自测验证]
    B --> C[提交表单]
    C --> D{Anthropic 审核}
    D -->|通过| E[合并到官方目录]
    D -->|驳回| F[根据反馈修改]
    F --> C
    E --> G[用户可搜索安装]

# 创建 marketplace 仓库
mkdir my-team-marketplace
cd my-team-marketplace
git init

# 创建索引文件
cat > marketplace.json << 'INDEXEOF'
{
  "name": "my-team-marketplace",
  "description": "团队内部插件市场",
  "plugins": [
    {
      "name": "code-review-pro",
      "version": "1.0.0",
      "description": "智能代码审查插件",
      "path": "plugins/code-review-pro"
    }
  ]
}
INDEXEOF

# 复制插件到 marketplace
mkdir -p plugins
cp -r ../code-review-pro plugins/

# 提交并推送到内部 Git
git add .
git commit -m "Initial marketplace with code-review-pro"
git remote add origin [email protected]:your-org/my-team-marketplace.git
git push -u origin main

# 在 Claude Code 中添加私有 marketplace
/plugin marketplace add your-org/my-team-marketplace

# 浏览可用插件
/plugin discover

# 安装
/plugin install code-review-pro@my-team-marketplace

# 1. 更新 plugin.json 中的 version
# 2. 更新 marketplace.json 中的版本号
# 3. 推送更新
git add .
git commit -m "Update code-review-pro to v1.1.0"
git push

# 用户侧更新
/plugin marketplace update my-team-marketplace
/plugin update code-review-pro

{
  "name": "marketplace-name",
  "description": "市场描述",
  "homepage": "https://github.com/org/marketplace",
  "plugins": [
    {
      "name": "plugin-name",
      "version": "1.0.0",
      "description": "插件描述",
      "path": "plugins/plugin-name",
      "author": "Author Name",
      "tags": ["tag1", "tag2"]
    }
  ]
}

graph TB
    subgraph "fullstack-dev-kit Plugin"
        A[plugin.json]

        subgraph "Skills"
            B[component-gen<br/>组件生成器]
            C[api-gen<br/>API生成器]
            D[db-migrate<br/>数据库迁移]
        end

        subgraph "MCP Servers"
            E[db-tools<br/>PostgreSQL工具]
            F[api-docs<br/>OpenAPI文档服务]
        end

        subgraph "Hooks"
            G[pre-push<br/>推送前检查]
        end
    end

    B --> E
    C --> F
    D --> E

    style A fill:#e1f5fe
    style B fill:#c8e6c9
    style C fill:#c8e6c9
    style D fill:#c8e6c9
    style E fill:#fff9c4
    style F fill:#fff9c4
    style G fill:#ffccbc

# 只需要读文件的审查命令
allowed-tools: [Read, Glob, Grep]

# 需要执行命令的部署命令
allowed-tools: [Bash, Read, Glob, Grep]

{
  "version": "2.1.0",
  "requires": {
    "claude-code": ">=1.0.55"
  }
}

# 启动 Claude Code 时查看详细日志
claude --debug

# 查看已安装插件列表和状态
/plugin list --verbose

# 确保 hook 脚本有执行权限
chmod +x hooks/pre-commit.sh

# 重启 Claude Code
# 退出当前会话，重新启动
claude

# 强制刷新 marketplace 索引
/plugin marketplace update <marketplace-name>

# 方法一：直接引用本地路径（适用于 Claude Code 支持的场景）
/plugin install /path/to/my-plugin

# 方法二：通过本地 marketplace 测试
# 1. 创建本地 marketplace 仓库
# 2. 将插件放入 plugins/ 目录
# 3. 注册本地 marketplace
/plugin marketplace add /path/to/my-team-marketplace

flowchart TD
    A[确定需求] --> B{功能类型?}

    B -->|简单能力| C[创建 SKILL.md]
    B -->|多组件集成| D[创建 Plugin]

    C --> E[放入 ~/.claude/skills/]
    E --> F[直接使用]

    D --> G[编写 plugin.json]
    G --> H[编写 Skills/Agents/Hooks]
    H --> I[本地测试]

    I --> J{发布目标?}
    J -->|官方目录| K[提交 Anthropic 审核]
    J -->|团队共享| L[创建私有 Marketplace]
    J -->|开源社区| M[发布到 GitHub Marketplace]

    K --> N[审核通过后上线]
    L --> O[团队 /plugin install]
    M --> P[社区 /plugin install]

    style A fill:#e3f2fd
    style F fill:#c8e6c9
    style N fill:#c8e6c9
    style O fill:#c8e6c9
    style P fill:#c8e6c9