用途:在 Aspire 仓库中提升产品版本号,主要修改 eng/Versions.props 第一个属性组中的版本,并同步 .github/policies/milestoneAssignment.prClosed.yml 中目标分支的自动里程碑分配规则。
主要能力:先确认请求的版本与目标分支(X.Y 视为 X.Y.0,缺失时询问而非推断),检查工作区状态并保留无关改动;通过 git log 与 git show 查看历史版本提升提交及其完整 diff,参考先例 #19139、#20037,优先采用最新适用历史。确认目标里程碑在 GitHub 上存在且处于开启状态,缺失或已关闭时先询问,不擅自创建或重开。
使用方式:在仓库根目录运行内置的 C# 文件式应用,例如 dotnet run --file .agents/skills/bump-aspire-version/BumpVersion.cs -- 17.0 --branch main --milestone 17.0。--branch 指 PR 目标分支而非功能分支,--milestone 需显式指定,因为服务里程碑可能与产品版本不同(如产品 13.6.1 对应里程碑 13.6.x)。脚本会更新三个版本分量并只改一条匹配分支的里程碑规则,写入前校验文件结构,匹配缺失或有歧义时报错,保留格式、行尾与无关规则,重复执行不再产生改动。
限制:脚本不创建、重开或查询 GitHub 里程碑;不改变预发布/稳定化设置与 dashboard 镜像固定值;不修改其他发布分支规则、依赖、SDK、生成 API 或示例版本。旧的 milestone-assignment.yml 已移除,不要重建。完成后用 git diff --check 与完整 diff 校验,确认仅预期内容变化,并再次运行命令确认两文件未变。需要时用 create-pr 技能与仓库 PR 模板提交,只提交预期文件、不加 force 推送,不自动合并,未实际执行构建或测试不得声称已执行。