用途
claude-plugins 是一个面向 Claude Code 插件开发的技能，用于在创建插件、发布到市场，或涉及 plugin.json、marketplace、create plugin、distribute plugin 等场景时提供完整指导。它覆盖插件从发现、初始化、组件开发、验证、分发到市场发布的完整生命周期。
主要能力
该技能按六个阶段组织插件开发流程：
- 发现（Discovery）：明确插件解决的问题、使用者、所需组件以及存放位置（个人、项目或市场）。
- 初始化（Initialization）：创建插件结构。独立插件需要自己的 .claude-plugin/plugin.json；合并式市场可使用 strict: false 将元数据集中到 marketplace.json，插件无需各自清单。
- 组件（Components）：按需添加斜杠命令（commands/）、自定义智能体（agents/）、事件钩子（hooks/）、技能（skills/）以及 MCP 服务器。钩子支持文件式（hooks/hooks.json）和 plugin.json 内联两种定义方式，类型包括 PreToolUse、PostToolUse、UserPromptSubmit、Stop、SessionStart、SessionEnd。
- 验证（Validation）：分发前检查结构、组件和文档，并提供本地测试命令。
- 分发（Distribution）：遵循语义化版本（MAJOR.MINOR.PATCH），通过 GitHub 仓库、Git URL 或本地路径分发，并给出发布工作流。
- 市场（Marketplace）：创建 .claude-plugin/marketplace.json，支持相对路径、GitHub 和 Git URL 三种插件来源，并提供市场添加、列出、安装、更新等命令。
使用方式
快速开始流程：
# 1. 脚手架创建插件
./scripts/scaffold-plugin.sh my-plugin --with-commands
# 2. 添加组件（命令、智能体、钩子、技能）
# 3. 本地测试
/plugin marketplace add ./my-plugin
/plugin install my-plugin@my-plugin
# 4. 分发
git push origin main --tags
市场相关命令：
/plugin marketplace add owner/repo # 添加市场
/plugin marketplace list # 列出可用市场
/plugin install plugin-name@marketplace # 从市场安装
/plugin marketplace update marketplace # 更新市场
发布工作流：更新 plugin.json 版本、更新 CHANGELOG.md、提交并打标签、推送标签、创建 GitHub release。
适用场景
- 创建新的 Claude Code 插件并定义其结构。
- 为插件添加斜杠命令、自定义智能体、事件钩子、技能或 MCP 服务器。
- 在本地测试和验证插件。
- 将插件打包、版本化并分发到 GitHub、GitLab、Bitbucket 或本地路径。
- 创建和维护插件市场，供团队或公众发现和安装插件。
限制与注意事项
- 插件缓存：插件安装后会被复制到缓存目录，路径遍历（如 ../../shared/file.md）将失效，共享资源必须放在插件目录内；跨插件依赖应使用技能调用（plugin:skill-name）而非文件引用。
- 命名规范：插件、命令、智能体均使用 kebab-case。
- 安全：不得在插件文件中硬编码密钥，敏感数据使用环境变量，钩子中需验证所有用户输入。
- 文档：分发需包含 README.md 和 LICENSE，并遵循语义化版本。
- 验证：分发前必须完成结构、组件和文档检查，不得跳过。
- 该技能依赖多个相关技能（claude-commands、claude-agents、claude-hooks、skills-dev）来分别处理各类组件的开发。
故障排查
技能提供了常见问题的排查方向：插件未加载（检查 plugin.json 或 marketplace.json 语法、名称匹配、必填字段）、命令未出现（检查 YAML frontmatter 和 commands/ 目录）、钩子未执行（检查脚本可执行权限、matcher 正则）、MCP 服务器失败（检查二进制文件、环境变量、日志）。
参考文档
技能附带 structure.md（目录布局、plugin.json schema、组件格式）、distribution.md（打包、版本化、CI/CD、发布自动化）、marketplace.md（市场 schema、托管、团队配置）、caching.md（插件缓存行为与跨插件依赖）等文档。