✈️ 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 种特定应用类型的检查清单：

检查清单	应用类型
all_apps.md	通用（适用于所有提交）
subscription_iap.md	订阅 / App 内购买 (IAP)
social_ugc.md	社交 / 用户生成内容 (UGC)
kids.md	儿童类别
health_fitness.md	健康、健身与医疗
games.md	游戏
macos.md	macOS / Mac App Store
ai_apps.md	AI / 生成式 AI
crypto_finance.md	加密货币、金融与交易
vpn.md	VPN 与网络工具

📖 完整准则参考：references/guidelines/README.md

工作原理

1. 识别应用类型 → 从 references/guidelines/by-app-type/ 加载匹配的检查清单。
2. 拉取元数据 → 使用 asc metadata pull --app "" --version "" --dir ./metadata（或使用 asc-metadata-sync Skill）。
3. 扫描 → 对照 references/rules/ 中的拒审规则进行扫描。
4. 报告 → 输出检测结果，包含严重程度、受影响的文件以及解决步骤。
5. 自动修复与验证 → 应用修复方案并重新运行受影响的检查项。

查看 SKILL.md 以获取完整的 AI Agent 指令。

拒审规则

所有规则均位于 references/rules/ 中，按类别组织：

元数据 (references/rules/metadata/)

规则	准则	检查内容
review_notes_new_submission	2.1	新应用提交时审核备注不完整（缺少录屏、应用目的、测试账号、外部服务说明、区域信息或监管文档）
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 和隐私政策链接

订阅 (references/rules/subscription/)

规则	准则	检查内容
missing_tos_pp	3.1.2	应用内或元数据中未提供服务条款或隐私政策
misleading_pricing	3.1.2	月度价格比实际计费金额更突出

隐私 (references/rules/privacy/)

规则	准则	检查内容
unnecessary_data	5.1.1	要求提供非必要的个人数据
privacy_manifest	5.1.1	缺少 PrivacyInfo.xcprivacy 文件

设计 (references/rules/design/)

规则	准则	检查内容
sign_in_with_apple	4.0	在“使用 Apple 登录”后再次询问姓名/电子邮件
minimum_functionality	4.2	WebView 套壳应用、屏幕少于 3 个或缺乏独特价值的应用

权限 (references/rules/entitlements/)