Release Bumper 是一个面向 Git 仓库与 npm 包的发行交付技能,用于对一个或多个包执行版本递增、变更日志编写、提交与打标签。
用途:为单包仓库或多包 monorepo 切出一个版本。非 dry-run 调用即授权仓库内版本编辑、变更日志、提交与附注标签,工作流自身不再另加确认关卡,仅当包选择或依赖范围策略未决时才询问。
主要能力:解析包与版本参数(packages、version、--beta、--dry-run);通过发现脚本输出只读 JSON(schemaVersion 2),报告包身份、各包完整 changedFiles、工作区依赖边与声明范围、先前标签事实、选定目标与工作区状态;由代理决定稳定版的 patch/minor/major;最终化脚本处理 beta 转换、显式版本、稳定预发布提升、npm 范围满足、简单依赖范围建议与依赖排序;变更日志用校验脚本检查标题、分类顺序与许可分类。
使用方式:先运行发现脚本 plan-release.ts(支持 --cwd、--beta、--dry-run、--version、--package),要求工作树干净;随后把发现 JSON 写入临时文件,运行 finalize-release-plan.py 传入 --discovery 与 --version 赋值;稳定版变更日志用 validate-changelog.py 校验。提交信息单包为 docs: release <version>,monorepo 为 docs: release <package> <version>;按依赖顺序每个包一个提交和一个附注标签,不打推送。
适用场景:需要按语义化版本发布并维护变更日志的 JS/TS 仓库,尤其是含工作区依赖的 monorepo。
限制:不自动推送,只建议精确的 git push origin <tag> 命令,不使用 --tags;创建 GitHub release 需用户批准,且需先确认存在活跃的发布工作流与已维护发行历史;发现失败退出码 2 或 64 时应停止;changeHints 仅为文件名导航提示,不能用于判断发布相关性;未提供官方文档与价格信息。