JaminZhou/asc-tooling

¿Qué hace asc-tooling?

Usa este skill cuando trabajes con asc_tooling, el kit de herramientas CLI reutilizable para App Store Connect.

Reglas de seguridad

• Nunca pidas al usuario que pegue el contenido de la clave .p8, JWTs, cookies, datos de la cuenta de App Store Connect o secretos de productos no publicados.
• Mantén la generación de capturas de pantalla específicas del producto, notas de revisión, archivos de metadatos y el estado de publicación en el repositorio del producto consumidor.
• Trata los ayudantes de sesión de navegador en experimental/ como locales y no soportados; no los uses en CI o scripts de lanzamiento compartidos.
• Los comandos mutantes deben ser explícitos. Prefiere --dry-run antes de acciones que creen o actualicen el estado de App Store Connect.
• Si el comportamiento de la API de Apple es incierto, informa lo que se verificó y lo que aún necesita confirmación manual en App Store Connect.

Puntos de entrada CLI

Prefiere el CLI unificado cuando 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

Los nombres de ejecutables heredados siguen siendo compatibles:

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

Entorno

La mayoría de los comandos requieren credenciales de la API de App Store Connect:

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

asc-sales también necesita ASC_VENDOR_NUMBER a menos que se pase como --vendor-number.

Flujo de trabajo

1. Identifica el repositorio del producto y la superficie de comandos: revisión, metadatos, beta, ventas, capturas de pantalla, IAP, versión, disponibilidad o configuración de la tienda.
2. Lee primero los documentos o scripts de lanzamiento específicos del producto; mantén los valores específicos del producto allí.
3. Usa comandos de estado o dry-run antes de comandos mutantes.
4. Resume la ejecución del comando, las entradas utilizadas, la fuente de verdad y cualquier confirmación adicional necesaria en la interfaz web de App Store Connect.
5. Nunca guardes secretos o exportaciones de sesión del navegador en el repositorio.

Instalación del skill

Instala o actualiza este skill a través del CLI incluido:

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

--client codex instala en $CODEX_HOME/skills o ~/.codex/skills. --client agents instala en la carpeta de usuario de open Agent Skills, ~/.agents/skills. --client claude instala en $CLAUDE_CONFIG_DIR/skills o ~/.claude/skills.