version-bump

est7's avatarfrom est7

升级项目版本号并提交git，支持patch/minor/major版本升级或指定具体版本号

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 9, 2026
[CI and CD]

When & Why to Use This Skill

The version-bump skill is a comprehensive automation tool designed to streamline the software release lifecycle. It enables Claude to manage semantic versioning (patch, minor, major) by automatically updating version files and CHANGELOGs, executing Git commits, and generating tags. By automating the push process, it serves as a critical bridge to trigger CI/CD pipelines, such as GitHub Actions, ensuring consistent and error-free deployments across multiple platforms.

Use Cases

  • Automated Patch Releases: Quickly increment version numbers for bug fixes and push tags to trigger immediate CI/CD builds and deployments.
  • Major Feature Launches: Manage complex version transitions by automating major or minor version bumps, ensuring all project metadata and version files are synchronized.
  • Changelog Automation: Automatically maintain project documentation by replacing 'Unreleased' headers with specific version numbers and current timestamps during the release process.
  • Custom Versioning Workflows: Deploy specific version strings for hotfixes or pre-releases while maintaining a clean Git history and automated tagging standards.
  • Cross-Platform Build Triggers: Seamlessly initiate multi-platform GitHub Actions workflows (Linux, macOS, Windows, Docker) by automating the tag-and-push sequence.
nameversion-bump
description升级项目版本号并提交git，支持patch/minor/major版本升级或指定具体版本号
version1.1.0
authorhttps://github.com/BenedictKing/claude-proxy/
allowed-toolsBash, Read, Write

版本号升级技能

指令

当用户输入包含以下关键词时，自动触发版本升级流程：

中文触发条件

  • "升级版本"、"版本号"、"发布版本"、"更新版本"、"更新版本并提交"、"提交 git" → 执行版本升级
  • "bump"、"release" → 执行版本升级

参数说明

  • 无参数或 patch: patch 版本 +1
  • minor: minor 版本 +1, patch 归零
  • major: major 版本 +1, minor 和 patch 归零
  • 具体版本号 (如 2.1.0): 直接使用该版本号

发布选项

⚠️ 重要: 默认情况下，版本升级后必须创建 tag 并推送！只有推送 tag 才能触发 GitHub Actions 自动编译发布。除非用户明确说"不要 tag"或"--no-tag"，否则始终创建并推送 tag。

  • --no-tag 或 "不要 tag": 不创建 git tag（仅提交版本变更）
  • --push 或 "并推送"、"push": 推送 commit 到远程仓库（默认行为）

项目版本文件

  • 位置: VERSION (项目根目录)
  • 格式: v{major}.{minor}.{patch}
  • 示例: v2.0.15

执行步骤

1. 读取当前版本号

cat VERSION

2. 解析并计算新版本号

根据用户指定的升级类型计算：

当前版本 升级类型 新版本
v2.0.14 patch (默认) v2.0.15
v2.0.14 minor v2.1.0
v2.0.14 major v3.0.0
v2.0.14 2.1.5 v2.1.5

3. 更新版本文件

echo "v{新版本号}" > VERSION

4. 更新 CHANGELOG.md

将 [Unreleased] 替换为新版本号和当前日期：

# 替换前
## [Unreleased]

# 替换后
## [v{新版本号}] - YYYY-MM-DD

5. 验证更新

cat VERSION
cat CHANGELOG.md | head -20

6. 查看 git 状态

git status
git diff --stat

7. 提交变更

询问用户确认提交信息后执行：

git add -A
git commit -m "chore: bump version to v{新版本号}"

8. 创建 Tag（默认必须执行）

⚠️ 除非用户明确说"不要 tag"，否则必须创建 tag！

git tag v{新版本号}

9. 推送到远程（默认必须执行）

# 推送 commit
git push origin main

# 推送 tag（触发 GitHub Actions 自动编译发布）
git push origin v{新版本号}

示例场景

场景 1：默认升级 patch 版本

用户输入: "升级版本号并提交" 或 "更新版本并推送"

自动执行流程:

  1. 读取 VERSION: v2.0.14
  2. 计算新版本: v2.0.15
  3. 更新 VERSION 文件
  4. 执行 git commit
  5. 创建 git tag: v2.0.15
  6. 推送 commit 和 tag 到远程

场景 2：升级 minor 版本

用户输入: "升级 minor 版本"

自动执行流程:

  1. 读取 VERSION: v2.0.14
  2. 计算新版本: v2.1.0
  3. 更新 VERSION 文件
  4. 执行 git commit

场景 3：指定具体版本

用户输入: "版本号改为 3.0.0"

自动执行流程:

  1. 读取 VERSION: v2.0.14
  2. 使用指定版本: v3.0.0
  3. 更新 VERSION 文件
  4. 执行 git commit

场景 4：发布新版本（完整流程）

用户输入: "发布新版本并打 tag 推送"

自动执行流程:

  1. 读取 VERSION: v2.0.29
  2. 计算新版本: v2.0.30
  3. 更新 VERSION 文件
  4. 执行 git commit
  5. 创建 git tag: v2.0.30
  6. 推送 commit 和 tag 到远程
  7. GitHub Actions 自动触发，编译 6 平台版本并发布到 Releases

场景 5：仅打 tag（不升级版本）

用户输入: "给当前版本打 tag 并推送"

自动执行流程:

  1. 读取当前 VERSION: v2.0.29
  2. 创建 git tag: v2.0.29
  3. 推送 tag 到远程

输出格式

基础版本升级

版本升级完成:
- 原版本: v2.0.14
- 新版本: v2.0.15
- 升级类型: patch

是否提交 git? (Y/n)

完整发布流程

版本升级完成:
- 原版本: v2.0.29
- 新版本: v2.0.30
- 升级类型: patch

✅ Git commit 已创建
✅ Git tag v2.0.30 已创建

是否推送到远程仓库? (Y/n)
  - 推送后将自动触发 GitHub Actions
  - 自动编译 Linux/Windows/macOS 版本
  - 自动发布到 GitHub Releases

GitHub Actions 集成

当推送 v* 格式的 tag 时，会自动触发以下 workflow：

Workflow Runner 产物
release-linux.yml ubuntu-latest claude-proxy-linux-amd64, claude-proxy-linux-arm64
release-macos.yml macos-latest claude-proxy-darwin-amd64, claude-proxy-darwin-arm64
release-windows.yml windows-latest claude-proxy-windows-amd64.exe, claude-proxy-windows-arm64.exe
docker-build.yml ubuntu-latest Docker 镜像 (阿里云容器镜像服务, linux/amd64 + linux/arm64)

Concurrency 配置

每个 release workflow 使用独立的 concurrency group，确保三个平台并行编译：

concurrency:
  group: ${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: false
  • ${{ github.workflow }} 使用 workflow 名称作为前缀，避免不同平台的构建相互阻塞
  • cancel-in-progress: false 确保发布构建不会被取消

发布内容

  • 6 个平台的可执行文件（三平台并行构建）
  • 自动生成的 Release Notes
  • Docker 镜像（推送到阿里云容器镜像服务）
  • 发布为 draft 模式，需手动确认发布

注意事项

  • 版本号格式为 v{x}.{y}.{z}（无后缀）
  • 提交前会显示所有待提交的变更供用户确认
  • 如果有其他未提交的变更，会一并提交
  • 遵循 Conventional Commits 规范，使用 chore: bump version 格式
  • 推送 tag 后，GitHub Actions 需要几分钟完成编译和发布
  • 可以在 GitHub Actions 页面查看构建进度