用途:在 Claude Code 插件中自动执行语义化版本(semver)升级,保证 plugin.json、marketplace.extended.json 与生成的 marketplace.json 目录三处版本号一致。
主要能力:读取当前版本、按 major/minor/patch 规则计算新版本、更新各版本承载文件、重新生成目录、校验一致性,并可选创建 git 标签与准备提交信息。
使用方式:需 jq 在 PATH 中可用,具备 .claude-plugin/plugin.json 与 .claude-plugin/marketplace.extended.json 读写权限,仓库根目录可运行 pnpm run sync-marketplace,并安装 git 以支持可选标签。流程为:用 jq -r '.version' 读取当前版本;根据用户请求或变更性质确定升级类型;按 semver 计算新版本;更新 plugin.json 的 version 字段;在 marketplace.extended.json 中同步该插件条目版本;运行 pnpm run sync-marketplace 重新生成 marketplace.json;读取三份文件确认版本一致;可选执行 git tag -a "v<new_version>" -m "Release v<new_version>" 并按 chore: Release v<version> 约定准备提交信息。
适用场景:插件发布、功能新增或缺陷修复后的版本递增,以及需要统一多处版本号的发布流程。
限制与错误处理:jq 未安装会报 command not found,可用 apt install jq 或 brew install jq 安装;版本格式非 x.y.z 需先修正;插件未在目录中需先加入 marketplace.extended.json;同步失败可用 jq empty 检查 JSON 语法;同步后版本不一致需确认插件名完全匹配。具体参考文件与更多示例见技能目录下的 references 文档。