用途:为项目创建或更新 CHANGELOG.md,遵循 Keep a Changelog 1.1.0 格式规范。
主要能力:规定文件头、章节结构与变更类型(Added、Changed、Deprecated、Removed、Fixed、Security);版本头格式为 ## [X.Y.Z] - YYYY-MM-DD,日期用 ISO 8601;支持日期式版本 ## [YYYY-MM-DD] 与撤回版本标记 [YANKED];文件末尾提供版本对比链接;给出完整示例与写作要点。
使用方式:开发期间将变更写入 ## [Unreleased];发布时改为 ## [X.Y.Z] - YYYY-MM-DD,新建空的 Unreleased 章节并补充对比链接。条目以动词或名词开头,具体说明受影响组件或端点,可引用 issue/PR 编号,无内容的章节省略。文件名必须为 CHANGELOG.md(大写)。
适用场景:需要维护人类可读、可追溯的版本变更记录的项目;可与 Conventional Commits 及 conventional-changelog、semantic-release、release-please 等工具配合。
限制与要求:所有变更日志内容必须用英文书写,不得混用语言;禁止直接粘贴 git log;不得遗漏破坏性变更与弃用说明;不得使用有歧义的日期格式;不得只记录部分变更。GitHub Releases 可作补充但不能替代 CHANGELOG.md。README 同步为隐含操作,不应在变更日志中单独记录。官方规范见 https://keepachangelog.com/en/1.1.0/,语义化版本见 https://semver.org/spec/v2.0.0.html。