create-claude-plugin

Create Claude Plugin 指南

该技能用于帮助用户创建 Claude Code 插件，即以打包形式集合技能、代理、命令、钩子和 MCP 服务器，并通过插件市场进行分发与共享。插件支持团队协作和社区分享 Claude Code 扩展。

快速开始

创建新插件时，可按以下流程进行：

定义用途：插件将提供哪些能力
选择组件：技能、代理、命令、钩子、MCP 服务器
创建结构：建立包含各组件的插件目录
配置市场：创建带元数据的 marketplace.json
本地测试：安装并验证插件正常工作
编写文档：撰写完整的 README
版本管理：使用语义化版本（1.0.0）
发布市场：通过 git 仓库或分发渠道共享

什么是插件

Claude Code 插件是打包的扩展集合，可提供：

技能（Skills）：基于上下文自动发现的能力
代理（Agents）：面向特定领域的专用 AI 助手
命令（Commands）：可复用的斜杠命令
钩子（Hooks）：事件驱动的自动化与格式化
MCP 服务器：外部服务集成

插件可用于团队共享、社区贡献、带版本的分发，以及将相关能力打包在一起。

插件结构

基本插件目录包含：

my-plugin/
├── .claude-plugin/
│   └── marketplace.json      # 插件元数据（必需）
├── skills/                   # Agent Skills（可选）
│   └── my-skill/
│       └── SKILL.md
├── agents/                   # 子代理（可选）
│   └── my-agent.md
├── commands/                 # 斜杠命令（可选）
│   └── my-command.md
├── hooks/                    # 事件处理器（可选）
│   └── hooks.json
├── mcp/                      # MCP 服务器配置（可选）
│   └── .mcp.json
├── README.md                 # 文档（推荐）
├── LICENSE.txt               # 许可证信息（推荐）
└── THIRD_PARTY_NOTICES.md   # 第三方归属（如适用）

最小插件只需要 .claude-plugin/marketplace.json。

市场配置（marketplace.json）

基本格式示例：

{
  "name": "my-plugin-marketplace",
  "owner": {
    "name": "Your Name",
    "email": "you@example.com"
  },
  "metadata": {
    "description": "Brief marketplace description",
    "version": "1.0.0"
  },
  "plugins": [
    {
      "name": "my-plugin",
      "description": "What this plugin does",
      "source": "./",
      "strict": false,
      "skills": [
        "./skills/my-skill"
      ]
    }
  ]
}

字段说明：

市场层级：

name（必需）：唯一市场标识（小写、连字符）
owner（必需）：所有者信息，含 name 和 email
metadata（必需）：市场描述和版本

插件层级：

name（必需）：插件标识，出现在 /plugin list 中
description（必需）：插件提供的功能（向用户展示）
source（必需）：插件根目录（通常为 ./）
strict（可选）：严格校验模式，默认 false
skills（可选）：技能目录路径数组
agents（可选）：代理文件路径数组
commands（可选）：命令文件路径数组
hooks（可选）：钩子配置路径
mcp（可选）：MCP 配置路径

组件集成

插件可包含技能、代理、命令、钩子和 MCP 服务器。以技能为例，目录结构为 skills/ 下放置各技能子目录，每个技能包含 SKILL.md（可含 scripts、templates 等）。代理放在 agents/ 下，为 Markdown 文件。命令放在 commands/ 下，支持子目录。钩子通过 hooks/hooks.json 配置，例如可在 PostToolUse 时对编辑文件运行格式化命令。MCP 服务器通过 mcp/.mcp.json 配置，支持 http 和 stdio 两种类型。以上各类组件均需在 marketplace.json 中以对应字段（skills、agents、commands、hooks、mcp）引用其路径。资料中还提供了文档处理套件、全栈开发工具包、安全审计插件等完整示例，展示多组件组合配置方式。

本地测试

设置测试环境的基本步骤：

创建测试市场目录：mkdir -p ~/test-marketplace/my-plugin
创建插件结构：mkdir -p .claude-plugin skills/test-skill
创建 marketplace.json
创建测试技能 SKILL.md

安装插件：

# 在 Claude Code 中
/plugin marketplace add ~/test-marketplace/my-plugin
/plugin install test-plugin@test-marketplace
/plugin list

应显示：test-plugin@test-marketplace (enabled)。

测试各组件时，可重启 Claude Code 验证技能触发，用 /agents 查看代理，输入斜杠命令验证命令，触发钩子事件验证钩子执行。更新插件时先卸载再重装并重启 Claude Code 测试。

文档最佳实践

README 模板包含插件名称、简述、功能列表、安装方式（通过插件市场或本地安装）、用法（技能、代理、命令示例）以及配置说明（如环境变量）。

适用场景与限制

该技能适用于分发多个相关能力、团队标准化、社区分享、带版本的能力管理以及复杂的多组件工作流。对于个人效率工具、项目特定定制、快速原型和一次性工具，使用单独组件更合适。资料中未提供收费、价格等商业信息。

技能介绍