rock-plugin-release
Installation
SKILL.md
rock-plugin-release — plugin 仓库维护与发布
本 skill 用于维护 rock-marketplace 这个 plugin 仓库。这个仓库是一个单 plugin(rock)+ 多 skill 的结构,关键约束是:任何会改变 plugin 行为或对外暴露面的改动,都必须同步到六处位置,并按 semver 升版。漏改任何一处,就会导致已安装用户拿到的版本与 marketplace 声明的不一致,或某条安装路径(npx skills add / /plugin install / /plugin marketplace add)行为不一致——这种不一致很难被发现,却会真实地坑到使用者。
理解了这个"为什么",下面的所有规则就都是顺理成章的了。
六处必须同步的位置
每次改动后,对照检查这六处是否一致:
| # | 位置 | 改什么 | 何时改 |
|---|---|---|---|
| 1 | plugins/rock/skills/<skill>/ |
skill 实际内容(SKILL.md + scripts/ + references/) | 新增/删除/更新 skill 时 |
| 2 | skills/<skill> |
顶层软链 → ../plugins/rock/skills/<skill> |
仅新增 skill 时创建;删除 skill 时移除 |
| 3 | plugins/rock/plugin.json |
version + description |
每次会影响行为的改动 |
| 4 | marketplace/registry.json |
version + description + skills[] + updated_at |
每次会影响行为的改动 |
| 5 | .claude-plugin/marketplace.json |
内层 plugin 的 description(+ 外层 marketplace description 若涉及) |
description 变更时 |
| 6 | README.md |
结构图 + 「包含技能」表格 | skill 增删或 description 变更时 |