Plugin Creator

将分散的 Claude Code 组件整合为标准的可分发插件。

概述

此技能帮助用户将现有的 skills、agents、commands、hooks、MCP 服务器配置等组件，按照 Claude Code 插件规范组织成完整的插件结构，便于团队共享和社区分发。

工作流程

用户提供组件 → 分析与验证 → 规划结构 → 创建插件 → 验证完整性

步骤 1：收集用户组件

首先明确用户提供的组件类型和位置：

组件类型	标识	来源位置
Skills	`skills/`	包含 SKILL.md 的目录
Agents	`agents/*.md`	YAML frontmatter 配置文件
Commands	`commands/*.md`	斜杠命令定义
Hooks	`hooks.json` 或 `settings.json`	钩子配置
MCP	`.mcp.json`	MCP 服务器配置
LSP	`.lsp.json`	LSP 服务器配置
Settings	`settings.json`	默认设置

询问用户：

插件名称和描述
各组件的源路径
是否需要创建新的组件

步骤 2：规划插件结构

基于收集的组件，规划目标结构：

plugin-name/
├── .claude-plugin/
│   └── plugin.json          # 必需：插件元数据
├── commands/                # 可选：斜杠命令
├── agents/                  # 可选：代理定义
├── skills/                  # 可选：技能
│   └── skill-name/
│       └── SKILL.md
├── hooks/                   # 可选：钩子
│   └── hooks.json
├── .mcp.json                # 可选：MCP 配置
├── .lsp.json                # 可选：LSP 配置
├── settings.json            # 可选：默认设置
└── README.md                # 推荐：使用文档

步骤 3：创建插件清单

生成 plugin.json：

{
  "name": "plugin-name",
  "version": "1.0.0",
  "description": "插件功能描述",
  "author": "作者名称"
}

命名规范：

使用小写字母和连字符
简洁且具有描述性
避免与现有插件冲突

步骤 4：迁移组件

按以下规则迁移各组件：

Skills 迁移

复制整个 skill 目录到 skills/
验证 SKILL.md 包含有效的 frontmatter
确保 name 和 description 字段完整

Agents 迁移

复制 .md 文件到 agents/
验证 YAML frontmatter 格式
确认 tools 和 model 配置正确

Commands 迁移

复制 .md 文件到 commands/
命令文件无需 frontmatter

Hooks 迁移

从 settings.json 提取钩子配置，转换为 hooks/hooks.json：

{
  "hooks": {
    "PreToolUse": [...],
    "PostToolUse": [...],
    "Notification": [...]
  }
}

MCP/LSP 迁移

直接复制 .mcp.json 和 .lsp.json 到插件根目录
检查路径引用是否需要调整

步骤 5：生成文档

创建 README.md，包含：

# Plugin Name

简短描述插件功能。

## 安装

```bash
claude /plugin install <plugin-path>

组件

Skills

skill-name: 技能描述

Commands

/command-name: 命令描述

Agents

agent-name: 代理描述

使用示例

具体使用示例...

配置

可选配置说明...


### 步骤 6：验证插件

运行验证检查：

```bash
# 检查插件结构
claude --plugin-dir ./plugin-name --validate

验证清单：

plugin.json 存在且格式正确
所有 SKILL.md 包含有效 frontmatter
agents/*.md 格式正确
hooks.json 语法有效
MCP/LSP 配置路径正确
README.md 包含基本使用说明

组件格式规范

详细格式规范参见 references/plugin-spec.md。

SKILL.md 格式

---
name: skill-name
description: 触发条件和使用场景描述
---

技能指令内容...

Agent 格式

---
name: agent-name
description: 代理用途描述
tools: Read, Write, Edit, Grep, Glob, Bash
model: inherit
---

系统提示内容...

Hooks 格式

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": ["命令"]
      }
    ]
  }
}

常见问题

问题	解决方案
技能命名冲突	使用插件命名空间：`/plugin-name:skill-name`
路径引用错误	使用相对于插件根目录的路径
钩子不触发	检查 matcher 配置和命令可执行性
MCP 连接失败	验证命令路径和环境变量

输出

完成后输出：

插件目录结构概览
包含的组件清单
安装和测试命令
后续分发建议

plugin-creator