SuperAPI AI 工具集

release-note-generation

部署与运维

查看项目

更新于 10-16 06:47

技能介绍

用途:为 PowerToys 生成稳定版或预览版发布说明。稳定版与预览版共用同一套 PR 元数据、署名、分组与格式规则。

主要能力:从 GitHub 里程碑、提交/标签范围或 Azure DevOps 候选构建收集已合并 PR;为缺失里程碑的 PR 分配里程碑;用本地 CLI 智能体为每个 PR 生成 CopilotSummary;按标签分组并生成分组 Markdown 与最终合并的发布说明;准备 GitHub 发布资产(下载安装包与符号并计算哈希);从 ADO 构建 URL 或构建 ID 生成完整预览版草稿;比较 main 与 stable 分支切换时的预览内容差异。

输出目录:所有产物位于仓库根目录 Generated Files/ReleaseNotes/(已 gitignore),包含 milestone_prs.json、sorted_prs.csv、grouped_csv/、grouped_md/、v{VERSION}-release-notes.md 等;预览版使用隔离子目录 preview-<buildId>/。

使用方式:需先安装并认证 GitHub CLI(gh auth status 验证,未登录则 gh auth login),安装 github-mcp-server;预览版与 prepare-release-assets.ps1 还需 az login 并具备 microsoft/Dart ADO 项目访问权限。稳定版需与用户确认 {{ReleaseVersion}};预览版不询问版本,由候选 ADO 构建推导。按场景索引选择稳定版或预览版流程,依次执行收集与里程碑、打标签、评审与分组、总结与最终输出。可用脚本包括 dump-prs-since-commit.ps1、group-prs-by-label.ps1、collect-or-apply-milestones.ps1、diff_prs.ps1、prepare-release-assets.ps1、get-release-build-metadata.ps1、get-previous-published-release.ps1、get-preview-release-delta.ps1、collect-pr-metadata.ps1、new-preview-release-manifest.ps1、upsert-draft-preview-release.ps1、verify-draft-preview-release.ps1。

适用场景:里程碑发布说明、提交范围 PR 汇总、PR 评审摘要、里程碑补全、README 版本更新、GitHub 发布资产准备、ADO 构建到草稿预览版、分支切换预览对比。

限制:终端默认禁用,仅在用户明确请求时运行脚本;预览清单 release-manifest.json 与 assets-manifest.json 仅保留在本地审计包,不得作为 GitHub 发布资产上传;不要用 CLI/编码智能体调用 mcp_github_request_copilot_review,GitHub API 会拒绝机器人发起的评审请求;分组 Markdown 需一次性全部生成后再人工审核;输出保持 sorted_prs.csv 顺序;标签过滤保留 Product-、Area-、GitHub*、Plugin、Issue-。其他细节暂未提供。