| name | changelog-zh |
| description | 从 conventional commits 生成中文 CHANGELOG / release notes。当用户说"生成 changelog / 出个更新日志 / 写 release notes / 这版改了啥"时触发。脚本按提交类型归类,Claude 润色成中文小节并可 prepend 到 CHANGELOG.md。 |
changelog-zh — 中文更新日志生成
把一串 conventional commits 收敛成人话版中文更新日志。
何时触发
用户说"生成 changelog / 出个更新日志 / 写 release notes / 这版改了啥"。
用法
- 归类提交(确定性脚本):
bash <skill>/bin/collect-commits.sh [from] [to]
输出 RANGE + 按类型分组(### feat (×N) / ### fix / … / ### other),已去掉类型前缀。
- 确认版本号 + 日期(问用户,或从 tag/package 推断)。
- 把分组润色成中文小节(见模板),合并琐碎项、丢掉纯内部噪音(如
chore: 改 typo 可省)。
- prepend 到
CHANGELOG.md 顶部(保留历史);没有就新建。展示给用户确认。
类型 → 中文小节映射
| conventional | 中文小节 |
|---|
| feat | ✨ 新功能 |
| fix | 🐛 修复 |
| perf | ⚡ 性能 |
| refactor | ♻️ 重构 |
| docs | 📝 文档 |
| test | ✅ 测试 |
| build / ci | 🔧 构建/CI |
含 ! 或 BREAKING | ⚠️ 破坏性变更(单独置顶) |
| other | 其它 |
模板
## [<版本>] - <YYYY-MM-DD>
### ⚠️ 破坏性变更
- <如有,置顶并说明迁移>
### ✨ 新功能
- <条目>
### 🐛 修复
- <条目>
硬规则
- 破坏性变更(commit 带
! 或正文有 BREAKING)必须单独置顶。
- 面向读者写,不是堆 commit:同类合并、删内部噪音、把缩写展开成人话。
- 不臆造没发生的改动;
other 里的非规范提交按内容归到合适小节或如实列出。
- 只读 git + 写 CHANGELOG.md,不打 tag、不发布。
边界
- 依赖 conventional commits;提交不规范时归类质量下降(other 会变多)。
- 版本号/打 tag/发 release 由用户决定,本 skill 不碰。
