git-cliff 定制变更日志生成器

要解决的具体问题

团队维护 CHANGELOG.md 时，手工整理提交记录既耗时又容易遗漏。提交信息风格不统一时，人工归类 commit 的工作量随仓库规模线性增长；不同成员写出的条目格式往往不一致，最终导致 changelog 可读性差、release 说明难以评审，有时甚至与实际提交历史脱节。

核心能力与工作流程

git-cliff 直接从 Git 历史中提取提交，分两个层次处理：

• 内置 conventional commits 解析：识别 feat:、fix: 等约定式前缀，自动完成类型归类，并提取关联的 issue 引用。
• 正则自定义解析器：对不符合约定式规范的历史仓库，可用正则匹配自定义的消息格式，适配既有提交习惯。

解析完成后，通过 TOML 配置文件（如 cliff.toml）定制输出模板，控制提交分组、过滤规则和渲染格式。生成的变更日志可接入 GitHub Actions、Docker 镜像构建或 CI/CD 流水线，在发版流程中自动产出 CHANGELOG.md，不需要额外写脚本。

适用边界与注意点

• 提交历史需要大致可解析；完全混乱的提交信息即使配合正则，归类结果也不稳定。
• TOML 模板和正则规则需要针对仓库实际的消息风格调校，首次接入要花时间调试。
• 工具只负责按规则生成日志，不会强制仓库改用 conventional commits 规范。