Communitygithub.com

appstore-release

Automatiza los envíos de aplicaciones iOS a App Store Connect usando un único archivo de configuración para un pipeline de lanzamiento consistente y confiable.

¿Qué es appstore-release?

Esta skill permite a un agente de IA (como Claude Code, Cursor o Codex) gestionar de principio a fin el proceso de publicación de una aplicación iOS en App Store Connect, utilizando únicamente la API de App Store Connect y un archivo de configuración JSON. Está diseñada para ser paramétrica, es decir, funciona para cualquier aplicación siempre que se proporcionen las credenciales adecuadas (clave API de ASC, ID de la aplicación) y un archivo de configuración (`config.json`) que contenga todos los metadatos, capturas de pantalla, precios, calificación de edad, derechos de contenido, información de revisión y suscripciones. La skill sigue un principio de "configuración única, ejecución repetible", donde el agente realiza todas las tareas automatizables (subir binarios, rellenar metadatos, configurar precios, etc.) y solo interrumpe al usuario para aquellos pasos que Apple no expone mediante API, como la declaración de privacidad de datos y la primera suscripción. El resultado es un pipeline de lanzamiento idempotente y confiable, soportado en plataformas como EAS/Expo, que minimiza la intervención manual y reduce errores.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add threelipped-genushesperiphona524/appstore-release

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Lanzamiento a App Store

Gestiona un envío completo a la App Store de iOS desde la API de App Store Connect. Objetivo de diseño: el usuario proporciona las credenciales + un config.json una vez, luego el agente hace todo lo que es automatizable y solo interrumpe al usuario para las pocas cosas que Apple genuinamente no expone mediante API. No preguntes al usuario que vuelva a confirmar cosas que ya están en la configuración o tienen valores predeterminados sensatos.

Principio de funcionamiento (léelo primero)

  1. Basado en configuración, no en instrucciones. Todo el contenido de la aplicación vive en config.json. Ejecuta comandos; no entrevistes al usuario.
  2. Solo dos cosas son solo de interfaz de usuario (Apple no tiene API): la declaración de recopilación de datos de privacidad de la aplicación y la primera suscripción (adjuntar y enviar). Las herramientas detectan y muestran estos con clics exactos. Todo lo demás está automatizado.
  3. Pregunta al usuario solo cuando: falta un campo obligatorio en la configuración (dile exactamente cuál), una decisión comercial no está en la configuración (precio de suscripción, momento de lanzamiento), o antes de la única acción irreversible (el envío final). En caso contrario, procede.
  4. Idempotente: todos los comandos son seguros de re-ejecutar. node cli.mjs release se puede ejecutar repetidamente.

Arquitectura (SÓLIDA, para que puedas extenderla)

scripts/
  cli.mjs                 punto de entrada único / despachador (node cli.mjs <comando>)
  lib/                    servicios inyectados, una responsabilidad cada uno
    env.mjs               analiza+valida el entorno (credenciales, id de app)
    jwt.mjs               proveedor de tokens ES256
    client.mjs            AscClient — autenticación + HTTP + errores uniformes
    discovery.mjs         localiza recursos de ASC por clave natural (sin ids hardcodeados)
    assets.mjs            cargador binario: reservar→subir→confirmar
    config.mjs            carga + valida la configuración, lista lo que falta
    log.mjs               resultados estructurados + resumen legible por máquina
    context.mjs           raíz de composición (inyección de dependencias)
  commands/               un archivo por tarea; contrato uniforme (ver _contract.md)

Añadir una capacidad = añadir un archivo commands/x.mjs (meta + run(ctx)) y registrarlo en cli.mjs.

Configuración (una vez) — consulta references/setup.md

  1. Clave API de ASC (App Manager): descarga AuthKey_XXXX.p8, anota el ID de Clave + ID de Emisor.
  2. El registro de la aplicación existe en ASC (ID de bundle registrado). ASC_APP_ID = id numérico de la URL de ASC de la aplicación.
  3. Proyecto EAS configurado, eas login realizado.
  4. Rellena config.json desde references/config-template.json. Valida en cualquier momento: cualquier comando imprime exactamente qué campos faltan.

Entorno

export ASC_KEY_ID=... ASC_ISSUER_ID=... ASC_P8_PATH=/abs/AuthKey_XXXX.p8   # gitignore el .p8
export ASC_APP_ID=1234567890
export APPSTORE_CONFIG=/abs/config.json
cd scripts   # luego: node cli.mjs <comando>

Manual de ejecución

1. Orientación

node cli.mjs status          # resumen completo de solo lectura
node cli.mjs check           # preparación + los pasos solo de interfaz de usuario pendientes

2. Construir el binario (EAS)

  • Si eas build falla con credenciales caducas ("perfil de aprovisionamiento caducado / no hay certificado con serial…"):
    node cli.mjs credentials     # nuevo certificado de distribución + perfil → credentials.json
    
    luego establece "credentialsSource":"local" en el perfil de producción de eas.json.
  • Construye y envía el binario (exporta EXPO_ASC_API_KEY_PATH/KEY_ID/ISSUER_ID + EXPO_APPLE_TEAM_ID + EXPO_APPLE_TEAM_TYPE para modo no interactivo):
    eas build -p ios --profile production --non-interactive --no-wait
    eas submit -p ios --profile production --id <buildId>
    
    Espera hasta que la compilación esté VÁLIDA (node cli.mjs status).

3. Rellenar todo el listado de una sola vez

node cli.mjs release         # adjuntar compilación → metadatos → precios → derechos de contenido →
                             # calificación de edad → categoría → información de revisión → capturas de pantalla →
                             # suscripción → verificar

release ejecuta todo el pipeline (idempotente) y termina con check, que imprime los pasos restantes solo de interfaz de usuario. Las capturas de pantalla deben existir primero (config.screenshots.dir) — consulta references/screenshots.md para generarlas.

4. Los dos pasos solo de interfaz de usuario (entrega con clics exactos)

check los enumera cuando corresponden:

  1. Privacidad de la aplicación → Recopilación de datos: declara los tipos de datos que coinciden con el manifiesto de privacidad de la aplicación, luego Publicar. ⚠️ Si el binario incluye NSUserTrackingUsageDescription pero declaras que no hay seguimiento, la publicación estará bloqueada → elimina la clave, recompila (references/gotchas.md).
  2. Primera suscripción: página de versión → Compras dentro de la aplicación y suscripciones → Seleccionar → → Guardar → Agregar para revisión → Enviar. (La API no puede adjuntar una primera suscripción).

5. Enviar

node cli.mjs check                 # confirma que no falta nada
node cli.mjs submit --submit       # solo aplicación / actualizaciones (sin primera compra dentro de la aplicación)

Para una primera suscripción, el usuario envía en la interfaz de usuario (paso 4.2). Verifica con status: versión y suscripción ambas en WAITING_FOR_REVIEW.

Rechazos

Si hay rechazo, la versión vuelve a ser editable (REJECTED/METADATA_REJECTED/DEVELOPER_REJECTED). Lee el mensaje del centro de resolución, corrige (metadatos mediante release, o recompila si es un problema del binario), y vuelve a enviar.

Referencias

  • references/setup.md — creación de claves, registro de la aplicación, EAS, higiene de secretos.
  • references/gotchas.md — todas las trampas reales (léelo antes de la primera ejecución).
  • references/screenshots.md — generación de PNGs de tamaño exacto (HTML → Chrome sin cabeza).
  • references/config-template.json — configuración por aplicación (validada por lib/config.mjs).

Skills relacionados