writing-changelogs
Installation
SKILL.md
编写 CHANGELOG 技能
概览
CHANGELOG.md 是写给人的发布说明,不是 commit dump。
核心原则: 先确定发布边界,再从 Git 历史里提炼“用户可感知的显著变更”;任何直接输出 git log 或文件 diff 清单的做法都不合格。
何时使用
- 用户要求生成、更新或补写
CHANGELOG.md - 用户要求根据
git tag、git diff、git log生成 release notes - 准备发布新版本,需要整理
Unreleased或最近一个版本区间 - 仓库提交噪音较多,需要把多条 commit 汇总成 Keep a Changelog 条目
- 需要把
feat/fix/refactor这类技术提交改写成用户可读的变更说明
不要用于: