用途:从仓库的 git 历史生成面向用户的 App Store 发布说明。它以最近一个 tag 为起点收集改动,把提交翻译成清晰、用户可读的更新条目。
主要能力:
- 收集改动:在仓库根目录运行 scripts/collect_release_changes.sh,收集提交记录与涉及的文件;可传入指定 tag 或 ref,如 scripts/collect_release_changes.sh v1.2.3 HEAD;若没有 tag,脚本回退到完整历史。
- 用户影响分诊:扫描提交和文件,识别用户可见的变化,按主题分组(New、Improved、Fixed)并去重;剔除仅内部的工作,如构建脚本、重构、依赖升级、CI。
- 起草说明:为每个面向用户的变化写简短、强调收益的条目;使用清晰动词和通俗语言,避免内部术语;除用户另有要求,建议 5 到 10 条。
- 校验:确认每条都能对应范围内真实改动;检查重复与过于技术化的措辞;对含义不清或疑似仅内部的变化,应请求澄清。
输出格式:可选标题,如 "What's New" 或产品名加版本号;仅使用项目符号列表,每条一句;如用户提供字数或字符上限,需遵守。
资源:scripts/collect_release_changes.sh 收集自上次 tag 以来的提交与改动文件;references/release-notes-guidelines.md 提供语言、过滤和质量检查规则。
适用场景:发版前整理 App Store 的版本更新文案。限制:仅依据脚本收集的 git 历史与仓库文件,需自行判断内部改动;资料未提供具体安装命令、价格或平台信息。