SuperAPI AI 工具集

bump-version

通用与其它

查看项目

更新于 10-16 09:33

技能介绍

用途:在 modelcontextprotocol/csharp-sdk 仓库中评估并递增 SDK 版本,为下一个发布做准备。该技能负责语义化版本 2.0.0 的评估逻辑,其 SemVer 评估指南是 prepare-release 与 publish-release 技能共用的版本判定依据。

主要能力:读取当前分支的 src/Directory.Build.props,提取 VersionPrefix(MAJOR.MINOR.PATCH)与 VersionSuffix(预发布后缀),并展示当前候选版本。通过 gh release list 查找上一发布标签(忽略草稿发布),且查询与分支相关:在 release/{MAJOR}.x 分支上只匹配 v{MAJOR}.* 标签,在 main 上取全局最近已发布版本。

版本判定:用户若在提示中给出目标版本则直接采用;否则采用两种方式之一。首选 SemVer 评估:列出上一发布标签与目标提交之间合并的 PR,分类为 MAJOR(存在已确认的破坏性变更,[Experimental] API 除外)、MINOR(新增公共 API、特性或过时警告)或 PATCH(其他情况),据此从上一发布标签推算推荐版本,并与当前版本比较标记差异,以汇总表和理由呈现并请用户确认。回退方式:稳定候选建议下一 minor(1.0.0→1.1.0,1.2.3→1.3.0);预发布候选在后缀标识后递增末尾整数(2.0.0-preview.1→2.0.0-preview.2,2.0.0-rc.1→2.0.0-rc.2)。

使用方式:从当前分支创建名为 bump-version-to-{version} 的分支,更新 src/Directory.Build.props 中的 VersionPrefix 和 VersionSuffix(稳定版清空后缀,缺失则新增元素),MAJOR 变更时更新 PackageValidationBaselineVersion,以 Bump version to {version} 提交,推送并创建 PR,标题为 Bump version to {version},标签 infrastructure,基分支为当前分支(如 release/1.x 服务分支则为该分支而非 main),最后向用户显示 PR URL。

限制:需要 gh 环境与仓库权限;需要完整发布准备(ApiCompat/ApiDiff、文档审查、发布说明)时应使用 prepare-release 技能。资料未提供其他收费、平台或效果信息。