用途
Plugin Forge 用于构建和管理 Claude Code 插件,确保插件具备正确的结构、清单文件(manifests)以及与插件市场的集成。技能包含工作流、自动化脚本和参考文档。
何时使用
- 为市场创建新的插件
- 添加或修改插件组件(命令、技能、智能体、钩子)
- 更新插件版本
- 处理插件或市场清单文件
- 设置本地插件测试
- 发布插件
快速开始
创建新插件
使用 create_plugin.py 生成插件结构:
python scripts/create_plugin.py plugin-name \
--marketplace-root /path/to/marketplace \
--author-name "Your Name" \
--author-email "your.email@example.com" \
--description "Plugin description" \
--keywords "keyword1,keyword2" \
--category "productivity"
该脚本会自动完成:
- 创建插件目录结构
- 生成 plugin.json 清单
- 创建 README 模板
- 更新 marketplace.json
升级版本
使用 bump_version.py 同时更新两个清单中的版本:
python scripts/bump_version.py plugin-name major|minor|patch \
--marketplace-root /path/to/marketplace
语义化版本规则:
- major:破坏性变更(1.0.0 → 2.0.0)
- minor:新增功能、重构(1.0.0 → 1.1.0)
- patch:问题修复、文档(1.0.0 → 1.0.1)
开发工作流
1. 创建结构
如不使用脚本,可手动创建目录:
mkdir -p plugins/plugin-name/.claude-plugin
mkdir -p plugins/plugin-name/commands
mkdir -p plugins/plugin-name/skills
2. 插件清单
文件位置:plugins/plugin-name/.claude-plugin/plugin.json
{
"name": "plugin-name",
"version": "0.1.0",
"description": "Plugin description",
"author": {
"name": "Your Name",
"email": "your.email@example.com"
},
"keywords": ["keyword1", "keyword2"]
}
3. 在市场注册
更新 .claude-plugin/marketplace.json:
{
"name": "plugin-name",
"source": "./plugins/plugin-name",
"description": "Plugin description",
"version": "0.1.0",
"keywords": ["keyword1", "keyword2"],
"category": "productivity"
}
4. 添加组件
在对应目录中创建:
| 组件 | 位置 | 格式 |
|---|---|---|
| 命令(Commands) | commands/ | 带 frontmatter 的 Markdown |
| 技能(Skills) | skills/<name>/ | 包含 SKILL.md 的目录 |
| 智能体(Agents) | agents/ | Markdown 定义 |
| 钩子(Hooks) | hooks/hooks.json | 事件处理器 |
| MCP 服务器 | .mcp.json | 外部集成 |
5. 本地测试
# 添加市场
/plugin marketplace add /path/to/marketplace-root
# 安装插件
/plugin install plugin-name@marketplace-name
# 修改后:重新安装
/plugin uninstall plugin-name@marketplace-name
/plugin install plugin-name@marketplace-name
插件模式
框架插件
用于框架特定指导(如 React、Vue 等):
plugins/framework-name/
├── .claude-plugin/plugin.json
├── skills/
│ └── framework-name/
│ ├── SKILL.md
│ └── references/
├── commands/
│ └── prime/
│ ├── components.md
│ └── framework.md
└── README.md
工具插件
用于工具和命令:
plugins/utility-name/
├── .claude-plugin/plugin.json
├── commands/
│ ├── action1.md
│ └── action2.md
└── README.md
领域插件
用于领域特定知识:
plugins/domain-name/
├── .claude-plugin/plugin.json
├── skills/
│ └── domain-name/
│ ├── SKILL.md
│ ├── references/
│ └── scripts/
└── README.md
命令命名
基于子目录的命名空间,以 : 分隔:
commands/namespace/command.md→/namespace:commandcommands/simple.md→/simple
示例:
commands/prime/vue.md→/prime:vuecommands/docs/generate.md→/docs:generate
版本管理
重要:需在两处同时更新版本:
plugins/<name>/.claude-plugin/plugin.json.claude-plugin/marketplace.json
可使用 bump_version.py 自动化完成。
Git 提交
使用约定式提交(conventional commits):
git commit -m "feat: add new plugin"
git commit -m "fix: correct plugin manifest"
git commit -m "docs: update plugin README"
git commit -m "feat!: breaking change"
参考文档
包含的详细文档:
| 参考 | 内容 |
|---|---|
| references/plugin-structure.md | 目录结构、清单 schema、组件 |
| references/marketplace-schema.md | 市场格式、插件条目、分发 |
| references/workflows.md | 分步工作流、模式、发布 |
脚本
| 脚本 | 用途 |
|---|---|
| scripts/create_plugin.py | 搭建新插件骨架 |
| scripts/bump_version.py | 更新版本 |