JaminZhou/asc-tooling

O que asc-tooling faz?

Use este skill ao trabalhar com asc_tooling, o kit de ferramentas CLI reutilizável do App Store Connect.

Regras de Segurança

• Nunca peça ao usuário para colar conteúdos de chaves .p8, JWTs, cookies, dados da conta do App Store Connect ou segredos de produtos não publicados.
• Mantenha a geração de capturas de tela específicas do produto, notas de revisão, arquivos de metadados e estado de lançamento no repositório do produto consumidor.
• Trate os auxiliares de sessão do navegador em experimental/ como locais e não suportados; não os use em CI ou scripts de lançamento compartilhados.
• Comandos de mutação devem ser explícitos. Prefira --dry-run antes de ações que criem ou atualizem o estado do App Store Connect.
• Se o comportamento da API da Apple for incerto, relate o que foi verificado e o que ainda precisa de confirmação manual no App Store Connect.

Pontos de Entrada da CLI

Prefira a CLI unificada quando disponível:

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

Os nomes de executáveis legados permanecem suportados:

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

Ambiente

A maioria dos comandos requer credenciais da API do App Store Connect:

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

asc-sales também precisa de ASC_VENDOR_NUMBER, a menos que seja passado como --vendor-number.

Fluxo de Trabalho

1. Identifique o repositório do produto e a superfície de comando: revisão, metadados, beta, vendas, capturas de tela, IAP, versão, disponibilidade ou configuração da loja.
2. Leia primeiro os documentos ou scripts de lançamento específicos do produto; mantenha os valores específicos do produto lá.
3. Use comandos de status ou dry-run antes de comandos de mutação.
4. Resuma a execução do comando, as entradas usadas, a fonte da verdade e qualquer confirmação ainda necessária na interface web do App Store Connect.
5. Nunca salve segredos ou exportações de sessão do navegador no repositório.

Instalação do Skill

Instale ou atualize este skill através da CLI fornecida:

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 em $CODEX_HOME/skills ou ~/.codex/skills. --client agents instala na pasta de usuário do open Agent Skills, ~/.agents/skills. --client claude instala em $CLAUDE_CONFIG_DIR/skills ou ~/.claude/skills.