用途:判断仓库中未提交的特性改动是否需要 semver 版本升级、升到哪一层,并在需要时把新版本同步到所有相关文件,最后生成可供 CHANGELOG 生成器提取的 conventional-commit 信息。它是 skill-review 的版本感知版本,后者关注策略与质量问题,本技能关注版本并提交结果。“无需升级”是预期的一等结果。
主要能力:按改动路径划分变更类别并对应版本产物。插件技能或插件组件(commands、agents、hooks、.lsp.json、.mcp.json、monitors、settings、bin)改动时,同步更新 plugins/<category>/<plugin>/.claude-plugin/plugin.json 的 version 与 .claude-plugin/marketplace.json 中 source 匹配的 plugins[] 条目版本,二者同层级锁定。新插件发布时校验两处版本一致性,取较大者,不额外升级。仓库内部技能只更新该 SKILL.md frontmatter 的 metadata.version,缺失时以 0.1.0 引入。顶层 marketplace.json 的 metadata.version 不处理。
支持三类事件:SKILL.md 编辑、插件组件改动、新插件发布。版本层级按内容差异判定:Major(移除工作流步骤或工具、重命名、重定位、破坏性输入输出变化、触发条件收窄)、Minor(新增步骤或工具、描述放宽、新增可选功能、新增边界处理)、Patch(语义修复或纯文案/格式修复)。rubric 不明确时倾向更高层级。
使用方式:由 .claude/hooks/version-bump-reviewer.py 在 Edit、Write、MultiEdit 触及相关路径时自动触发,与 skill-edit-review.py 独立并行,建议先处理 skill-review 发现再运行本技能。也可在用户要求升级版本、准备发布、合并技能、发布新插件、确认是否需要升级或同步包版本时调用。改动文件通过带路径模式的 git diff --name-only HEAD 与 git status --short 收集。
对 SKILL.md 目标会用 uvx --from "$SRC" plugin-eval score 加 --depth quick 做前后评分作为佐证信号,可提升层级但不会降低层级。工作流先选定单一目标组,多组时按字母序先处理一组并提示重跑其余组,每组独立提交。
适用场景与限制:适用于插件或技能的版本管理与提交。无特性文件改动、空触碰、仅非行为文件(README、LICENSE、.gitignore、tests)变化时应跳过。cosmetic 内容改动仍算 Patch 并升级,只有真正无差异才算无需升级。预发布后缀原样保留,是否去掉由作者决定。官方页面未提供安装命令、收费与平台信息。