SuperAPI AI 工具集

umb-release-notes

通用与其它

查看项目

更新于 10-16 07:16

技能介绍

用途:针对 Umbraco CMS 某次发布,把 GitHub 自动生成的发布说明文件整理成更完整、分类更合理、无内部噪音的版本,结果写到输入文件同目录的新文件,便于用户 diff。仓库固定为 umbraco/Umbraco-CMS。

主要能力:以 release/<版本> 标签为准,用 gh 拉取全部已合并 PR 作为权威清单;补上输入文件中缺失的已打标签 PR;对输入中存在但无该标签的 PR(如回填/低版本 PR)保留并按需查标签归类;剔除对发布说明读者无价值的纯内部条目;保留 New Contributors 与 Full Changelog 原样。

必要用法:$ARGUMENTS 需提供版本(如 17.5.0)与输入文件完整路径。先执行 gh auth status,失败则提示 gh auth login 并停止。拉取命令示例:gh pr list --repo umbraco/Umbraco-CMS --label "release/<version>" --state closed --limit 1000 --json number,title,author,labels,mergedAt --jq '.[] | select(.mergedAt != null) | "(.number)\t(.author.login)\t([.labels[].name] | join(", "))\t(.title)"' | sort -n。需用 gh pr list ... --jq 'length' 检查是否达到 --limit 以防静默截断,达到则提高限制重取。缺标签 PR 用 gh pr view <number> --repo umbraco/Umbraco-CMS --json number,title,labels 查标签。

分类顺序固定:Notable Changes、Breaking Changes、Dependencies、New Features、Performance、Accessibility Improvements、Bug Fixes、Testing、Code Quality/Documentation/Refactoring、Developer Experience;空分类省略。Notable 与 Breaking 不重新归类,仅可补充遗漏项。标签信号优先于标题措辞,但 Performance: 与 Developer Experience: 标题前缀具决定性。输出文件名为在原扩展名前追加 " - with updates"。

限制:依赖 GitHub CLI 与认证;New Contributors 无法可靠重算故原样保留;边界归类需自行判断并在总结中标注;不确定是否噪音的条目应保留并标注,不得静默删除。资料未提供具体版本、价格或平台信息。