SuperAPI AI 工具集

snap

通用与其它

查看项目

更新于 10-16 09:54

技能介绍

用途:为 dotnet 仓库执行分支快照(branch snap,即 release branch cut)。快照会把命名分支的内容按 VS 次版本级联前移一位:main 版本 +1,release/insiders 接收原 main 内容,release/stable 接收原 insiders 内容;旧 stable 版本从级联中退役,如需继续服务某 SDK band,需先从快照前的 release/stable 提交创建长期分支(如 release/10.0.4xx)。

主要能力:自动发现分支与版本(通过 darc get-default-channels 与各分支 eng/Versions.props、eng/config/PublishData.json 推断,不要求用户提供分支和版本);分析 darc 订阅与 VMR 默认通道,构建快照前后的 SDK 流向矩阵;读取 VS 排期并起草快照公告邮件;查找近期 PR 与里程碑;确定快照切点(以用户确认的 Roslyn 快照时间为准,而非 VS 快照时间)。

使用方式:流程分 Gather、Plan、Execute 三阶段。先收集信息并展示完整计划,获得用户明确确认后才执行修改。前置工具为已认证的 gh 与 darc(darc authenticate 需已运行)。PR 通常从用户 fork 打开,需确认 gh 账号对 fork 有推送权限。快照跨多天,建议同一会话内完成以保留上下文。

适用场景:dotnet 仓库(如 dotnet/roslyn)的 VS 版本快照;在 Roslyn 仓库中会同时影响 Roslyn 与 Razor,需要多处版本更新。

限制:该技能会做破坏性变更(创建分支、开 PR、更新订阅、移动里程碑),必须先确认再执行;不假定仓库为 dotnet/roslyn,需先确认;执行中若偏离技能描述,应提醒用户更新技能文件。具体排期、订阅与版本数值需以实际仓库状态为准。