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. 询问版本类型

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

如果用户说"小更新"/"小版本" → 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

版本类型关键词映射

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

注意事项

• 发布前确保测试通过
• 工作区有未提交更改时先处理
• 破坏性变更必须升级 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