Documentation
README
Changelog 自动生成
触发条件
当用户要求生成 changelog、更新日志、版本记录、release notes 时激活此技能。
工作流程
第 1 步:获取 Git 历史
# 先获取最近的 tag,再用 revision range 查询
git describe --tags --abbrev=0
git log --oneline <last-tag>..HEAD
# 或指定范围
git log --oneline v1.0.0..HEAD
# 仓库没有 tag 时,明确选择起始提交或查看全部历史
git log --oneline
第 2 步:分类提交
按 Conventional Commits 分类:
| 分类 | Type 标识 | 图标 |
|---|---|---|
| 新功能 | feat |
✨ |
| Bug 修复 | fix |
🐛 |
| 文档 | docs |
📝 |
| 重构 | refactor |
♻️ |
| 性能优化 | perf |
⚡ |
| 测试 | test |
🧪 |
| 构建/工具 | chore |
🔧 |
| Breaking Changes | 含 BREAKING CHANGE: 或 ! |
⚠️ |
| 安全修复 | fix(security) 或含 CVE |
🔒 |
| 依赖更新 | deps 或 chore(deps) |
📦 |
第 3 步:版本号确定策略
遵循 Semantic Versioning 规则:
This is the opening of the README. Read the full README on GitHub.