Community编程与开发github.com

apple-app-review

避免App Store审核被拒。对照常见驳回原因审核iOS应用,编写App Store Connect“审核备注”,回答苹果4.3/4.2.6驳回后的9个问题,或构建2.1“有限审核历史”所需材料包。适用于应用即将提交、更新或已收到驳回时使用。

apple-app-review 是什么?

该技能旨在帮助开发者在向App Store提交应用或更新前,主动完成审核员的“作业”,避免因信息不充分或常见原因被驳回。它基于苹果官方审核指南和App Store Connect帮助文档,提供了四种工作模式:生成审核备注(默认模式)、回答4.3/4.2.6驳回后的9个问题、构建2.1“有限审核历史”所需材料包,以及预提交审核(对照驳回地图生成通过/失败清单)。该技能会引导用户从代码库收集必要事实(如应用功能、账户流程、SDK列表等),并仅向用户询问代码无法获取的信息(如目标用户、市场数据、演示账号等),然后根据所选模式生成对应的结构化文本。核心规则包括使用简洁句、数字而非形容词、日期使用YYYY-MM-DD格式、不得粘贴营销描述、列出所有SDK和服务、提供录屏等证据,以及绝不添加用户未确认的声明。最终输出可直接用于App Store Connect。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Git-Agni/apple-app-review-skill/tree/main

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

apple-app-review 是做什么的?

在审核员打开构建之前,替他们完成准备工作。一位审核员评审一个新应用大约需要13分钟,一个更新大约需要6分钟(Phillip Shoemaker,2009-2016年负责App Review的主管)。任何他们在该时间内找不到或无法触及的内容,都可能成为驳回理由。

苹果对该字段的官方规定(App Store 审核指南 + App Store Connect 帮助)

  • 备注最多可包含 4000 字节,支持任何语言。请按字节计数,而非字符数,超出则需截断。
  • 2.3.1(a): “所有新功能、特性和产品变更都必须在“审核备注”部分进行具体描述……(泛泛的描述将被拒绝)。”
  • 提交前: 提供完整访问权限(活跃的演示账号或功能完整的演示模式),审核期间保持后端服务在线,在备注中解释非显而易见的特性和应用内购买。
  • 2.1(a): 先在设备上测试,包含演示账号信息并开启后端。
  • 2.1(b): 每个应用内购买必须可见且可工作;如果某个购买项无法找到或无法审查,请在备注中说明原因。
  • 登录字段填写一个不会过期的演示账号。额外账号请放在备注中。
  • 通过蜂窝网络播放流媒体视频:提供测试流 URL。

选择模式

  1. notes(默认):即将提交应用或更新。输出审核备注文本。
  2. answer-4.3:收到带有苹果9个问题的4.3 / 4.2.6驳回。输出回复内容。不要告诉用户重新提交。
  3. packet-2.1:收到“此应用是由一个App Review历史有限的开发者账号提交的。”输出包含6项材料包及录制镜头清单。
  4. audit:在提交前,对照 GUIDE.md 中的驳回地图审查代码和列表,输出每个指南编号的通过/失败及修复方法。

步骤1:收集事实(先读取代码,仅询问代码无法告知的内容)

从仓库中查找并列出:

  • 应用的功能、每个主屏幕、每个付费或受限制功能及其访问路径。
  • 账户流程:注册、登录、账号删除(指南5.1.1(v)要求如果存在账号功能,应用内必须提供删除入口)。
  • 用户内容:发布、举报与屏蔽(指南1.2)。
  • 应用内购买和订阅(产品ID、各解锁什么内容)。
  • 每个 SDK 和外部服务:认证、支付、分析、崩溃报告、广告、AI提供商(注明模型供应商)、数据API。检查 Package.swift, Podfile, package.json, build.gradle, Info.plist, 网络调用。
  • 任何通过服务器、远程配置或功能开关切换的内容。请如实说明;隐藏的服务器开关会被视为诱饵切换(指南2.5.19)。
  • 区域差异,或确认无差异。
  • 本次构建中的变更(自上一个标签或发布以来的 git 日志),具体描述。自2026年10月16日起,苹果拒绝泛泛的新功能描述。

仅向用户询问:目标用户、市场差距与注明日期的竞品数量、beta测试(构建号、日期、促使应用改变的反馈)、该账号下的其他应用及各自差异、发布该应用的公司、应用自己的网站(隐私、条款、支持)、演示登录信息、以及托管的屏幕录制链接。

步骤2:编写

所有模式的通用规则:

  • 使用简洁句,用数字代替形容词,日期格式为 YYYY-MM-DD。
  • 绝不粘贴App Store营销描述(苹果问题1禁止这样做)。
  • 列出开发者账号下的每个其他应用,并用一句话说明其不同之处。
  • 列出每个 SDK 和服务。审核员可以看到它们;遗漏任何一个都会显得更糟。
  • 提供证据:屏幕录制、示例文件、演示账号。
  • 绝不添加用户未确认的声明。如不确定,请留 [TO CONFIRM: ...]。

notes 模板

功能介绍
<2-3句话,描述用户问题以及应用如何解决该问题>

目标用户
<指定用户群体>

测试方法
演示登录:<邮箱> / <密码>(保持活跃)
1. <到达主要功能的步骤>
2. <到达付费功能的步骤>(沙盒购买可用 / 促销码:...)
账号删除:设置 > <路径>
举报/屏蔽:<路径>(或无用户内容)

本次更新内容
- <功能>:<位置,功能描述>

服务
<auth, 支付, 分析, AI提供商 + 用途>,批准后无远程开关更改
区域差异:无 / <列表>

该账号下的其他应用
<应用名>:<一句话说明差异>(或无)

网站
<域名> - 隐私政策 <URL>, 使用条款 <URL>, 支持邮箱 <应用自身域名的邮箱>

屏幕录制(从启动开始,物理设备,最新iOS):<无需登录的链接>

answer-4.3 模板

开头用一句话:您认为该应用不是垃圾或模板,并将直接回答每个问题。然后按苹果顺序给出九个带标题的答案:

  1. 功能介绍 2. 目标用户 3. 市场差距(注明日期的搜索、竞品数量、评分) 4. Beta测试(构建号、日期、所应用的反馈) 5. 独立应用还是套件 6. 其他应用中的应用内购买 7. 与您的其他应用共享代码 8. 与第三方共享代码 9. 为客户制作。 结尾处提供屏幕录制或示例文件。在 App Store Connect 中回复;除非有实际变更,否则不要重新提交。

如果对问题5、6或7的诚实答案是“是,存在重叠”,请先向用户说明:修复方法是产品层面(将其合并到现有应用中作为一个功能,或使其与众不同),而非措辞问题。

packet-2.1 模板

苹果要求的六项内容:屏幕录制、目的与受众、设置 + 凭证 + 示例文件、每个外部服务、区域差异、受监管行业文档。将相同文本粘贴到Resolution Center回复和备注字段中。然后:保持提交不变,最多在两周后再咨询一次状态,在该应用获批前暂不提交其他应用。

录制镜头清单:在最新iOS的物理设备主屏幕开始,启动、注册、登录、主要功能、用户内容 + 举报/屏蔽、购买 + 解锁内容、删除账号。

示例

参见 examples/backed-update.md 中一份简短的实景备注,该备注使更新在1分钟内获批。

步骤3:提交前检查

完整清单和驳回地图:GUIDE.md。 打印通过/失败列表:应用自己的网站(在App Store Connect和应用中链接隐私政策/使用条款/支持)、支持邮箱使用该域名、今日测试的演示登录、账号删除、举报/屏蔽、每个SDK均已列出、录制链接无需登录即可打开、账号上不超过几个相似应用、新账号一次只审核一个应用。

相关技能