This Claude skill automates the end-to-end Git release workflow, streamlining version management through semantic versioning (SemVer). It eliminates manual overhead by automatically generating standardized CHANGELOGs based on Angular commit conventions, creating Git tags, and synchronizing releases with remote repositories to ensure a consistent and error-free deployment process.

When should I use git-release?

git-release is useful in the following scenarios: • Automating version bumps (major, minor, patch) for software projects to maintain strict Semantic Versioning compliance. • Generating professional, categorized CHANGELOGs automatically from commit history to improve project transparency and documentation. • Standardizing the production release process by automating Git tagging and remote pushes, reducing the risk of manual configuration errors. • Streamlining developer workflows by handling pre-release checks, such as verifying workspace status and uncommitted changes before a release.

name	git-release
description	\|

Git Release Skill

自动化 Git 项目版本发布流程。

重要：必须询问版本类型

在执行发布前，必须使用 AskUserQuestion 工具询问用户版本升级类型：

问题：本次发布是什么类型的版本升级？

选项：
- patch (补丁版本) - Bug 修复、小改动 (例: 1.0.0 → 1.0.1)
- minor (小版本) - 新功能、向后兼容 (例: 1.0.0 → 1.1.0)
- major (大版本) - 破坏性变更、重大更新 (例: 1.0.0 → 2.0.0)

除非用户在请求中已明确指定版本类型（如"大版本更新"、"patch release"），否则必须询问。

发布流程

1. 检查前置条件

# 确认工作区状态
git status --porcelain

# 确认当前分支
git branch --show-current

# 获取当前版本号
grep '"version"' package.json

# 获取最新 tag
git describe --tags --abbrev=0 2>/dev/null || echo "无现有 tag"

2. 询问版本类型

必须询问用户，提供以下选项：

类型	描述	版本变化示例
patch	补丁版本：Bug 修复、文档更新、小改动	1.2.3 → 1.2.4
minor	小版本：新功能、向后兼容的改进	1.2.3 → 1.3.0
major	大版本：破坏性变更、API 重构	1.2.3 → 2.0.0

如果用户说"小更新"/"小版本" → minor 如果用户说"大更新"/"大版本" → major 如果用户说"修复"/"补丁" → patch

3. 处理未提交更改

如果工作区有未提交更改，询问用户：

先提交再发布（推荐）
先 stash 再发布
取消发布

4. 更新版本号

# 使用脚本升级版本
bash scripts/bump-version.sh <patch|minor|major>

或手动更新 package.json 中的 version 字段。

5. 生成 CHANGELOG

按 Angular 规范分组 commits（见 references/angular-commit.md）：

## [X.Y.Z] - YYYY-MM-DD

### Breaking Changes
- 破坏性变更描述

### Features
- feat(scope): description

### Bug Fixes
- fix(scope): description

6. 提交发布

git add package.json CHANGELOG.md
git commit -m "chore(release): vX.Y.Z"
git tag -a vX.Y.Z -m "Release vX.Y.Z"

7. 推送到远程

询问用户是否推送，确认后执行：

git push origin <branch>
git push origin vX.Y.Z

版本类型关键词映射

用户可能使用的表达方式：

用户说	版本类型
大版本、大更新、重大更新、breaking	major
小版本、小更新、新功能、feature	minor
补丁、修复、bugfix、hotfix、小改动	patch

注意事项

发布前确保测试通过
工作区有未提交更改时先处理
破坏性变更必须升级 major 版本
Tag 命名统一使用 vX.Y.Z 格式
首次发布建议从 0.1.0 或 1.0.0 开始

参考文档

Angular Commit 规范: 见 references/angular-commit.md
语义化版本指南: 见 references/semver-guide.md
CHANGELOG 模板: 见 assets/CHANGELOG.template.md

git-release

When & Why to Use This Skill

Use Cases