plugin-forge

# CC 插件工坊 (Plugin Forge) ## 目的 使用正确的结构、清单和市场集成来构建和管理 Claude Code 插件。包含工作流、自动化脚本和参考文档。 ## 何时使用 - 为市场创建新插件 - 添加/修改插件组件（命令、智能体、钩子） - 更新插件版本 - 处理插件或市场清单文件 - 设置本地插件测试 - 发布插件 ## 入门指南 ### 创建新插件 使用 `create_plugin.py` 生成插件结构： bash python scripts/create_plugin.py plugin-name --marketplace-root /path/to/marketplace --author-name "Your Name" --author-email "[email protected]" --description "Plugin description" --keywords "keyword1,keyword2" --category "productivity" 这将自动执行以下操作： - 创建插件目录结构 - 生成 `plugin.json` 清单 - 创建 README 模板 - 更新 `marketplace.json` ### 提升版本 使用 `bump_version.py` 更新两个清单文件中的版本： bash 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. 创建结构 手动方法（如果不使用脚本）： 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. 在市场中注册 更新 `.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//` | 包含 `SKILL.md` 的目录 | | 智能体 (Agents) | `agents/` | Markdown 定义 | | 钩子 (Hooks) | `hooks/hooks.json` | 事件处理器 | | MCP 服务器 |