用途:为 GitHub 仓库执行一次完整的版本发布流程——决定下一个语义化版本、撰写发布说明、打标签并发布 GitHub Release。它与 /gh-bootstrap 分工不同:后者一次性配置发布基础设施(.github/release.yml、标签驱动工作流),本技能是每次发版时运行的仪式。
主要能力:1) 预检:拒绝在脏工作区或与远端分叉的状态下发布,确认要打标签的提交、上次发布标签(版本基线与说明范围)。2) 决定版本:扫描上次标签以来的 Conventional Commits,按最高影响变更映射升级类型(feat!/fix!/BREAKING CHANGE 为 major,feat 为 minor,fix/perf 为 patch;0.x 预发布版规则不同),沿用仓库既有标签方案(如 v 前缀、预发布标识),提出版本与理由并让用户确认。3) 撰写发布说明:可选自动生成(gh release create --generate-notes)、手工整理或混合方式,条目须来自真实提交。4) 如仓库有 CHANGELOG.md 则同步更新。5) 打附注标签并推送。6) 若无标签驱动工作流,则用 gh release create 发布。7) 回读发布状态并报告。
使用方式:按协议逐步执行,关键命令包括 git fetch --tags origin、git log "${LAST_TAG:+$LAST_TAG..}HEAD" --no-merges --pretty='%s'、git tag -a "$VERSION" -m "$VERSION"、git push origin "$VERSION"、gh release create "$VERSION" --title "$VERSION" --generate-notes --latest 等。推送标签与发布前均需用户明确批准。
适用场景:单版本线的 GitHub 仓库发版。限制:不负责搭建发布配置(属 /gh-bootstrap)、不提交或推送分支代码、不发布到包注册表(npm/crates.io/PyPI)、不支持 monorepo 多包独立版本线。注意:不得重指已有标签;自动生成说明只识别已合并 PR;预发布不得标记 --latest;标签必须是默认分支的祖先。