SuperAPI AI 工具集

release-process

通用与其它

查看项目

更新于 10-16 05:49

技能介绍

该技能用于指导维护者为 Cloud Foundation Fabric(CFF)仓库切出新版本。前提是拥有仓库写/发布权限、有效的 GitHub Token(可用 gh auth token 获取),并能使用 uv 或装有 tools/requirements.txt 的 Python 虚拟环境运行工具。发布名称与标签必须以 v 前缀开头,例如 v55.1.0、v56.0.0。

流程:先从 master 分支拉取最新代码,并从 default-versions.tf 提取最新发布版本号;再运行 changelog.py 生成变更日志,需指定 bump 类型(major、minor、patch)与 release-from,命令为 uv run tools/changelog.py --release-from $LATEST_RELEASE --bump $BUMP_TYPE --write --token $(gh auth token),之后用 git diff CHANGELOG.md 检查,发现缺失标签或标题问题需到 GitHub 修正后重跑;接着从 CHANGELOG.md 顶部提取新版本号(补 v 前缀),运行 uv run tools/versions.py --fabric-release $NEW_RELEASE --write-defaults 提升版本;随后提交并推送 CHANGELOG.md 与 default-versions.tf,提交信息为 prep $NEW_RELEASE,并等待 master 上的 GitHub Actions 工作流成功,可用 gh run watch 监控。

最后创建 GitHub Release:可自动用 gh release create 并向用户展示提取出的 BREAKING CHANGES、等待批准后发布,或在 GitHub UI 手动创建标签、标题、生成发布说明并把 BREAKING CHANGES 粘贴到顶部并改为 ## Breaking Changes 后发布。限制:需具备权限与 Token,流程依赖仓库脚本与 Actions,未提供其他替代方式或失败回滚说明。