mcpField
A
app-store-preflight-skills

app-store-preflight-skills

github.com/truongduy2611テスト・品質1.4k2.1k 回インストール2 週間前に更新
リポジトリ

app-store-preflight-skills について

iOS と macOS のプロジェクトを、提出前に App Store のよくある却下要因に照らして確認するエージェントスキルです。アプリ種別ごとのチェックリストやルールの確認手順、報告形式、一部の自動修正案を提供します。

主な機能

  1. 01アプリ種別ごとのガイドライン一覧
  2. 02メタデータとルールの確認手順
  3. 03重大度順の事前審査レポート
  4. 04一部の問題への修正案

活用シーン

  1. 01App Store 提出前のアプリ確認
  2. 02サブスクリプションとプライバシー要件の確認
  3. 03メタデータの文字数やリンクの問題検出

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/truongduy2611/app-store-preflight-skills --skill app-store-preflight-skills

インストール後、Claude Code で/app-store-preflight-skillsを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.md
LICENSE
references/guidelines/
README.md
references/guidelines/by-app-type/
health_fitness.md
games.md
kids.md
crypto_finance.md
macos.md
all_apps.md
ai_apps.md
social_ugc.md
vpn.md
subscription_iap.md
references/rules/design/
minimum_functionality.md
hidden_features.md
sign_in_with_apple.md
references/rules/entitlements/
unused_entitlements.md
references/rules/metadata/
accurate_metadata.md
china_storefront.md
apple_trademark.md
subscription_metadata.md
review_notes_new_submission.md
review_notes_template.md
competitor_terms.md
references/rules/privacy/
privacy_manifest.md
third_party_ai_consent.md
unnecessary_data.md
references/rules/subscription/
misleading_pricing.md
missing_tos_pp.md

詳細

App Store 提出前チェックのスキル

iOS／macOS プロジェクトの提出前チェックを実施し、App Store でよくあるリジェクトのパターンを検出します。

前提条件

  • asc CLI — Homebrew でインストールします：brew install asc（App-Store-Connect-CLI）
  • ASC CLI Skills — asc の使用パターンについては、app-store-connect-cli-skills を参照してください
  • jq — 任意ですが、ルールのドキュメントにある一部の JSON 検査例で使用します

ステップ 1：アプリの種類を特定 → チェックリストを読み込む

references/guidelines/by-app-type/ から該当するチェックリストを読み込み、適用されるガイドラインを特定します。必ず最初に all_apps.md を読み込み、その後、アプリの種類に固有のチェックリストを追加してください。

アプリの種類チェックリスト
すべてのアプリreferences/guidelines/by-app-type/all_apps.md
サブスクリプション／IAPreferences/guidelines/by-app-type/subscription_iap.md
ソーシャル／UGCreferences/guidelines/by-app-type/social_ugc.md
キッズカテゴリreferences/guidelines/by-app-type/kids.md
ヘルスケア＆フィットネスreferences/guidelines/by-app-type/health_fitness.md
ゲームreferences/guidelines/by-app-type/games.md
macOSreferences/guidelines/by-app-type/macos.md
AI／生成 AIreferences/guidelines/by-app-type/ai_apps.md
暗号資産＆金融references/guidelines/by-app-type/crypto_finance.md
VPNreferences/guidelines/by-app-type/vpn.md

ガイドラインの完全なインデックス：references/guidelines/README.md

ステップ 2：検査用のメタデータを取得する

asc CLI を使って最新の App Store メタデータを取得します。

# Pull canonical metadata JSON for the version you want to review
asc metadata pull --app "<APP_ID>" --version "<VERSION>" --dir ./metadata

asc metadata pull は、アプリ情報ファイルを ./metadata/app-info/*.json に、バージョンごとのローカライズファイルを ./metadata/version/<VERSION>/*.json に書き込みます。

以下のルール例では、asc metadata pull によって書き込まれる標準的な JSON レイアウトを前提としています。

クリエイティブアセット（プロダクトページのヘッダー、検索結果アセット、ガイドライン 2.3.14）は App Store Connect のアセットライブラリにあります。お使いの asc のバージョンで取得されない場合は、ガイドライン 2.3.14 に照らして手動で確認してください。

別のレイアウト（たとえば fastlane の metadata/）でメタデータを管理している場合は、その構成に合わせてファイルパスの例を変更するか、先に標準の asc レイアウトで取得してください。

ステップ 3：リジェクトルールのチェックを実行する

各カテゴリについて、references/rules/ から該当するルールファイルを読み込み、確認します。各ルールには、確認項目、検出方法、解決方法、リジェクト例が含まれます。

カテゴリルールファイル
メタデータreferences/rules/metadata/*.md
サブスクリプションreferences/rules/subscription/*.md
プライバシーreferences/rules/privacy/*.md
デザインreferences/rules/design/*.md
エンタイトルメントreferences/rules/entitlements/*.md

ステップ 4：検出結果を報告する

次のテンプレートを使ってサマリーレポートを作成します。

## Preflight Report

### ❌ Rejections Found (N)
- [GUIDELINE X.X.X] Description of issue
  - File: path/to/offending/file
  - Fix: What to do

### ⚠️ Warnings (N)
- [GUIDELINE X.X.X] Potential issue

### ✅ Passed (N)
- [Category] All checks passed

重大度の高い順に並べます。まずリジェクト、次に警告、最後に合格です。

ステップ 5：自動修正と検証

自動修正できる問題もあります。

  • 競合他社の用語 → 競合他社名を削除した置き換え文を提案します
  • メタデータの文字数制限 → 現在の文字数と上限を表示します
  • リンクの欠落 → ToS／PP のテンプレートリンクを生成します

自動修正を適用した後は、該当するチェックを再実行して、違反が解消されたことを確認してください。再スキャンに合格した場合にのみ、解決済みとします。

スクリーンショットや UI の再設計など、手動での対応が必要な問題については、明確な手順を示しますが、自動修正は行いません。

注意点

  • 中国のストアフロント — 禁止されている AI 関連用語（ChatGPT、Gemini など）は、zh-Hans だけでなく、すべてのロケールでチェックされます。Apple は中国のストアフロントに表示されるすべてのロケールを確認します。
  • プライバシーマニフェスト — アプリが Required Reason API を直接呼び出さない場合でも、PrivacyInfo.xcprivacy が必要です。UserDefaults や NSFileManager を使用するサードパーティ製 SDK（Firebase、Amplitude など）を含めると、間接的にこの要件が適用されます。
  • asc 認証 — asc metadata pull には App Store Connect の認証が必要です。先に asc auth login を実行するか、ASC_KEY_ID、ASC_ISSUER_ID と、ASC_PRIVATE_KEY_PATH／ASC_PRIVATE_KEY／ASC_PRIVATE_KEY_B64 のいずれかを設定してください。asc が何を読み込んでいるか不明な場合は、asc auth doctor を実行してください。
  • サブスクリプションのメタデータ — Apple は、利用規約とプライバシーポリシーへのリンクを、App Store の説明とアプリ内のサブスクリプション購入画面の両方に記載するよう求めています。どちらか一方でも欠けていると、それぞれ別個の却下理由になります。
  • 非表示機能（2.5.19） — 機能フラグは使用できますが、有効化できる機能はすべて審査用ビルドに含まれ、審査担当者が利用でき、審査メモに記載されている必要があります。審査環境のチェック（サンドボックスのレシート、TestFlight）に基づいて機能を制限すると、審査担当者を欺く行為とみなされ、開発者アカウントが停止される可能性があります。
  • サードパーティ AI（5.1.2(i)） — AI 呼び出しを自社のバックエンド経由で中継しても、要件は免除されません。プロンプトやユーザーコンテンツが OpenAI、Gemini、Anthropic などに送信される場合、最初のリクエストを送信する前に、プロバイダー名を明示した同意画面がアプリに必要です。
  • Sign in with Apple のリレードメイン — 2026 年後半以降、新しいリレーアドレスでは privaterelay.appleid.com に加えて private.icloud.com が使用されます。ドメインをハードコードしてチェックすると、新規ユーザーに対して動作しなくなります。
  • SDK の最小要件 — 2026 年 4 月 28 日以降、アップロードするアプリは iOS 26 SDK 以降でビルドする必要があります。古い Xcode では審査時ではなく、アップロード時に失敗します。
  • macOS のエンタイトルメント — Apple は、一時的な例外エンタイトルメント（com.apple.security.temporary-exception.*）を使用する理由をすべて説明するよう求めます。実際に使用していないエンタイトルメントは削除してください。

新しいルールの追加

適切な references/rules/ サブディレクトリに .md ファイルを作成します。

# Rule: [Short Title]
- **Guideline**: [Apple Guideline Number]
- **Severity**: REJECTION | WARNING
- **Category**: metadata | subscription | privacy | design | entitlements

## What to Check
## How to Detect
## Resolution
## Example Rejection

コメント

Markdown 対応