JaminZhou/asc-tooling

asc-tooling は何をしますか？

このスキルは、再利用可能な App Store Connect CLI ツールキットである asc_tooling を使用する際に活用してください。

安全規則

• .p8 キーの内容、JWT、クッキー、App Store Connect アカウントデータ、未公開の製品シークレットをユーザーに貼り付けさせないでください。
• 製品固有のスクリーンショット生成、レビューノート、メタデータファイル、リリース状態は、製品リポジトリ内に保持してください。
• experimental/ 内のブラウザセッションヘルパーはローカル専用であり、サポート対象外として扱ってください。CI や共有リリーススクリプトでは使用しないでください。
• 状態を変更するコマンドは明示的に行ってください。App Store Connect の状態を作成・更新するアクションの前には --dry-run を優先的に使用してください。
• Apple API の動作が不明確な場合は、検証済みの内容と、手動での App Store Connect 確認が依然として必要な内容を報告してください。

CLI エントリポイント

可能な場合は統一 CLI を優先してください：

asc-tooling commands
asc-tooling review status --bundle-id com.example.app
asc-tooling metadata status --bundle-id com.example.app --locale en-US
asc-tooling beta status --bundle-id com.example.app
asc-tooling sales units --bundle-id com.example.app --vendor-number 12345678 --report-date 2026-04-10
asc-tooling screenshots status --bundle-id com.example.app --locale en-US --display-type APP_DESKTOP
asc-tooling iap status --bundle-id com.example.app
asc-tooling version create --bundle-id com.example.app --version 1.2.0 --platform ios --dry-run
asc-tooling availability status --bundle-id com.example.app
asc-tooling store-setup status --bundle-id com.example.app --app-version 1.0.0 --platform ios

従来の実行可能ファイル名も引き続きサポートされます：

• asc-review
• asc-metadata
• asc-beta
• asc-sales
• asc-screenshots
• asc-iap
• asc-version
• asc-availability
• asc-store-setup

環境設定

ほとんどのコマンドには App Store Connect API の認証情報が必要です：

export ASC_KEY_ID=...
export ASC_ISSUER_ID=...
export ASC_KEY_PATH=~/.config/appstoreconnect/AuthKey_XXXX.p8

asc-sales では、--vendor-number として指定しない限り ASC_VENDOR_NUMBER も必要です。

ワークフロー

1. 製品リポジトリとコマンドの種類（review、metadata、beta、sales、screenshots、IAP、version、availability、store setup）を特定します。
2. 製品固有のリリースドキュメントまたはスクリプトを最初に読み込みます。製品固有の値はそこに保持してください。
3. 状態を変更するコマンドの前に、status または dry-run コマンドを使用します。
4. 実行したコマンド、使用した入力、信頼できる情報源、および引き続き App Store Connect Web UI での確認が必要な内容を要約します。
5. シークレットやブラウザセッションのエクスポートをリポジトリに保存しないでください。

スキルのインストール

バンドルされた CLI を通じてこのスキルをインストールまたは更新します：

asc-tooling init --client codex --force
asc-tooling init --client agents --force
asc-tooling init --client claude --force
asc-tooling init --print

--client codex は $CODEX_HOME/skills または ~/.codex/skills にインストールします。 --client agents はオープンな Agent Skills ユーザーフォルダ ~/.agents/skills にインストールします。 --client claude は $CLAUDE_CONFIG_DIR/skills または ~/.claude/skills にインストールします。