✈️ App Store Preflight

这是一个 AI agent skill，用于在提交 iOS/macOS 项目前进行预检查，以捕捉导致 App Store 被拒的常见错误。

概述

Preflight 旨在帮助开发者在提交应用之前发现潜在的 App Store 审核准则违规项。它通过扫描你的 Xcode 项目、源代码、元数据和配置文件，标记出那些经常导致 Apple 拒绝审核的问题。

此 skill 与 asc CLI (brew install asc) 和 ASC CLI Skills 集成，用于拉取和检查 App Store 元数据。

大多数元数据示例假设采用了 asc metadata pull 导出的规范化 JSON 布局。如果你是从 fastlane 元数据开始，请调整路径示例，或先拉取规范的 asc 布局。

npx skills add truongduy2611/app-store-preflight-skills

references/guidelines/ 目录包含了全部 100 多条 Apple 审核准则的完整索引，以及 10 个特定于应用类型的检查清单：

识别应用类型 → 从 references/guidelines/by-app-type/ 加载匹配的检查清单。
拉取元数据 → 使用 asc metadata pull --app "" --version "" --dir ./metadata（或使用 asc-metadata-sync skill）。
扫描 → 对照 references/rules/ 中的拒绝规则进行扫描。
报告 → 报告发现的问题，包括严重程度、受影响的文件以及解决方法。
自动修复 + 验证 → 应用修复方案并重新运行受影响的检查。

详情请参阅 SKILL.md 以获取完整的 AI agent 指令。

所有规则都存放在 references/rules/ 中，按类别组织：

规则	准则	捕获内容
competitor_terms	2.3.1	Android、Google Play 及其他竞争对手品牌
apple_trademark	5.2.5	图标中的 Apple 设备图片、滥用 Apple 商标
china_storefront	5	OpenAI/ChatGPT/Gemini 相关引用（中国区）
accurate_metadata	2.3.4	应用预览视频中的设备边框
subscription_metadata	3.1.2	缺失服务条款 (ToS)/EULA 和隐私政策链接

规则	准则	捕获内容
missing_tos_pp	3.1.2	应用/元数据中没有服务条款或隐私政策
misleading_pricing	3.1.2	月度价格比实际账单金额更突出

规则	准则	捕获内容
unnecessary_data	5.1.1	要求提供不相关的个人数据
privacy_manifest	5.1.1	缺失 `PrivacyInfo.xcprivacy`

规则	准则	捕获内容
sign_in_with_apple	4.0	在使用“通过 Apple 登录”(SIWA) 后询问姓名/电子邮件
minimum_functionality	4.2	WebView 包装器、少于 3 个页面的应用、无独特价值

规则	准则	捕获内容
unused_entitlements	2.4.5(i)	Xcode 项目中未使用的权限 (Entitlements)

在相应的目录下创建一个 .md 文件。