$npx -y skills add lightpointventures/claude-code-starter --skill changelog当用户想生成更新日志、写 CHANGELOG、整理版本记录时使用 — 从 Git 提交历史自动生成 CHANGELOG
| 1 | # 生成更新日志 |
| 2 | |
| 3 | 从 Git 提交历史自动生成规范的 CHANGELOG。 |
| 4 | |
| 5 | ## 步骤 |
| 6 | |
| 7 | ### 1. 确定范围 |
| 8 | |
| 9 | 检查是否有已有的 CHANGELOG.md 或 Git 标签。 |
| 10 | |
| 11 | > 要生成什么范围的更新日志? |
| 12 | > - 从上次发版到现在(如果有 Git tag) |
| 13 | > - 最近 N 次提交 |
| 14 | > - 全部历史 |
| 15 | > - 指定时间范围 |
| 16 | |
| 17 | ### 2. 读取 Git 历史 |
| 18 | |
| 19 | 获取指定范围内的所有提交记录,按类型分类: |
| 20 | - **feat** → 新功能 |
| 21 | - **fix** → 修复 |
| 22 | - **docs** → 文档 |
| 23 | - **refactor** → 重构 |
| 24 | - **test** → 测试 |
| 25 | - **chore** → 其他 |
| 26 | |
| 27 | 如果提交信息不规范,根据 diff 内容智能分类。 |
| 28 | |
| 29 | ### 3. 生成 CHANGELOG |
| 30 | |
| 31 | 格式: |
| 32 | |
| 33 | ```markdown |
| 34 | ## [版本号] - 日期 |
| 35 | |
| 36 | ### 新功能 |
| 37 | - 功能描述 |
| 38 | |
| 39 | ### 修复 |
| 40 | - 修复描述 |
| 41 | |
| 42 | ### 其他 |
| 43 | - 变更描述 |
| 44 | ``` |
| 45 | |
| 46 | 规则: |
| 47 | - 从用户角度描述变更("用户现在可以..."),不是从代码角度 |
| 48 | - 合并相关的多个提交为一条记录 |
| 49 | - 忽略纯重构、代码格式化等对用户无感的变更 |
| 50 | |
| 51 | ### 4. 确认 |
| 52 | |
| 53 | > 更新日志已生成。确认后写入 CHANGELOG.md。 |
| 54 | > 版本号建议:xxx(根据变更类型推荐语义化版本) |