用途:为 .NET 发布里程碑生成仓库格式、可直接用于 markdown 的 API 差异报告,对比上一里程碑与当前里程碑的公共 API。该技能是纯生成流程:运行差异工具并写出报告。验证差异 API 是否实际发布、追溯到 PR、发现回退,属于另一个 api-diff-validation 技能。
主要能力:使用 release-notes/RunApiDiff.ps1 生成报告,完整参数参考见 release-notes/RunApiDiff.md。支持把自然语言映射为参数,例如“generate the next API diff”不带参数;“net9.0-preview6 to net10.0-preview5”映射为 -PreviousMajorMinor 9.0 -PreviousPrereleaseLabel preview.6 -CurrentMajorMinor 10.0 -CurrentPrereleaseLabel preview.5;完整 NuGet 版本字符串则直接用 -PreviousVersion / -CurrentVersion。GA 或无预发布限定符时省略 PrereleaseLabel;Preview N 写作 preview.N,RC N 写作 rc.N,Alpha/Beta 写作 alpha.N、beta.N,脚本仅接受 alpha、beta、preview、rc 四种预发布标签。previous 始终是较旧版本,current 是较新版本。
使用方式:运行 .\release-notes\RunApiDiff.ps1 [映射后的参数]。脚本耗时数分钟,建议初始等待至少 300 秒。完成后汇总结果:生成了多少个差异文件以及位置。
限制:仅生成报告,不验证差异 API 是否真正发布,也不追踪 PR 或检测回退;这些需使用 api-diff-validation 技能。