用途:基于 git 提交历史自动生成发布说明,并输出为三种格式,适用于软件版本发布流程。
主要能力:分析自上一个发布标签或指定版本以来的 git 历史;通过 gh api 获取 PR 标题、描述与标签;将变更归类为新功能、缺陷修复、改进、安全、破坏性变更;生成 CHANGELOG.md 章节(技术向)、PR 发布正文(半技术向)、Slack 公告(面向用户)三种输出;将技术术语转换为易读表述;检测到数据库迁移文件时突出警示。提交按 conventional commit 前缀分类,如 feat、fix、perf、security、refactor、chore、docs、test、style,其中 refactor、chore、docs、test、style 默认不写入 Slack 公告。若仓库提供发布 PR 模板(如 .github/PULL_REQUEST_TEMPLATE/release.md),PR 正文会使用该模板。
使用方式:从仓库根目录运行,确保 gh CLI 已认证。基本用法为生成自上次发布的说明,或指定版本如 0.18.0;可指定范围(如 v0.17.0 到 HEAD);支持仅预览不写文件(--preview)。输出后可将 CHANGELOG.md 写入文件,PR 正文与 Slack 公告复制到剪贴板。
常用命令:git tag --sort=-v:refname | head -n 1 获取最近标签;git log <tag>..HEAD --oneline --no-merges 列出提交;gh api repos/{owner}/{repo}/pulls/{number} 获取 PR 详情;git show --stat <sha> 查看提交详情;git diff <last-tag>..HEAD --name-only -- migrations/ 检测新迁移。
限制与注意:需在 git 仓库根目录运行且 gh CLI 已认证;生成内容发布前应人工审核;Slack 文案需按受众调整;资料未说明该技能的具体安装方式、收费情况、支持平台及性能指标。