Claude Code 插件开发入门:一份给开发者的实践指南

my-plugin/├── .claude-plugin/│   └── plugin.json          # 插件清单（必须）├── commands/                # 命令文件（.md 格式）│   └── collect.md├── skills/                  # 技能目录│   └── code-review/│       └── SKILL.md├── agents/                  # 自定义智能体│   └── reviewer.md├── hooks/                   # 事件钩子│   └── hooks.json└── .mcp.json                # MCP 服务器配置（可选）

mkdir -p my-first-plugin/.claude-pluginmkdir -p my-first-plugin/commands

{  "name": "my-first-plugin",  "version": "1.0.0",  "description": "我的第一个 Claude Code 插件",  "author": {    "name": "Your Name"  }}

向用户打招呼，问候 $ARGUMENTS 并询问今天有什么需要帮助的。

# 用 --plugin-dir 加载本地插件，无需安装claude --plugin-dir ./my-first-plugin

/my-first-plugin:hello 张三

{  "name": "tech-content-collector",  "version": "1.0.0",  "description": "收集和整理技术内容",  "author": {    "name": "Lei Fu",    "email": "lei@example.com"  },  "commands": ["./commands/"],  "skills": ["./skills/"],  "homepage": "https://github.com/yourname/your-plugin"}

// ❌ author 不能是字符串"author": "Lei Fu"// ✅ author 必须是对象"author": { "name": "Lei Fu" }// ❌ commands 不能是对象数组"commands": [  { "name": "collect", "description": "..." }]// ✅ commands 必须是路径数组"commands": ["./commands/"]

---description: 审查代码质量和潜在问题。当用户提交代码审查请求或分析代码质量时使用。---审查代码时，请检查以下方面：1. 代码结构和组织2. 错误处理3. 安全隐患4. 测试覆盖率提供具体的改进建议和示例代码。

{  "hooks": {    "PostToolUse": [      {        "matcher": "Write|Edit",        "hooks": [          {            "type": "command",            "command": "echo '文件已修改' >> /tmp/claude-log.txt"          }        ]      }    ]  }}

my-marketplace/├── .claude-plugin/│   └── marketplace.json     # Marketplace 描述文件└── my-first-plugin/         # 插件目录    ├── .claude-plugin/    │   └── plugin.json    └── commands/

{  "name": "my-marketplace",  "owner": {    "name": "Lei Fu"  },  "plugins": [    {      "name": "my-first-plugin",      "source": "./my-first-plugin"    }  ]}

# 方式一：在 Claude Code 内添加/plugin marketplace add /path/to/my-marketplace# 方式二：命令行添加claude plugin marketplace add /path/to/my-marketplace# 安装插件（格式：插件名@marketplace名）/plugin install my-first-plugin@my-marketplace

# 加载多个插件同时测试claude --plugin-dir ./plugin-one --plugin-dir ./plugin-two# 热更新（修改文件后无需重启）/reload-plugins# 查看已配置的 marketplace/plugin marketplace list# 验证插件结构（需要最新版 Claude Code）claude plugin validate ./my-plugin

---name: Code Reviewer Agentdescription: 一个专门负责代码审查的智能体。当被激活时，它会遵循严格的审查流程，并使用 code-review 技能来分析代码。---# 角色设定你是一个经验丰富的代码审查专家。你的目标是保证代码库的质量、可读性和安全性。# 工作流程1.  **理解需求**：首先，向用户询问本次代码提交的背景和目的。2.  **执行审查**：调用 `code-review` 技能来分析代码。3.  **总结报告**：基于技能的输出，整理一份清晰、完整的审查报告，包括优点、问题和修改建议。4.  **提供示例**：对关键的修改建议，提供具体的代码示例。

{  // 定义该 MCP 服务的命名空间  "namespace": "external_apis",  // 列出所有可用的外部服务  "services": [    {      // 服务名称，用于在 Claude Code 中调用      "name": "get_weather",      // 服务的描述，帮助 Claude 理解其功能      "description": "获取指定城市的实时天气",      // 定义 API 的具体细节      "endpoint": {        // 外部 API 的 URL，使用 {city} 作为参数占位符        "url": "https://api.weather.com/v1/current?city={city}",        // HTTP 请求方法        "method": "GET",        // 定义参数        "parameters": [          {            "name": "city",            "in": "path", // 表示参数在 URL 路径中            "description": "The city to get the weather for",            "required": true,            "schema": {              "type": "string"            }          }        ],        // 如果 API 需要认证，可以在这里配置        "authentication": {          "type": "apiKey",          "name": "X-API-Key",          "in": "header",          // 密钥可以引用环境变量，避免硬编码          "value": "${WEATHER_API_KEY}"        }      }    }  ]}

```shell#!/bin/bash# 默认值ENVIRONMENT="staging"FORCE=false# 解析命令行参数while [[ "$#" -gt 0 ]]; do    case $1 in        --env) ENVIRONMENT="$2"; shift ;;        --force) FORCE=true ;;        *) echo "未知参数: $1"; exit 1 ;;    esac    shiftdoneecho "准备部署到环境: $ENVIRONMENT"if [ "$FORCE" = true ]; then    echo "执行强制部署..."    # ./deploy_script.sh --force --env $ENVIRONMENTelse    echo "执行标准部署..."    # ./deploy_script.sh --env $ENVIRONMENTfiecho "部署完成。"```

/my-plugin:deploy --env production --force

{  "hooks": {    "PostToolUse": [      {        "matcher": "Write",        "hooks": [          {            "type": "command",            "command": "env | grep CLAUDE_ > /tmp/claude_hook_env.log"          }        ]      }    ]  }}