SuperAPI AI 工具集

git-release

通用与其它

查看项目

更新于 10-16 09:32

技能介绍

用途:git-release 是面向代码仓库的发布管理技能,依据 conventional commits 自动生成变更日志、更新版本文件并发布 GitHub Release,适合需要按语义化版本规范发版的开发者。

主要能力:收集上次 tag 以来的提交并解析类型、scope 与破坏性变更;按 major>minor>patch 规则推断版本升级(支持 --major、--minor、--patch 强制指定);按 Keep a Changelog 格式生成 CHANGELOG.md;更新 package.json、package-lock.json、pyproject.toml、Cargo.toml、VERSION、setup.cfg、build.gradle 等版本文件;执行提交、打 tag、推送,并用 gh release create 发布 GitHub Release。

使用方式:默认执行完整发布流程;--dry-run/-n 仅预览;--no-github 跳过 GitHub Release;--changelog-only 只更新 CHANGELOG.md。发布前需工作区干净、分支与远程状态符合预期,使用 gh 前需通过 gh auth status,否则需先执行 brew install gh 与 gh auth login。流程在 Phase 4 展示摘要并要求用户确认,Phase 5 才写入改动,且不跳过 hooks、不使用 --no-verify。

适用场景:具备 conventional commits 习惯、使用 Git 与 GitHub 的单仓库项目发版,以及开发期仅维护变更日志草稿。

限制:无 conventional commits 时默认按 patch 处理并归入 Other Changes;预发布 0.x.y 遵循 1.0 前语义化规则;monorepo 仅更新根 package.json 并提示其他版本文件;工作树脏、无远程、tag 已存在或 changelog 写入校验失败时会中止;GitHub 发布失败需修复后仅重试 gh release create,删除远程 tag 需用户明确确认。其他收费、平台与效果信息暂未提供。