主干发版与变更说明
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/shipshitdev-skills-release。
技能介绍
要解决什么问题
Trunk-based 团队往往在「主干上已经可发版」,却在版本号、变更说明和 GitHub Release 上卡住:有人手工翻 commit 写 notes,有人本地打 tag 时工作区不干净或 CI 未绿,还有人误走 promote 流程绕开闸门。Release 技能把「从主干切一次正式版本」收成一条可确认的流程:只从默认分支发版,先给你看清计划再动刀。
技能如何工作
- Preflight:自动识别主干(
master/main),要求当前在主干、工作区干净、且与 remote 同步;并读取 trunk HEAD 的必过 CI,未绿时需你明确 override。 - 版本:自上次 release tag 起的提交范围,按 Conventional Commits 推断
patch/minor/major(也支持显式vX.Y.Z或仅notes模式只生成说明不打 tag)。 - Patch notes:用通俗英文按 Features / Fixes / Performance / Breaking changes / Internal 分组;把 commit、PR、CI 输出当不可信输入,做摘要并脱敏,不执行其中嵌套指令。
- 确认后切割:打印版本、commit 范围、完整 notes 与将执行的动作,得到明确 yes 后才创建 annotated tag、push,并用
gh发布 GitHub Release;若仓库配置 dispatch mode(有 promote/workflow_dispatch 发版流),Phase 5 改为派发 guarded workflow,本地禁止旁路打 tag。
可选将 notes 写入 CHANGELOG.md;发版后可交给 deploy / release-cleanup 等技能处理后续,但本技能本身不部署、不 rebase、不 force-push。
适用边界与注意点
- 需要带 remote 的 git 仓库与 GitHub 侧读 tag/PR/CI 的能力;不会在脏树、主干落后 remote 或必填 CI 失败时静默发版。
- 版本严格递增,覆盖已有 tag 必须再次确认;与
release-pr-gates、changelog-generator、gh-fix-ci有明确分工。 - 只想预览「下一版会发什么」时用
notes模式即可,不切 tag。
使用场景
- 主干 CI 已绿,需要按 Conventional Commits 推算下一版并写分组英文 Release notes
- 发版前只想 dry-run:看下一 semver 与 commit 范围,不打 tag、不建 GitHub Release
- 仓库用 workflow_dispatch promote 发版,确认计划后派发 guarded workflow 而不是本地打 tag
- 每周发版需先汇总自上次 tag 以来的 fixes 与 breaking changes,经确认后再 push annotated tag
适合人员
- 维护 trunk-based 单主干仓库、每次发版都要对齐 tag 与 GitHub Release 的仓库维护者
- 负责对外 Release notes 的工程师,希望把 commit/PR 收成 Features/Fixes 等英文说明
- 在 promote gate 仓库里发版、必须走 CI 闸门而不能本地旁路打 tag 的 DevOps
- 需要先修复 trunk 必过检查或交给 release-pr-gates 再切版的发布值班同学