用途
Release Flow 用于在验证(verification)通过后,以可重复、可追溯的方式完成一次发布:升级版本号、更新 changelog、打标签,并可选创建 GitHub Release。它的核心目标是让发布过程具备可复现的发布证据,而不是手工随意操作。
主要能力与步骤
- 确认验证通过:拒绝在没有前置质量门禁证据的情况下发布。
- 检测版本来源:识别 package.json、pyproject.toml、VERSION 文件或 git tags。
- 预检(Preflight):以 verify 模式运行辅助程序,在任何变更发生前确认 git 清洁度、git 身份、目标标签可用性、版本来源、changelog 就绪状态、发布说明目标位置,以及可选的 gh 就绪状态。
- 制定发布计划:预览版本升级级别(patch、minor、major)与 changelog 条目。
- 执行:升级版本号、更新 changelog、创建带注释的 git 标签。
- GitHub Release(可选):验证 gh 认证后,用发布说明创建 Release。
- 报告:输出版本、标签、changelog 路径,以及任何被跳过步骤及原因。
输出格式
Version: <old> → <new>
Tag: v<new>
Changelog: updated | skipped (no [Unreleased] section)
Preflight: ready | blocked (reason)
GH Release: created | skipped (reason)
使用规则与限制
- 绝不在没有前置验证证据的情况下发布。
- 绝不虚构仓库未使用的版本文件或 changelog 格式。
- 在未确认认证前绝不发布制品。
- 仅当 changelog 已包含 [Unreleased] 段落时才更新它。
- 对跳过的步骤要报告原因,而不是静默失败。
适用场景
适合需要规范化发布流程的代码仓库,尤其是希望将版本升级、changelog 维护、标签创建与 GitHub Release 串联为可重复步骤的团队。
暂未提供的信息
关于该技能的安装命令、具体代码实现、支持平台、收费方式与价格等信息,资料中暂未提供。