PowerToys 发布说明生成技能：自动化生成专业发布说明，集成 GitHub Copilot 代码审查

release-note-generation by microsoft/powertoys

85 周安装量

131,100 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/microsoft/powertoys --skill release-note-generation

自动化技术文档开源项目

🇨🇳中文介绍

发布说明生成技能

通过收集已合并的 PR、请求 Copilot 代码审查、按标签分组并生成面向用户的摘要，为 PowerToys 里程碑生成专业的发布说明。

输出目录

所有生成的工件都放置在仓库根目录下的 Generated Files/ReleaseNotes/ 目录中（该目录已被 gitignore 忽略）。

Generated Files/ReleaseNotes/
├── milestone_prs.json           # 来自 GitHub 的原始 PR 数据
├── sorted_prs.csv               # 包含 Copilot 摘要的已排序 PR 列表
├── prs_with_milestone.csv       # 里程碑分配跟踪
├── grouped_csv/                 # 按标签分组的 PR（每个标签一个 CSV 文件）
├── grouped_md/                  # 每个标签生成的 Markdown 摘要
└── v{VERSION}-release-notes.md  # 最终整合的发布说明

使用时机

为里程碑生成发布说明
总结某个版本中合并的 PR
为里程碑 PR 请求 Copilot 审查
为缺少里程碑的 PR 分配里程碑
收集两个提交/标签之间的 PR
为新版本更新 README.md

先决条件

已安装并认证 GitHub CLI (gh) — 收集脚本使用 gh pr view 和来获取 PR 元数据和共同作者信息。运行进行验证；如果未登录，请先运行。详情请参阅。

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

FlyClaw：零登录航班聚合查询工具，Python实现多源航班信息与价格搜索

4,000,000 周安装

Azure RBAC 权限管理工具：查找最小角色、创建自定义角色与自动化分配

142,000 周安装

GitHub Actions 官方文档查询助手 - 精准解答 CI/CD 工作流问题

47,200 周安装

通过 LiteLLM 代理让 Claude Code 对接 GitHub Copilot 运行 | 高级变通方案指南

46,900 周安装

变量	描述	示例
`{{ReleaseVersion}}`	目标发布版本	`0.98`

┌────────────────────────────────┐
│ 1.0 验证 gh 认证 + 成员列表 │
└────────────────────────────────┘
              ↓
┌────────────────────────────────┐
│ 1.1 收集 PR（稳定分支范围） │
└────────────────────────────────┘
              ↓
┌────────────────────────────────┐
│ 1.2 分配里程碑           │
└────────────────────────────────┘
              ↓
┌────────────────────────────────┐
│ 2.1–2.4 标记 PR（自动+人工）  │
└────────────────────────────────┘
              ↓
┌────────────────────────────────┐
│ 3.1 请求审查（Copilot）  │
└────────────────────────────────┘
              ↓
┌────────────────────────────────┐
│ 3.2 刷新 PR 数据             │
│ (CopilotSummary)                │
└────────────────────────────────┘
              ↓
┌────────────────────────────────┐
│ 3.3 按标签分组              │
│ (grouped_csv)                   │
└────────────────────────────────┘
              ↓
┌────────────────────────────────┐
│ 4.1 生成摘要 (grouped_md)      │
└────────────────────────────────┘
              ↓
┌────────────────────────────────┐
│ 4.2 最终说明 (v{VERSION}.md) │
└────────────────────────────────┘

步骤	操作	详情
1.0	验证先决条件	`gh auth status` 必须通过；生成 MemberList.md
1.1	收集 PR	从 `stable` 分支上的前一个发布标签开始 → `sorted_prs.csv`
1.2	分配里程碑	确保所有 PR 都有正确的里程碑
2.1–2.4	标记 PR	自动建议 + 人工标记低置信度的 PR
3.1–3.3	审查与分组	请求 Copilot 审查 → 刷新 → 按标签分组
4.1–4.2	摘要与终稿	生成分组摘要，然后整合

脚本	用途
dump-prs-since-commit.ps1	获取提交/标签之间的 PR
group-prs-by-label.ps1	将 PR 分组到 CSV 文件
collect-or-apply-milestones.ps1	分配里程碑
diff_prs.ps1	增量 PR 差异

终端使用：默认禁用；仅在用户明确请求时运行脚本
批量生成：一次性生成所有 grouped_md 文件，然后进行人工审查
PR 顺序：在所有输出中保持 sorted_prs.csv 中的顺序
标签过滤：保留 Product-*、Area-*、GitHub*、*Plugin、Issue-*

问题	解决方案
找不到 `gh` 命令	安装 GitHub CLI 并添加到 PATH
未返回 PR	验证里程碑标题是否完全匹配
CopilotSummary 为空	先请求 Copilot 审查，然后重新运行 dump
许多未标记的 PR	在分组之前返回标记步骤

🇺🇸English

Release Note Generation Skill

Generate professional release notes for PowerToys milestones by collecting merged PRs, requesting Copilot code reviews, grouping by label, and producing user-facing summaries.

Output Directory

All generated artifacts are placed under Generated Files/ReleaseNotes/ at the repository root (gitignored).

Generated Files/ReleaseNotes/
├── milestone_prs.json           # Raw PR data from GitHub
├── sorted_prs.csv               # Sorted PR list with Copilot summaries
├── prs_with_milestone.csv       # Milestone assignment tracking
├── grouped_csv/                 # PRs grouped by label (one CSV per label)
├── grouped_md/                  # Generated markdown summaries per label
└── v{VERSION}-release-notes.md  # Final consolidated release notes

When to Use This Skill

Generate release notes for a milestone
Summarize PRs merged in a release
Request Copilot reviews for milestone PRs
Assign milestones to PRs missing them
Collect PRs between two commits/tags
Update README.md for a new version

Prerequisites

GitHub CLI (gh) installed and authenticated — The collection script uses gh pr view and gh api graphql to fetch PR metadata and co-author information. Run gh auth status to verify; if not logged in, run gh auth login first. See Step 1.0.0 for details.
MCP Server: github-mcp-server installed
GitHub Copilot code review enabled for the org/repo

Required Variables

⚠️ Before starting , confirm {{ReleaseVersion}} with the user. If not provided, ASK : "What release version are we generating notes for? (e.g., 0.98)"

Variable	Description	Example
`{{ReleaseVersion}}`	Target release version	`0.98`

Workflow Overview

┌────────────────────────────────┐
│ 1.0 Verify gh auth + MemberList │
└────────────────────────────────┘
              ↓
┌────────────────────────────────┐
│ 1.1 Collect PRs (stable range) │
└────────────────────────────────┘
              ↓
┌────────────────────────────────┐
│ 1.2 Assign Milestones           │
└────────────────────────────────┘
              ↓
┌────────────────────────────────┐
│ 2.1–2.4 Label PRs (auto+human)  │
└────────────────────────────────┘
              ↓
┌────────────────────────────────┐
│ 3.1 Request Reviews (Copilot)  │
└────────────────────────────────┘
              ↓
┌────────────────────────────────┐
│ 3.2 Refresh PR data             │
│ (CopilotSummary)                │
└────────────────────────────────┘
              ↓
┌────────────────────────────────┐
│ 3.3 Group by label              │
│ (grouped_csv)                   │
└────────────────────────────────┘
              ↓
┌────────────────────────────────┐
│ 4.1 Summarize (grouped_md)      │
└────────────────────────────────┘
              ↓
┌────────────────────────────────┐
│ 4.2 Final notes (v{VERSION}.md) │
└────────────────────────────────┘

Step	Action	Details
1.0	Verify prerequisites	`gh auth status` must pass; generate MemberList.md
1.1	Collect PRs	From previous release tag on `stable` branch → `sorted_prs.csv`
1.2	Assign Milestones	Ensure all PRs have correct milestone
2.1–2.4	Label PRs	Auto-suggest + human label low-confidence
3.1–3.3	Reviews & Grouping	Request Copilot reviews → refresh → group by label
4.1–4.2	Summaries & Final	Generate grouped summaries, then consolidate

Detailed workflow docs

Do not read all steps at once—only read the step you are executing.

Available Scripts

Script	Purpose
dump-prs-since-commit.ps1	Fetch PRs between commits/tags
group-prs-by-label.ps1	Group PRs into CSVs
collect-or-apply-milestones.ps1	Assign milestones
diff_prs.ps1	Incremental PR diff

References

Sample Output - Example summary formatting
Detailed Instructions - Legacy full documentation

Conventions

Terminal usage : Disabled by default; only run scripts when user explicitly requests
Batch generation : Generate ALL grouped_md files in one pass, then human reviews
PR order : Preserve order from sorted_prs.csv in all outputs
Label filtering : Keeps Product-*, Area-*, GitHub*, *Plugin, Issue-*

Troubleshooting

Issue	Solution
`gh` command not found	Install GitHub CLI and add to PATH
No PRs returned	Verify milestone title matches exactly
Empty CopilotSummary	Request Copilot reviews first, then re-run dump
Many unlabeled PRs	Return to labeling step before grouping

Weekly Installs

Repository

microsoft/powertoys

GitHub Stars

131.1K

First Seen

Jan 27, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykWarn

Installed on

gemini-cli78

opencode78

codex76

github-copilot71

claude-code68

cursor67