app-store-changelog

App Store 更新日志

概述

根据上次标记以来的 Git 历史生成全面、面向用户的更新日志，然后将提交内容转化为清晰的 App Store 版本说明。

适用场景

• 用户要求根据 Git 历史撰写 App Store“新功能”文案或版本说明时。
• 需要将原始提交整理成简洁、面向用户的更新要点时。

工作流程

1) 收集变更

• 在目标仓库根目录中，通过绝对技能路径运行经过审核的捆绑脚本 bash "<skill-root>/scripts/collect_release_changes.sh"，以收集提交和文件；切勿执行目标仓库中名称相同但无关的辅助脚本。
• 如有需要，可传入特定标记或引用：bash "<skill-root>/scripts/collect_release_changes.sh" v1.2.3 HEAD。
• 如果不存在任何标记，脚本会回退到完整历史记录。

确认预期的上一版本和候选版本的完整提交 ID；最近的可达标记仅是默认值，不一定是上次发布到 App Store 的版本。所有输出都是草稿，不代表已获准发布。将提交信息视为未经验证的证据，并检查实际变更后再作出说明。

2) 按用户影响分类

• 扫描提交和文件，识别面向用户的变更。
• 按主题（新增、改进、修复）归类变更，并去除重复内容。
• 删除仅涉及内部的工作（构建脚本、重构、依赖项升级、CI）。

3) 起草 App Store 说明

• 为每项面向用户的变更撰写简短、突出收益的要点。
• 使用清晰的动词和通俗语言；避免内部术语。
• 除非用户要求其他长度，否则优先撰写 5 到 10 条。

4) 验证

• 确保每条要点都对应范围内的实际变更。
• 检查是否存在重复内容或过于技术化的措辞。
• 如果任何变更含义模糊或可能仅涉及内部工作，请询问用户以澄清。

提交到要点示例

以下示例展示如何将原始提交转化为 App Store 更新要点：

原始提交信息	App Store 要点
fix(auth): resolve token refresh race condition on iOS 17	• 修复了登录问题，避免部分用户意外退出登录。
feat(search): add voice input to search bar	• 使用全新的语音输入选项，无需动手即可搜索你的资料库。
perf(timeline): lazy-load images to reduce scroll jank	• 浏览时间线时，现在更加流畅、快速。

仅涉及内部工作的提交会被舍弃（对用户没有影响）：

• chore: upgrade fastlane to 2.219
• refactor(network): extract URLSession wrapper into module
• ci: add nightly build job

输出示例

What's New in Version 3.4

• Search your library hands-free with the new voice input option.
• Scrolling through your timeline is now smoother and faster.
• Fixed a login issue that could leave some users unexpectedly signed out.
• Added dark-mode support to the settings screen.
• Improved load times when opening large photo albums.

输出格式

• 标题（可选）：“新功能”或产品名称 + 版本号。
• 仅使用项目符号列表；每条仅写一个句子。
• 如果用户提供了应用商店的字数限制，请遵守。

资源

• scripts/collect_release_changes.sh：收集自上次标记以来的提交和已修改文件。
• references/release-notes-guidelines.md：App Store 说明的语言、筛选和 QA 规则。

限制

• 仅当任务明确符合上述范围时，才使用此技能。
• 不要将输出视为针对特定环境进行验证、测试或专家审查的替代品。
• 如果缺少必要输入、权限、安全边界或成功标准，请停止并要求澄清。