changelog-gen

1# Changelog 自动生成
2 
3## 触发条件
4当用户要求生成 changelog、更新日志、版本记录、release notes 时激活此技能。
5 
6## 工作流程
7 
8### 第 1 步：获取 Git 历史
9```bash
10# 先获取最近的 tag，再用 revision range 查询
11git describe --tags --abbrev=0
12git log --oneline <last-tag>..HEAD
13 
14# 或指定范围
15git log --oneline v1.0.0..HEAD
16 
17# 仓库没有 tag 时，明确选择起始提交或查看全部历史
18git log --oneline
19```
20 
21### 第 2 步：分类提交
22按 Conventional Commits 分类：
23 
24| 分类 | Type 标识 | 图标 |
25|------|----------|------|
26| 新功能 | `feat` | ✨ |
27| Bug 修复 | `fix` | 🐛 |
28| 文档 | `docs` | 📝 |
29| 重构 | `refactor` | ♻️ |
30| 性能优化 | `perf` | ⚡ |
31| 测试 | `test` | 🧪 |
32| 构建/工具 | `chore` | 🔧 |
33| Breaking Changes | 含 `BREAKING CHANGE:` 或 `!` | ⚠️ |
34| 安全修复 | `fix(security)` 或含 CVE | 🔒 |
35| 依赖更新 | `deps` 或 `chore(deps)` | 📦 |
36 
37### 第 3 步：版本号确定策略
38 
39遵循 Semantic Versioning 规则：
40 
41| 变更类型 | 版本变化 | 示例 |
42|---------|---------|------|
43| Breaking Changes | 主版本 +1 | 1.2.0 → 2.0.0 |
44| 新功能 (feat) | 次版本 +1 | 1.2.0 → 1.3.0 |
45| Bug 修复 (fix) | 修订版本 +1 | 1.2.0 → 1.2.1 |
46| 安全修复 (fix(security)) | 修订版本 +1（紧急发布） | 1.2.0 → 1.2.1 |
47 
48**判断依据**：
49- 提交信息含 `BREAKING CHANGE:` 或 type 后加 `!`（如 `feat!:`）→ 主版本
50- 存在 `feat` 提交 → 次版本
51- 仅 `fix`/`docs`/`chore` 等 → 修订版本
52 
53### 第 4 步：生成 CHANGELOG
54 
55## 输出格式
56 
57```markdown
58# Changelog
59 
60## [1.3.0] - 2026-06-17
61 
62### ⚠️ Breaking Changes
63- 移除废弃的 `/api/v1/users` 端点，统一使用 `/api/v2/users` (#130)
64 
65### ✨ 新功能
66- 新增用户认证模块 (#123)
67- 支持 OAuth2 登录 (#124)
68- 新增批量导出功能 (#128)
69 
70### 🔒 安全修复
71- 升级 lodash 修复原型污染漏洞 CVE-2025-XXXX (#129)
72 
73### 🐛 Bug 修复
74- 修复分页查询偏移量错误 (#125)
75- 修复并发写入导致的数据竞争 (#127)
76 
77### ⚡ 性能优化
78- 优化大列表渲染性能，减少 50% 内存占用 (#126)
79 
80### 📝 文档
81…