Plugin Forge 工作流

# 插件开发工作流 (Plugin Development Workflows) ## 创建新插件 ### 1. 创建插件目录结构 bash 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": "[email protected]" }, "keywords": ["keyword1", "keyword2"] } ### 3. 将插件添加到市场 通过将条目添加到 `plugins` 数组来更新 `.claude-plugin/marketplace.json`： { "name": "plugin-name", "source": "./plugins/plugin-name", "description": "Plugin description", "version": "0.1.0", "keywords": ["keyword1", "keyword2"], "category": "productivity" } ### 4. 添加插件组件 根据需要在各自的目录中创建命令、技能、智能体或钩子。 ## 版本提升 当对插件进行更改时，请更新**两个**位置的版本号： 1. `plugins//.claude-plugin/plugin.json` 2. `.claude-plugin/marketplace.json` (匹配插件条目) **语义化版本控制：** - **Major (x.0.0)**: 重大变更 - **Minor (0.x.0)**: 新功能、重构 - **Patch (0.0.x)**: 错误修复、仅文档更新 ## 本地测试工作流 ### 初始设置 bash # 添加市场 /plugin marketplace add /path/to/marketplace-root # 安装插件 /plugin install plugin-name@marketplace-name ### 迭代测试 对插件进行更改后： bash # 卸载 /plugin uninstall plugin-name@marketplace-name # 重新安装 /plugin install plugin-name@marketplace-name # 重启 Claude Code 以加载更改 **注意:** Claude Code 会缓存插件文件，因此可能需要重启才能使更改生效。 ## 发布工作流 ### 1. 提交更改 使用约定式提交 (Conventional Commits)： bash git add . git commit -m "feat: add new plugin" git commit -m "fix: correct plugin manifest" git commit -m "docs: update plugin README" ### 2. 推送到仓库 bash git push origin main ### 3. 分发 **GitHub 托管的市场：** 用户通过以下方式添加： bash /plugin marketplace add owner/repo /plugin install plugin-name@marketplace-name **本地市场：** 用户通过绝对路径添加： bash /plugin marketplace add /path/to/marketplace ## 命令命名约定 命令使用基于子目录的命名空间：