plugin-builder

Files (11)

• SKILL.md
• gitlab-integration.md · references/
• marketplace-json-schema.md · references/
• plugin-json-schema.md · references/
• skill-structure-guide.md · references/
• init_marketplace.py · scripts/
• validate_plugin.py · scripts/
• SKILL.md.tmpl · templates/
• agent.md.tmpl · templates/
• marketplace.json.tmpl · templates/
• plugin.json.tmpl · templates/

SKILL.md (first lines)

# Plugin Builder

帮助你创建和管理私有 Claude Code 插件的 skill。

## 工作流程

### 阶段1：捕获意图

首先了解用户的目标：

1. **创建新仓库** - 从零开始创建一个插件仓库
2. **迁移现有内容** - 将散落的 skills/agents 整理成仓库
3. **更新现有仓库** - 修改已存在的 marketplace 配置

询问用户：
- **托管平台**：GitHub 还是 GitLab（支持自托管 GitLab 实例）
- 仓库名称（如：`my-claude-plugins`）
- 用户名/命名空间（GitHub: username，GitLab: group/namespace）
- 要包含的组件类型（Skills/Agents/Commands/Hooks/MCP）
- 是否有现有内容需要迁移
- **私有仓库**：是否需要配置访问令牌

### 阶段2：规划结构

根据用户需求，规划仓库结构：

```
<repo-name>/
├── .claude-plugin/
│   ├── plugin.json        # 插件清单
│   └── marketplace.json   # 市场配置
├── skills/                # Skills 目录
├── agents/                # Agents 目录
├── commands/              # 斜杠命令目录
├── hooks/                 # 事件钩子
│   └── hooks.json
├── .mcp.json              # MCP 服务器配置
└── README.md              # 说明文档
```

### 阶段3：创建配置文件

#### 3.1 创建 `.claude-plugin/plugin.json`

使用模板生成，包含：
- `name`：插件标识符
- `version`：语义化版本（如 1.0.0）
- `description`：插件描述
- `author`：作者信息
- `skills`/`agents`/`commands`/`hooks`/`mcpServers`：组件路径

参考 `templates/plugin.json.tmpl` 和 `references/plugin-json-schema.md`

#### 3.2 创建 `.claude-plugin/marketplace.json`

定义 marketplace 目录：
- `name`：marketplace 名称
- `owner`：所有者信息
- `plugins`：插件列表

参考 `templates/marketplace.json.tmpl` 和 `references/marketplace-json-schema.md`

### 阶段4：迁移/创建内容

帮助用户：

1. **创建 Skill**
   - 使用 `templates/SKILL.md.tmpl`
   - 参考 `references/skill-structure-guide.md`

2. **创建 Agent**
   - 使用 `templates/agent.md.tmpl`

3. **创建 Command**
   - 创建 Markdown 文件 + YAML frontmatter
   - 放在 `commands/` 目录

4. **配置 Hooks**
   - 在 `hooks/hooks.json` 中定义事件钩子

5. **配置 MCP**
   - 在 `.mcp.json` 中定义 MCP 服务器

### 阶段5：验证

运行验证脚本检查配置：

```bash
python scripts/validate_plugin.py <path-to-plugin>
```

验证项目：
- plugin.json 格式正确
- marketplace.json 格式正确
- 所有引用的文件存在
- SKILL.md 文件格式正确

### 阶段6：发布指导

根据用户选择的平台提供相应的使用说明：

#### GitHub 仓库

```bash
# 添加 marketplace
/plugin marketplace add <username>/<repo-name>

# 安装插件
/plugin install <plugin-name>@<repo-name>

# 更新插件
/plugin update <plugin-name>@<repo-name>
```

#### GitLab 仓库

```bash
# 添加 marketplace（需要指定 gitlab 源类型）
/plugin marketplace add <namespace>/<project-name> --source gitlab

From karthrand/karthrand-ai-public, MIT.

More from karthrand/karthrand-ai-public