用途:发布新版本时统一处理版本号升级、打标签和发布 GitHub Release,并自动生成变更日志。
主要能力:要求所有版本来源保持一致,包括 .claude-plugin/plugin.json 的 version、.claude-plugin/marketplace.json 的 plugins[0].version,以及 Git 标签 vX.Y.Z。
用法步骤: 一、确定版本号。查看上次标签以来的提交: git log $(git describe --tags --abbrev=0)..HEAD --oneline 按语义化版本判断:修复用 patch,功能用 minor,破坏性变更为 major。 二、修改两个 JSON 文件,使版本字符串完全一致。 三、提交版本升级: git add .claude-plugin/plugin.json .claude-plugin/marketplace.json git commit -m "chore: bump version to X.Y.Z" 四、创建并推送标签: git tag vX.Y.Z git push origin main --tags 五、创建 GitHub Release: gh release create vX.Y.Z --title "vX.Y.Z" --notes "$(cat <<'EOF'
Changes
<changelog from git log> EOF )" 提交较多时按类型分组(feat:、fix:、refactor:、其他);少于 5 个提交可用平铺列表。
常见错误与修正:marketplace.json 版本未更新,需两个 JSON 文件一起更新;先打标签后推提交,应先推提交再打标签或用 --tags;变更日志漏提交,应使用 prev_tag..HEAD,而非打标签后的 prev_tag..new_tag。
限制:资料未提供收费、平台支持范围等其他信息。