用途:在更新仓库变更日志前使用,把最近一次发布到当前版本(main)之间尚未纳入的变更补充进变更日志。若 CHANGELOG.md 不存在,则使用 CHANGELOG。
主要能力与流程:1) 确定基线版本,未提供时用 git describe --tags --abbrev=0 取最近 git tag;2) 用 git log <baseline-version>..HEAD 收集提交;3) 读取现有变更日志,检查未纳入的变更并添加,始终只加到 Unreleased 段落;若尚无该段落,按现有风格在顶部新增(如 ## Unreleased 或 ## [Unreleased])。
写作规则:只记录影响用户的显著变更(功能、修复、破坏性变更);有 PR 时标注 #NUMBER,不写原始提交哈希;忽略拼写修正、内部重构、次要文档更新等;相关变更可合并;按重要性排序:破坏性变更、功能、修复。使用有效 Markdown,条目以过去式动词或描述性短语开头,简洁但可理解,用 * 或 - 列表,代码引用用反引号。
限制与注意:若已有 Unreleased 内容则追加而非替换;保留现有风格与格式;若默认分支名不同,以该分支为当前版本;不确定是否显著时倾向纳入。资料未提供安装命令、收费或平台信息。