用途:在功能或修复刚落地时,向根目录 CHANGELOG.md 的 ## [Unreleased] 下添加一条面向用户的变更记录,而不是在发布时从提交历史中抓取。
主要能力:按 Added(用户可见的新功能)、Changed(现有功能行为变化)、Fixed(缺陷修复)三类子标题归类;每条写成一行、现在时,描述对用户的影响而非实现或文件路径;跳过纯内部改动(重构、依赖、CI、测试),除非影响用户体验;每条链接对应 PR(而非 issue);为贡献者署名致谢。
使用方式:打开根目录 CHANGELOG.md,在 ## [Unreleased] 下对应子标题添加一条 bullet。查找贡献者 handle:已有 PR 时运行 gh pr view --json author --jq .author.login;尚无 PR 时运行 gh api user --jq .login。若 handle 不是 bholmesdev,在链接前加 Thanks @handle!(本人贡献)或 Thanks @handle for the suggestion!(bholmesdev 落地他人 issue)。仅当子标题至少有一条条目时才创建该子标题,空脚手架子标题保持原样留给下一条。条目保留在 Unreleased,直到 /release 将其提升到版本标题下。
适用场景:收尾一个功能或修复时,或被要求记录变更内容时,可独立调用。
限制:资料未提供更多平台、收费或效果信息。