SuperAPI AI 工具集

bump-release

通用与其它

查看项目

更新于 10-16 03:16

技能介绍

用途:为单个或多个软件包执行发布流程,包括版本号提升、变更日志条目、提交和标签。支持单包仓库、工作区 monorepo、稳定版、beta 预发布和 dry-run。

主要能力:通过 plan-release.mjs 做只读发现,输出 schemaVersion 2 的 JSON,报告包身份、每个包的 changedFiles、工作区依赖边与声明范围、上一标签事实、选定目标和 worktree 状态;changeHints 仅为基于文件名的非权威导航提示,不能用于判断发布相关性或变更日志收录。finalize-release-plan.py 负责 beta 与显式版本转换、稳定预发布提升、npm 范围满足、简单依赖范围建议和依赖排序,并报告复杂范围、peer 范围、依赖环及未提供的稳定版本为未决项。validate-changelog.py 校验稳定变更日志的结构。

使用方式:先运行发现命令 node "<skill-dir>/scripts/plan-release.mjs" [--cwd <repo>] [--beta] [--dry-run] [--version <semver>] [--package <name-or-dir>]...;退出码 2 表示目标不是可发布的 Git/包仓库,64 表示输入无效。要求工作树干净。代理决定每个稳定补丁/次要/主要版本后,将发现 JSON 写入临时文件并运行 uv run "<skill-dir>/scripts/finalize-release-plan.py" --discovery <discovery.json> [--version <package>=<semver>]...。稳定变更日志用 uv run "<skill-dir>/scripts/validate-changelog.py" --file <CHANGELOG.md> --version <semver> --date <YYYY-MM-DD> [--tag <tag>] 校验。提交与标签按依赖顺序,每包一次提交和一个附注标签;不推送,成功后建议精确的 git push origin <tag> 命令。

限制:finalizer 从不选择常规发布幅度或依赖策略;代理负责条目选择、措辞、重要性和类别。beta 发布不更新变更日志。不得在最终稳定包集合确定前写变更日志,不得在发现报告已观察事实时推断标签约定。创建 GitHub release 需用户批准,无法验证发布历史时报告为未知且不提供写入。