SuperAPI AI 工具集

user-changelog

通用与其它

查看项目

更新于 10-15 21:43

技能介绍

用途:按周把 Git 提交整理成面向最终用户的发布说明,用德语要点写入项目中的 docs/user-changelog.md,只记录用户能看到、能做到或能察觉的变化,不做技术性变更日志。

主要能力:每次运行在文件顶部新增一节,SHA 边界写在标题中,无需单独状态文件;从提交主题与正文判断相关性,必要时才查看 diff;可将同一可见变更的多个提交合并为一条要点;空周期也会写入“Keine nutzerrelevanten Änderungen in diesem Zeitraum.”并更新边界。

使用方式:先解析上次 SHA 边界,首次运行需用户提供起始 SHA、标签或范围,不可猜测;用 git log "${FROM}".. --no-merges --reverse --format='%h%n%s%n%b%n---' 获取提交列表;按主题与正文筛选,跳过合并提交,通常忽略 Dependabot、仅 CI、格式与 lint 提交;用德语主动语态写要点,可按区域加前缀(如 Karte:、Export:、Anmeldung:),不写 issue/PR 编号、作者名或 SHA;将新节前置到文件顶部,日期用运行日期;仅在用户明确要求时提交,提交信息用英文,文件内容保持德语。

适用场景:需要向非技术用户说明产品变化的项目,尤其德语用户;monorepo 中全仓库共用一个文件,用区域前缀区分包或界面。

限制:首次运行必须由用户提供起始边界;不重复已覆盖主题;文件过长时可将旧节移至 docs/archive/user-changelog-YYYY.md,顶部节及其 bis SHA 仍作为下次运行的锚点;提交前按 finish-work 运行 bun run check。