用途:在切版本发布时提供一套发布工程规范,覆盖版本号计算、发布就绪检查、变更说明撰写以及破坏性变更的处理顺序。
主要能力:
- 由约定式提交计算升级类型:feat!: 或正文中的 BREAKING CHANGE: 页脚为 major,feat: 为 minor,fix:、perf: 为 patch,docs:、chore:、test:、refactor:、style:、ci: 不产生升级。0.x 阶段规则反转,破坏性变更升 minor 而非 major,且发布后不可回退。无法解析为约定式提交的记录需列出而非忽略。
- 发布就绪门禁:发布提交所在默认分支 CI 通过、无未解决的发布阻塞项、无可达的严重安全公告、清单版本与计算出的标签一致、锁文件同步、每个破坏性变更都有迁移说明、上一个发布不再是草稿状态;任一门禁失败即停止发布并指出具体门禁。
- 破坏性变更排序:跨版本采用 expand→migrate→contract(先并存新增、再迁移消费者、最后在后续版本移除旧路径);滚动部署中旧代码与新 schema 会短暂共存,无默认值的 NOT NULL 会破坏进行中的写入。
- 变更文档:Changelog 使用 Keep a Changelog 的 Added、Changed、Deprecated、Removed、Fixed、Security 分节,按用户可感知效果书写而非提交主题;无外部影响的内部重构可省略。Release notes 按 Highlights、破坏性变更及迁移、Fixed/Added、对比链接组织。
- 回滚与向前修复的取舍:广泛或用户可见故障、原因未明、改动自包含、未执行迁移时优先回滚;窄且已理解、修复小且明确、后续合并依赖该改动、已执行不可逆迁移时优先向前修复。不可逆迁移本身即决定取舍。应先检查功能开关,开关翻转无代码风险且可秒级反转。回滚代码不会回滚已写入新结构的数据。
限制与禁止项:不得给 CI 未通过的提交打标签;不得移动或重写已发布的标签,应发布新的 patch;不得删除已发布的 release,应取而代之;不得对共享分支执行 git reset。
该技能为发布流程规范,未提供具体命令行工具、自动执行脚本或平台集成方式,相关实现暂未提供。