Communitygithub.com

appstore-release

単一の設定ファイルを使用してiOSアプリのApp Store Connectへの提出を自動化し、一貫性と信頼性のあるリリースパイプラインを実現します。

appstore-release とは?

このスキルは、App Store Connect APIを介してiOSアプリ(EAS/Expoでビルド)のApp Storeレビュー提出をエンドツーエンドで自動化します。クレデンシャル、ビルド添付、メタデータ、スクリーンショット、価格、年齢レーティング、コンテンツ権利、レビュー情報、サブスクリプション、レビュー提出までをカバーします。ユーザーが「アプリを公開/提出」「App Reviewに送信」「iOSアプリをリリース」「App Store Connectに入力」「メタデータ/スクリーンショットをアップロード」「App Store Connectを自動化」と言った場合に使用します。パラメトリック設計により、ASC APIキー、アプリID、設定ファイルがあればどのアプリでも動作します。AppleがAPIで公開していないごく一部の操作(App Privacyデータ収集の宣言、初回サブスクリプションのアタッチと提出)のみユーザーに確認し、それ以外はすべて自動化します。

対応~Claude Code~Codex CLI~Cursor
npx skills add threelipped-genushesperiphona524/appstore-release

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

App Store Release

App Store Connect API を使ってiOSアプリのApp Store提出を完全に自動化します。設計思想:ユーザーがクレデンシャルと config.json を 一度だけ 提供すれば、エージェントは自動化可能なすべての処理を実行し、AppleがAPIで公開していないごく一部の操作についてのみユーザーに確認を求めます。設定に記載されている項目や適切なデフォルト値がある項目について、ユーザーに再確認を求めないでください。

動作原則(最初に読んでください)

  1. 設定駆動、プロンプト駆動ではない。 すべてのアプリコンテンツは config.json にあります。コマンドを実行してください。ユーザーにインタビューしないでください。
  2. UIのみの操作は2つだけ(AppleにAPIがありません):App Privacyのデータ収集 と 初回サブスクリプションのアタッチと提出。これらのツールはこれらの操作を検出し、正確なクリック手順を表示します。それ以外はすべてスクリプト化されています。
  3. ユーザーに確認を求めるのは以下の場合のみ: 設定に必須項目が欠けている場合(どの項目か正確に伝える)、ビジネス上の判断が設定にない場合(サブスクリプション価格、リリースタイミング)、または唯一の不可逆的な操作(最終提出)の前。それ以外は自動で進めてください。
  4. 冪等性: すべてのコマンドは再実行しても安全です。node cli.mjs release は何度でも実行可能です。

アーキテクチャ(SOLID原則に基づき、拡張可能)

scripts/
  cli.mjs                 単一エントリポイント/ディスパッチャ(node cli.mjs <command>)
  lib/                    注入されるサービス、各ファイルは単一責任
    env.mjs               環境変数の解析と検証(クレデンシャル、アプリID)
    jwt.mjs               ES256トークンプロバイダ
    client.mjs            AscClient — 認証 + HTTP + 統一エラー処理
    discovery.mjs         ASCリソースを自然キーで検索(ハードコードされたIDは使わない)
    assets.mjs            予約→アップロード→コミットのバイナリアップローダ
    config.mjs            設定の読み込みと検証、不足項目のリスト表示
    log.mjs               構造化結果 + 機械可読なサマリ
    context.mjs           コンポジションルート(依存性注入)
  commands/               タスクごとに1ファイル。統一された契約に従う(_contract.md参照)

機能を追加するには = commands/x.mjs(メタデータ + run(ctx))を作成し、cli.mjs に登録します。

セットアップ(1回限り)— references/setup.md を参照

  1. ASC APIキー(App Manager): AuthKey_XXXX.p8 をダウンロードし、Key IDとIssuer IDをメモします。
  2. App Store Connectにアプリレコードが存在する(バンドルIDが登録されている)。ASC_APP_ID = アプリのASC URLから取得した数値ID。
  3. EASプロジェクトが設定され、eas login が完了している。
  4. references/config-template.json から config.json を記入します。任意のコマンドで検証可能:どのコマンドでも不足しているフィールドが正確に表示されます。

環境変数

export ASC_KEY_ID=... ASC_ISSUER_ID=... ASC_P8_PATH=/abs/AuthKey_XXXX.p8   # .p8ファイルはgitignore
export ASC_APP_ID=1234567890
export APPSTORE_CONFIG=/abs/config.json
cd scripts   # その後: node cli.mjs <command>

実行手順

1. 状況確認

node cli.mjs status          # 読み取り専用の全体概要
node cli.mjs check           # 準備状況 + まだ保留中のUIのみの手順

2. バイナリのビルド(EAS)

  • eas build が古いクレデンシャルで失敗する場合("provisioning profile expired / no certificate with serial…"):
    node cli.mjs credentials     # 新しい配布証明書とプロファイルを生成 → credentials.json
    
    その後、eas.jsonのプロダクションプロファイルで "credentialsSource":"local" を設定します。
  • バイナリをビルドして提出します(非対話型実行のため EXPO_ASC_API_KEY_PATH/KEY_ID/ISSUER_ID + EXPO_APPLE_TEAM_ID + EXPO_APPLE_TEAM_TYPE をエクスポート):
    eas build -p ios --profile production --non-interactive --no-wait
    eas submit -p ios --profile production --id <buildId>
    
    ビルドが VALID になるまで待ちます(node cli.mjs status で確認)。

3. リスティング全体を一括で設定

node cli.mjs release         # ビルド添付 → メタデータ → 価格 → コンテンツ権利 →
                             # 年齢レーティング → カテゴリ → レビュー情報 → スクリーンショット →
                             # サブスクリプション → チェック

release はパイプライン全体を実行し(冪等)、最後に check を実行して残っている UIのみの 手順を表示します。スクリーンショットは事前に存在している必要があります(config.screenshots.dir)— 生成方法については references/screenshots.md を参照してください。

4. UIのみの2つの手順(正確なクリック手順を提示して引き継ぎ)

check は該当する場合にこれらをリスト表示します:

  1. App Privacy → データ収集: アプリのプライバシーマニフェストに一致するデータ型を宣言し、公開します。⚠️ バイナリに NSUserTrackingUsageDescription が含まれているがトラッキングを宣言しない場合、公開がブロックされます → キーを削除して再ビルドします(references/gotchas.md 参照)。
  2. 初回サブスクリプション: バージョンページ → App内課金とサブスクリプション → 選択 → <プロダクト> → 保存 → レビュー用に追加 → 提出。(APIでは初回サブスクリプションをアタッチできません。)

5. 提出

node cli.mjs check                 # 不足がないことを確認
node cli.mjs submit --submit       # アプリのみ / アップデート(初回サブスクリプションは含まない)

初回サブスクリプションがある場合、ユーザーはUIで提出します(手順4.2)。status で確認:バージョンとサブスクリプションの両方が WAITING_FOR_REVIEW になっていることを確認します。

リジェクト時

リジェクトされると、バージョンは再度編集可能になります(REJECTED/METADATA_REJECTED/DEVELOPER_REJECTED)。Resolution Centerのメッセージを読み、修正し(メタデータは release で、バイナリの問題は再ビルドで)、再提出します。

参考資料

  • references/setup.md — キー作成、アプリレコード、EAS、シークレットの管理方法。
  • references/gotchas.md — 実際に発生するすべての落とし穴(最初の実行前に読んでください)。
  • references/screenshots.md — 正確なサイズのPNGを生成する方法(HTML → ヘッドレスChrome)。
  • references/config-template.json — アプリごとの設定テンプレート(lib/config.mjs で検証)。

関連スキル