用途:把 git 历史转换为面向用户的商店发布说明,分别适配 App Store(≤4000 字符)与 Google Play(≤500 字符),并在输出前校验字符数。
主要能力:屏蔽内部提交(chore、refactor、ci、build、test、依赖升级、配置变更),静默省略内部 SDK 更新,合并同一功能的多个提交,用收益语言表达(如“更快的结账”而非“重构购物车服务”),每条一个句子、仅用要点、说明内不加标题与段落,并按“新增/改进/修复”分组。
使用方式:先运行 git log <last-tag>..HEAD --oneline(或使用提供的提交列表),无 tag 时用完整历史;扫描提交与涉及文件后按主题分组,剔除仅内部改动;App Store 草拟 5–10 条面向用户的要点,可选 What's New in [Version] 标题;Google Play 压缩至 ≤500 字符,优先 3–5 项影响最大的用户可见变更;逐商店统计字符、核对每条要点对应真实提交并去除术语。
适用场景:生成 App Store 与 Google Play 的发布说明;当输入恰有三项用户可见变更加一项内部 SDK 更新时,只返回三条用户要点且不出现 SDK 术语。
限制:不使用 refactor、migrated、deprecated、PR、hotfix 或内部工单编号等术语;不出现 chore 类要点;不把多项变更捆成一条;Play 说明超限时须截断重写后再返回。
补充:更详细的提交到要点映射方式,资料仅给出“Commit-to-Bullet Examples”参考,未提供具体内容。