用途:维护和发布 rock-marketplace 这个插件仓库。该仓库为单插件(rock)加多技能结构,任何改变插件行为或对外暴露面的改动,都必须同步六处位置并按 semver 升版,否则会出现已安装用户拿到的版本与市场声明不一致,或各安装路径行为不一致。
六处必须同步的位置:plugins/rock/skills/<skill>/ 内的实际内容;顶层软链 skills/<skill>(指向 ../plugins/rock/skills/<skill>);plugins/rock/plugin.json 的 version 与 description;marketplace/registry.json 的 version、description、skills[] 与 updated_at;.claude-plugin/marketplace.json 中的描述;README.md 的结构图与技能表格。三条安装路径分别依赖不同清单:npx skills add 认顶层软链,/plugin install 走 plugins/ 与 registry.json,/plugin marketplace add 读 .claude-plugin/marketplace.json。
主要能力:提供一致性校验脚本,改动前后运行 python3 .claude/skills/rock-plugin-release/scripts/check_consistency.py,检查版本号一致性、skills 列表与实际目录是否一致、SKILL.md frontmatter 合法性、顶层软链是否齐全、README 是否提及所有技能、updated_at 格式;脚本只读,退出码 0 表示一致。
版本号规则:只有技能列表增减(新增或删除/重命名技能)升 minor,其余改动(技能内容更新、文档、元数据、hooks 调整)升 patch;除用户指示外不升 major。版本号由执行者建议、用户确认,不擅自 bump。plugin.json 与 registry.json 的 version 必须完全一致。
典型流程:新增技能需创建 SKILL.md、建立顶层软链(命令为 ln -s ../plugins/rock/skills/rock-xxx skills/rock-xxx,在仓库根目录执行)、更新 plugin.json、registry.json、marketplace.json 与 README,再跑校验;删除技能需删目录与软链、更新对应清单与文档后校验;更新技能内容或仅改元数据/文档时同步版本与描述并校验。registry.json 的 updated_at 在有版本变化时刷新为当天日期,格式 YYYY-MM-DD,不臆造未来日期。收尾需确认校验通过、版本一致、updated_at 已刷新、技能列表各处一致、描述变更已在 marketplace.json 同步,并说明建议版本号及理由。提交信息格式为 <type>(<scope>): <description>,如 feat(rock): add rock-xxx skill。限制:资料未说明具体适用平台与收费情况。