
关于
从上一个 Tag 以来的 Git 历史生成面向用户的 App Store 发布说明。
name: app-store-changelog description: 从 git 历史记录生成面向用户的 App Store 发布说明(自上一个标签以来)。 risk: safe source: "Dimillian/Skills (MIT)" date_added: "2026-03-25"
App Store 更新日志
概述
从上一个标签以来的 git 历史记录中生成全面的、面向用户的更新日志,然后将提交记录转化为清晰的 App Store 发布说明。
使用场景
- 当用户需要从 git 历史记录生成 App Store "新功能"文本或发布说明时。
- 当你需要将原始提交记录转化为简洁的、面向用户的发布要点时。
工作流程
1) 收集变更
- 从仓库根目录运行
scripts/collect_release_changes.sh来收集提交记录和涉及的文件。 - 如需指定特定标签或引用:
scripts/collect_release_changes.sh v1.2.3 HEAD。 - 如果没有标签,脚本将回退到完整历史记录。
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.219refactor(network): extract URLSession wrapper into moduleci: 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 说明的语言、过滤和质量检查规则。
限制
- 仅在任务明确符合上述范围时使用此技能。
- 不要将输出视为特定环境验证、测试或专家审查的替代品。
- 如果缺少必要的输入、权限、安全边界或成功标准,请停下来要求澄清。
兼容工具
Claude CodeCursor
标签
移动端
