app-store-changelog

核心用法

App Store Changelog 是一款面向移动应用开发者的自动化文档生成工具。其核心工作流程分为四步：首先通过 scripts/collect_release_changes.sh 脚本收集自上次 git 标签以来的所有提交记录和变更文件；随后对提交进行筛选，识别真正影响用户体验的改动，剔除内部重构、CI 配置、依赖升级等无用户感知的内容；接着将有效变更按「新增」「优化」「修复」三类主题归类，并转化为简洁明了的利益导向型描述；最后输出符合 App Store 字符限制规范的 bullet list 格式发布说明。用户也可指定任意 git 引用范围（如 v1.2.3 HEAD）来生成特定区间的变更日志，若仓库无标签则自动回退至完整历史记录。

显著优点

该 Skill 的最大价值在于将繁琐的手动整理工作完全自动化。传统发布说明编写需要开发者逐条审阅 commit、判断用户相关性、统一措辞风格，耗时且易遗漏。此工具通过脚本化流程将耗时从数十分钟压缩至秒级，同时内置的 release-notes-guidelines.md 参考文档确保了输出质量的一致性。其纯只读设计意味着零副作用风险，可安全嵌入 CI/CD 流水线实现发布流程的完全自动化。此外，Bash 脚本采用 set -euo pipefail 严格模式，变量均经过引号保护，代码健壮性达到生产环境标准。

潜在缺点与局限性

功能边界较为明确也带来了一定局限：该工具仅适用于基于 git 标签管理的项目，对于未使用语义化版本标签或采用其他版本控制系统的团队无法直接使用。输出质量高度依赖团队提交规范——若 commit message 混乱或缺乏描述性，生成的发布说明同样需要人工润色。此外，脚本目前仅支持标准 git 命令，对 monorepo 多包场景或复杂分支策略（如频繁 cherry-pick）的变更归属判断可能不够精准。翻译和多语言支持未在文档中提及，国际化团队可能需要额外处理。

适合的目标群体

主要面向 iOS/Android 独立开发者、中小型移动应用团队的技术负责人，以及负责应用商店运营的产品经理。特别适合已建立规范 git 工作流、追求发布流程自动化的敏捷团队。对于需要频繁迭代、每周甚至每日提交版本审核的社交、工具类应用团队，该 Skill 能显著降低运营文案负担。开源项目维护者也可借此快速生成 GitHub Release 与 App Store 双平台的同步说明。

使用风险

性能方面，在超大型仓库（数十万提交）中全历史扫描可能产生短暂延迟，建议配合标签范围使用。依赖项风险极低，仅需系统预装的 bash、git、sed 三个标准组件，无第三方包管理器依赖。需注意脚本执行环境必须具备 git 可执行权限及仓库读取权限，容器化 CI 环境中应确认基础镜像包含 git。虽为只读操作，但仍建议在正式集成前于沙盒仓库验证输出格式是否符合预期，避免因提交规范差异导致发布说明遗漏关键特性。