使用说明

核心用法

app-store-changelog 技能通过脚本 scripts/collect_release_changes.sh 自动收集自上一个 Git 标签以来的提交记录和修改文件，智能筛选用户可见的变更（如新增功能、体验优化、问题修复），并生成符合 App Store 风格的发布说明。支持指定自定义标签范围，无标签时自动回退到完整历史。

显著优点

自动化程度高：一键从 Git 历史提取变更，无需手动整理提交日志
用户视角过滤：内置规则自动剔除内部重构、CI 配置、依赖升级等技术债务类提交
结构化输出：按「New / Improved / Fixed」主题分组，符合主流应用商店规范
长度可控：默认 5-10 条要点，适配 App Store 字符限制

潜在缺点或局限性

依赖本地脚本 collect_release_changes.sh，若脚本缺失或环境不兼容则无法执行
自动过滤可能误伤：某些「内部」提交可能含用户可见副作用，需人工复核
语义理解有限：基于文件路径和提交信息关键词过滤，无法理解代码实际影响
多语言支持未提及：生成的发布说明为英文，需额外本地化流程

适合人群

iOS/Android 开发团队的产品经理或技术运营，需定期维护应用商店页面
追求发布流程自动化的敏捷团队，希望减少手动整理变更日志的工作量
开源项目维护者，希望向终端用户提供简洁的更新摘要

常规风险

信息泄露风险：若过滤规则不完善，可能意外暴露内部系统架构或安全修复细节
版本追溯误差：基于 Git 标签计算范围，若标签管理混乱（如轻量标签与附注标签混用）可能导致变更遗漏或重复
合规风险：App Store 审核对「What's New」内容有虚假宣传限制，自动化生成后仍需人工合规审查

安全解读

核心功能

app-store-changelog 是一个文档型 Skill，旨在帮助开发者将 git 提交历史转化为面向终端用户的 App Store 发布说明。其工作流程分为四步：收集变更（通过本地脚本扫描自上个标签以来的提交）、筛选用户可见改动、按主题分类（新增、优化、修复）、最终生成简洁的 bullet list 格式文案。

显著优点

自动化提效：省去手动整理提交日志的繁琐工作，特别适合敏捷迭代频繁的团队。
用户视角转换：内置过滤机制自动剔除内部重构、CI 配置、依赖升级等技术债务类提交，确保输出内容聚焦用户价值。
结构化输出：强制按 "New/Improved/Fixed" 分类，符合主流应用商店的内容规范，降低上架审核风险。
零配置风险：纯 Markdown 文档型 Skill，无可执行代码、无网络调用、无第三方依赖，部署即安全。

潜在局限

依赖本地环境：需要项目已配置 git 标签，且需手动运行 scripts/collect_release_changes.sh，对无标签历史的新项目不够友好。
语义理解有限：自动过滤逻辑可能误删有意义的变更（如性能优化被归类为内部重构），需人工复核。
语言本地化：未内置多语言支持，非英语市场需额外翻译。
格式单一：仅输出 bullet list，无法直接生成富文本或分段长文，复杂版本需二次编辑。

适合人群

独立开发者或小型团队，缺乏专职产品经理撰写上架文案。
采用语义化版本控制（SemVer）并频繁发版的移动应用团队。
追求流程标准化、希望减少人工 copywriting 成本的工程驱动型组织。

常规风险

内容准确性：自动化摘要可能丢失关键上下文，建议作为初稿使用，上架前务必人工审校。
合规边界：虽本身不触碰用户数据，但若未来版本扩展为云端服务或集成 AI 生成，需重新评估数据隐私合规性。

git release-management app-store automation changelog developer-productivity ios android

App Store Changelog 内容

references文件夹

scripts文件夹

手动下载zip · 2.7 kB

release-notes-guidelines.mdtext/markdown

请选择文件