SuperAPI AI 工具集

release-flow

部署与运维

查看项目

更新于 10-16 07:07

技能介绍

用途

Release Flow 用于在验证(verification)通过后,以可重复、可追溯的方式完成一次发布:升级版本号、更新 changelog、打标签,并可选创建 GitHub Release。它的核心目标是让发布过程具备可复现的发布证据,而不是手工随意操作。

主要能力与步骤

  1. 确认验证通过:拒绝在没有前置质量门禁证据的情况下发布。
  2. 检测版本来源:识别 package.json、pyproject.toml、VERSION 文件或 git tags。
  3. 预检(Preflight):以 verify 模式运行辅助程序,在任何变更发生前确认 git 清洁度、git 身份、目标标签可用性、版本来源、changelog 就绪状态、发布说明目标位置,以及可选的 gh 就绪状态。
  4. 制定发布计划:预览版本升级级别(patch、minor、major)与 changelog 条目。
  5. 执行:升级版本号、更新 changelog、创建带注释的 git 标签。
  6. GitHub Release(可选):验证 gh 认证后,用发布说明创建 Release。
  7. 报告:输出版本、标签、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 串联为可重复步骤的团队。

暂未提供的信息

关于该技能的安装命令、具体代码实现、支持平台、收费方式与价格等信息,资料中暂未提供。