名称: plugin-forge 描述: 创建和管理具有适当结构、清单和 marketplace 集成的 Claude Code 插件。在创建 marketplace 的插件、添加插件组件（命令、代理、钩子）、提升插件版本或处理 plugin.json/marketplace.json 清单时使用。

CC Plugin Forge

目的

构建和管理具有正确结构、清单和 marketplace 集成的 Claude Code 插件。包括工作流程、自动化脚本和参考文档。

使用时机

为 marketplace 创建新插件
添加/修改插件组件（命令、技能、代理、钩子）
更新插件版本
处理插件或 marketplace 清单
设置本地插件测试
发布插件

开始使用

创建新插件

使用 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. 在 Marketplace 中注册

更新 .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/`	带有 frontmatter 的 Markdown
技能	`skills/<name>/`	带有 `SKILL.md` 的目录
代理	`agents/`	Markdown 定义
钩子	`hooks/hooks.json`	事件处理器
MCP 服务器	`.mcp.json`	外部集成

5. 本地测试

# 添加 marketplace
/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:command
commands/simple.md → /simple

示例：

commands/prime/vue.md → /prime:vue
commands/docs/generate.md → /docs:generate

版本管理

重要： 在两个位置更新版本：

plugins/<name>/.claude-plugin/plugin.json
.claude-plugin/marketplace.json

使用 bump_version.py 自动化。

Git 提交

使用约定提交：

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`	目录结构、清单模式、组件
`references/marketplace-schema.md`	Marketplace 格式、插件条目、分发
`references/workflows.md`	逐步工作流程、模式、发布

脚本

脚本	目的
`scripts/create_plugin.py`	搭建新插件
`scripts/bump_version.py`	更新版本