app-store-preflight-skills

app-store-preflight-skills 概览

app-store-preflight-skills 是一款面向 iOS 和 macOS 项目的 App Store 提交前审核检查技能。它会从 Apple 指南、元数据规则、隐私要求、entitlements、订阅以及常见设计问题等多个维度帮你提前排查被拒风险，避免在上传后才踩坑。它的核心任务不是“帮你写 App Store 文案”，而是帮助真正交付 Xcode 项目的团队减少审核惊喜。

最适合的场景：前端与应用发布流程

app-store-preflight-skills skill 对那些使用 Swift、SwiftUI 或混合应用代码、并且需要一个实用发布关口的前端开发团队最有价值。它尤其适合在被拒之后、首次提交之前，或你需要在不逐页手工通读每条指南的情况下，快速审计元数据和配置时使用。

它的不同之处

app-store-preflight-skills 指南是按应用类型和被拒类别来组织的，所以你可以直接加载对应的检查清单，而不是靠猜。它也很适合配合 asc 拉取到的元数据一起使用，这让它比那种只孤立检查代码的通用提示词更有可操作性。

什么时候值得安装

如果你想要一个可重复执行的 App Store 提交前检查流程，下面这些场景很适合安装这个技能：

• 按应用类型检查 Apple 指南是否符合
• 审查 privacy manifest 和 entitlements
• 验证订阅和 IAP 元数据
• 准备审核备注并梳理被拒原因

如何使用 app-store-preflight-skills 技能

安装并设置审核上下文

按 app-store-preflight-skills install 的标准安装流程执行：
npx skills add truongduy2611/app-store-preflight-skills --skill app-store-preflight-skills

在运行这个技能之前，先确认你能同时查看仓库内容和 App Store 元数据。这个仓库需要 asc CLI 访问权限，并且有些示例默认你能用 jq 搜索 JSON 输出。

先提供正确的输入

想要更好的 app-store-preflight-skills usage，先把这些信息给到技能：

• 应用平台：iOS、macOS 或两者兼有
• 应用类别：订阅、儿童、健康、游戏、社交、AI、VPN 等
• 发布阶段：新提交、更新，或被拒后的修复
• 元数据来源：asc metadata pull 输出或等效内容
• 重点问题：隐私、entitlements、登录、IAP、内容、商标

差的请求是“帮我检查我的 app”。更好的说法是：“请审计这个 SwiftUI iOS app 的 App Store 被拒风险，重点检查订阅元数据、privacy manifest 和登录要求。请使用 all-app 清单加 subscription_iap。”

按有用的顺序阅读仓库

想最快上手，建议按这个顺序看：

1. SKILL.md：工作流和前置条件
2. references/guidelines/by-app-type/all_apps.md
3. references/guidelines/by-app-type/ 中与应用类型匹配的清单
4. references/rules/ 中相关的规则文件
5. README.md：仓库层面的说明框架

如果你在处理元数据，先看 references/rules/metadata/accurate_metadata.md，再补上与你的 app 相匹配的订阅或隐私规则。

用工作流，不要只发一次性提示词

一个实用的 app-store-preflight-skills usage 模式是：

1. 识别你的应用类型
2. 加载通用清单
3. 再加一个专项清单
4. 检查元数据和配置文件
5. 将结果与审核规则逐条对照
6. 在提交前改写审核备注或发布条目

这样可以让技能聚焦在审核风险上，而不是泛泛地做代码点评。

app-store-preflight-skills 技能 FAQ

app-store-preflight-skills 只适用于 App Store 提交吗？

是的，这正是它的主要定位。需要 Apple 审核准备、被拒排查，或者基于指南做发布审计时，用它最合适。它不是用来替代产品 QA 或通用 lint 检查的。

一定要有 asc 才能用好吗？

不一定，但有的话帮助很大。这个技能最强的用法，是把应用文件与拉取下来的 App Store 元数据做对照，尤其是标题、描述、截图和订阅细节。

对新手友好吗？

友好，只要你能识别自己的应用类型，并把它指向正确的文件。真正的学习门槛不在技能本身，而在于你要知道这次提交适用哪一套 Apple 清单。

什么时候不该用它？

不要把这个技能当成与无关前端 bug、功能规划或 UX 文案写作的替代品。如果你只是想要一段快速营销简介，普通提示词会更快。

如何改进 app-store-preflight-skills

给技能完整的提交上下文

想要更好的 app-store-preflight-skills 结果，就要告诉它 Apple 会审什么：应用类别、变现模式、地区限制、登录流程、数据收集，以及任何特殊 entitlements。上下文缺失会导致检查流于表面，并带来虚假的安全感。

提供准确的元数据和文件路径

不要只说“帮我检查元数据”，而要直接指向真实来源：asc JSON、Info.plist、entitlement 文件、privacy manifest 和订阅文案。这样做很重要，因为很多被拒风险都来自代码、截图和商店元数据之间的细小不一致。

请求按规则输出结果

如果你的 app 很适合 app-store-preflight-skills for Frontend Development，就明确要求它输出你关心的规则项，例如 privacy manifests、订阅披露，或 minimum functionality。这样比笼统的“帮我找问题”更有用。

第一次检查后继续迭代

先用第一次结果补上明显缺口，再针对改过的文件和元数据重新运行这个技能。常见的问题是：只修掉了一个被拒风险，却在截图、审核备注或本地化元数据里留下了同类问题。