用途:为单一包的 GitHub 仓库完成端到端发版流程,从版本分析到生成变更日志并创建发布 PR。适合需要打新版本、生成 changelog 或开发布 PR 的场景。
主要能力:第 1 至 4 步为只读侦察,先同步 main、读取 Git 标签获取最新版本(使用语义化排序,兼容 1.10.0 大于 1.9.0),再通过代码 diff 与提交日志两个信号分析改动,按 SemVer 规则判定 MAJOR/MINOR/PATCH,并按 Keep a Changelog 格式撰写 CHANGELOG、更新对比链接。
用法要点:需已安装并认证 gh CLI、处于 Git 仓库中且工作区干净;先确认公共源码目录 PUBLIC_PATH,diff 默认排除 tests、docs、锁文件等。常用命令包括 gh auth status、git fetch --tags,以及 git checkout -b release/vX.Y.Z、git push、gh pr create。PR 正文必须用 --body-file 传入,避免内联转义换行失效。Windows 建议使用 PowerShell 写法。
限制:依赖 gh 与 git 标签确定当前版本;版本号与变更日志会先展示给用户确认后再写入仓库。标签相关异常、无新提交、推送失败等情况有对应处理提示。未提供官方文档中更多扩展规则细节,相关资料暂未提供。