JaminZhou/asc-tooling

Que fait asc-tooling ?

Utilisez cette compétence lorsque vous travaillez avec asc_tooling, la boîte à outils CLI réutilisable pour App Store Connect.

Règles de sécurité

• Ne demandez jamais à l'utilisateur de coller le contenu de clés .p8, des JWT, des cookies, des données de compte App Store Connect ou des secrets de produits non publiés.
• Conservez la génération de captures d'écran spécifiques au produit, les notes de révision, les fichiers de métadonnées et l'état de publication dans le dépôt du produit consommateur.
• Considérez les assistants de session navigateur dans experimental/ comme locaux et non supportés ; ne les utilisez pas dans des scripts CI ou de publication partagés.
• Les commandes de modification doivent être explicites. Préférez --dry-run avant les actions qui créent ou mettent à jour l'état d'App Store Connect.
• Si le comportement de l'API Apple est incertain, rapportez ce qui a été vérifié et ce qui nécessite encore une confirmation manuelle dans l'interface web d'App Store Connect.

Points d'entrée CLI

Préférez la CLI unifiée lorsqu'elle est disponible :

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

Les noms d'exécutables historiques restent supportés :

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

Environnement

La plupart des commandes nécessitent les identifiants de l'API App Store Connect :

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

asc-sales nécessite également ASC_VENDOR_NUMBER sauf si passé avec --vendor-number.

Workflow

1. Identifiez le dépôt du produit et la surface de commande : révision, métadonnées, bêta, ventes, captures d'écran, IAP, version, disponibilité ou configuration du store.
2. Lisez d'abord les documents ou scripts de publication spécifiques au produit ; conservez les valeurs spécifiques au produit là-bas.
3. Utilisez les commandes de statut ou --dry-run avant les commandes de modification.
4. Résumez l'exécution de la commande, les entrées utilisées, la source de vérité et toute confirmation encore nécessaire dans l'interface web d'App Store Connect.
5. Ne sauvegardez jamais de secrets ou d'exports de session navigateur dans le dépôt.

Installation de la compétence

Installez ou mettez à jour cette compétence via la CLI fournie :

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

--client codex installe sous $CODEX_HOME/skills ou ~/.codex/skills. --client agents installe sous le dossier utilisateur ouvert des compétences Agent, ~/.agents/skills. --client claude installe sous $CLAUDE_CONFIG_DIR/skills ou ~/.claude/skills.