用途:根据近期开发工作更新 CHANGELOG.md,把用户能感知的变更整理成更新日志条目。
输入:可选起始参考,可以是日期(YYYY-MM-DD)或提交哈希;可选末尾附加参数“-- <additional context>”,用于影响条目分组、强调重点或版本叙述方式。若未提供起始参考,则查看上次更新日志之后的提交。
主要流程:先读取 CHANGELOG.md 了解现有格式与上次更新时间;再用 git log --format="%h %s" --since="1 month ago" 或 git log --oneline <commit>..HEAD 收集近期提交;随后过滤与去重,仅保留用户可感知的功能、缺陷修复、性能改进,跳过重构、测试、chore、CI、文档等内部改动,并与已有条目比对,避免重复;接着按 Features、Improvements、Bug Fixes、Performance 等分类撰写条目。
写作规则:使用主动语态;描述用户能做什么不同的事,而非实现细节;加粗功能名称,格式为“功能名 - 简述”;每条一行;同一功能的多个提交合并为一条。最后在标题后新增“## Month Year”区段及分类列表,并校验只含面向用户的变更、无技术术语、格式一致、与已有内容不重复。
使用方式:以斜杠命令调用,如 /forge-update-changelog、/forge-update-changelog 2025-01-01,或附加 -- 说明额外上下文。
适用场景:合并 PR 后、完成发布后,或需要记录近期变更时。限制:仅依据提交与现有日志生成,不提供的功能、收费、平台、效果等信息暂未提供;依赖本地 git 历史与已存在的 CHANGELOG.md。