Community程式設計與開發github.com

apple-app-review

避免 App Store 拒絕。根據最常見的拒絕原因審核 iOS App,撰寫 App Store Connect 的「審查備註」,回答 Apple 關於 4.3 / 4.2.6 拒絕的 9 個問題,或建立 Guideline 2.1「有限 App 審查記錄」的資料包。

apple-app-review 是什麼?

這個技能旨在幫助開發者在 App Store 審查過程中避免被拒絕。它提供四種模式:審查備註(預設)、回答 4.3 拒絕、建立 2.1 資料包,以及審核。技能會自動掃描程式碼以收集事實,例如應用程式功能、帳戶流程、使用者內容、應用內購買、SDK 及服務,並只會詢問使用者無法從程式碼中獲取的資訊。接著,它會根據 App Store 審查指南產生結構化且遵從規範的文字,並在提交前提供通過/失敗的核對清單。此技能適用於 Claude Code 等平台,透過自動化審查過程中的繁瑣文書工作,顯著降低被拒絕的風險。它確保「審查備註」包含所有必要資訊,如示範帳戶、SDK 清單及螢幕錄影連結,從而提升審查效率與成功率。

相容平台~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 的人)。任何他們在這段時間內找不到或無法操作的項目,都會變成拒絕理由。

Apple 對此欄位的規定(App Store Review Guidelines + App Store Connect Help)

  • 備註最多可達 4000 bytes,任何語言皆可。請計算 byte 而非字元數,若超過則修剪。
  • 2.3.1(a):「所有新功能、特色及產品變更,都必須在審查備註中具體描述……(籠統的描述將被拒絕)。」
  • **提交前:**提供完整存取權限(活躍的示範帳號或功能完整的示範模式),審查期間保持後端服務運作,在備註中說明不明顯的功能和應用程式內購買。
  • **2.1(a):**先在裝置上測試,包含示範帳號資訊並開啟後端。
  • **2.1(b):**每個應用程式內購買都必須可見且可運作;如果某個應用程式內購買無法找到或審查,請在備註中說明原因。
  • 登入欄位只接受一個不得過期的示範帳號。額外帳號請放入備註。
  • 透過行動網路進行串流影片:提供測試串流 URL。

選擇模式

  1. notes(預設):即將提交應用程式或更新。輸出審查備註文字。
  2. answer-4.3:收到 4.3 / 4.2.6 拒絕,並附有 Apple 的 9 個問題。輸出回覆。不要告訴使用者重新提交。
  3. packet-2.1:收到「此應用程式由一個 App 審查記錄有限的開發者帳號提交。」輸出 6 項資料包加上錄製鏡頭清單。
  4. audit:在提交前,依據 GUIDE.md 中的拒絕地圖對比程式碼和列表,並針對每項輸出通過/不通過及修復方式。

第一步:收集事實(先讀取程式碼,僅詢問程式碼無法告訴你的事項)

從儲存庫中找出並列出:

  • 應用程式的功能、每個主畫面、每個付費或受限制的功能以及如何到達。
  • 帳號流程:註冊、登入、帳號刪除(Guideline 5.1.1(v) 要求若存在帳號,則必須在應用程式內提供此功能)。
  • 使用者內容:發佈、檢舉和封鎖(Guideline 1.2)。
  • 應用程式內購買和訂閱(產品 ID、各解鎖內容)。
  • 每個 SDK 和外部服務:驗證、支付、分析、崩潰回報、廣告、AI 提供商(註明模型供應商)、資料 API。檢查 Package.swift、Podfile、package.json、build.gradle、Info.plist、網路呼叫。
  • 任何透過伺服器、遠端設定或功能標記開關的項目。直白說明;隱藏的伺服器開關會被視為誘餌和調包(Guideline 2.5.19)。
  • 區域差異,或確認沒有差異。
  • 此建置檔中的變更(自上次標記或發佈以來的 git log),具體描述。自 2026 年 10 月 16 日起,Apple 拒絕籠統的新功能描述。

僅向使用者詢問:目標使用者、市場缺口及附有日期的競爭對手數量、Beta 測試(建置編號、日期、改變應用程式的回饋)、帳號上的其他應用程式及其差異、發佈此應用程式的公司、應用程式的自有網站(隱私、條款、支援)、示範登入,以及代管的螢幕錄影連結。

第二步:撰寫內容

所有模式的規則:

  • 使用簡單句子,用數字代替形容詞,日期使用 YYYY-MM-DD 格式。
  • 切勿貼上 App Store 的行銷描述(Apple 問題 1 禁止此行為)。
  • 列出開發者帳號上的每個其他應用程式,並用一句話說明其不同之處。
  • 列出每個 SDK 和服務。審查員可以看到它們;漏掉一個會讓情況更糟。
  • 提供證據:螢幕錄影、範例檔案、示範帳號。
  • 不要陳述使用者尚未確認的內容。請留下 [TO CONFIRM: ...]。

notes 範本

功能說明
<2-3 句,說明使用者問題及應用程式如何解決>

目標對象
<已命名的群組>

測試方式
示範登入:<email> / <password>(保持啟用)
1. <到達主要功能的步驟>
2. <到達付費功能的步驟>(沙盒購買可運作 / 促銷代碼:...)
帳號刪除:設定 > <路徑>
檢舉 / 封鎖:<路徑>   (或:無使用者內容)

此版本新功能
- <功能>:<位置、作用>

服務
<auth、payments、analytics、AI 提供商 + 用途>,審核後無遠端切換
區域差異:無 / <列表>

此帳號上的其他應用程式
<應用程式>:<一句話說明差異>   (或:無)

網站
<網域> - 隱私 <url>、條款 <url>、支援 <應用程式自有網域的 email>

螢幕錄影(從啟動、實體裝置、最新 iOS):<無需登入的連結>

answer-4.3 範本

以一行的開頭表示:你認為此應用程式並非垃圾郵件或範本,並將直接回答每個問題。接著按 Apple 的順序列出九個有標題的答案:

  1. 功能 2. 目標對象 3. 缺口(附有日期的搜尋、競爭對手數量、評分) 4. Beta 測試(建置、日期、應用的回饋) 5. 獨立或套件 6. 另一個應用程式中的應用程式內購買 7. 與你其他應用程式共用的程式碼 8. 與第三方共用的程式碼 9. 為客戶製作。 最後提供螢幕錄影或範例檔案。在 App Store Connect 中回覆;除非實際上有變更,否則不要重新提交。

如果對問題 5、6 或 7 的誠實答案是「是,有重疊」,請在撰寫前告知使用者:修復方式是產品(將其合併到現有應用程式中作為一項功能,或使其不同),而非措辭。

packet-2.1 範本

Apple 要求的六項資料:螢幕錄影、目的和目標對象、設定 + 憑證 + 範例檔案、每個外部服務、區域差異、受監管行業文件。將相同的文字貼到 Resolution Center 回覆和備註欄位中。然後:保持提交不變,最多在兩週後查詢一次狀態,並在該應用程式獲得批准前暫停其他應用程式的提交。

錄製鏡頭清單:從實體裝置的主畫面開始,最新 iOS,啟動、註冊、登入、主要功能、使用者內容 + 檢舉 / 封鎖、購買 + 解鎖的內容、刪除帳號。

範例

請參閱 examples/backed-update.md 來查看一個簡短的實際備註,該備註讓一個更新在 1 分鐘內獲得批准。

第三步:提交前檢查

完整檢查清單和拒絕地圖:GUIDE.md。 輸出通過/不通過清單:應用程式的自有網站(在 App Store Connect 和應用程式內連結隱私/條款/支援)、該網域的支援電子郵件、今日測試的示範登入、帳號刪除、檢舉/封鎖、每個列出的 SDK、不需登入即可開啟的錄影連結、帳號上不超過數個相似的應用程式、新帳號一次只審查一個應用程式。

相關技能