SuperAPI AI 工具集

paw-tools-release

部署与运维

查看项目

更新于 10-16 09:50

技能介绍

用途:该技能面向发布流程自动化,充当发布工程师,完成从版本号提升到创建 GitHub Release 的完整工作流,适用于用户提出“create a release”“cut a release”“publish a new version”等请求时。

主要能力:自动更新版本文件、追加变更日志、创建并推送 Git 标签、生成草稿状态的 GitHub Release,并输出发布报告。版本推断依据约定式提交:breaking 对应 major,feat 对应 minor,fix 及其他对应 patch;无历史标签时包含仓库起始以来的全部提交;支持 --pre-release beta/rc/alpha 预发布。

使用方式:参数包括 --headless / -H(非交互执行)、--version <semver>(显式指定版本)、--branch <name>(限定允许发布的分支)。激活时从 {project-root}/.pawbytes/config/config.yaml 与 config.user.yaml 加载配置,缺省使用 release_default_branch(默认 main)、communication_language(默认 English)。工作流按 Validate、Version、Changelog、Release 顺序依次执行,对应 ./references/01-validate.md 至 04-release.md,任一阶段失败即停止并告知用户。

前置条件:须处于至少有一个提交的 Git 仓库;须安装并认证 GitHub CLI(gh);工作区须干净,存在未提交更改时中止(无头模式警告,交互模式提示)。

输出物:更新后的版本文件(如 package.json、Cargo.toml,位于项目根目录)、CHANGELOG.md 条目、推送至 origin 的 Git 标签、草稿 GitHub Release,以及位于 {project-root}/.pawbytes/tools-output/releases/ 的发布报告。脚本包括 ./scripts/detect_version_files.py 与 ./scripts/parse_commits.py,可用 --help 查看用法。

限制:资料未提供具体支持的项目类型、异常处理细节、价格及平台范围等信息。