Skill de Workflows EAS

Quando Usar

Use esta skill quando precisar de ajuda para entender e escrever arquivos YAML de workflow do EAS para projetos Expo. Use esta skill quando o usuário perguntar sobre CI/CD ou workflows em um contexto Expo ou EAS, mencionar .eas/workflows/ ou quiser ajuda com pipelines de build do EAS ou automação de implantação.

Ajude desenvolvedores a escrever e editar arquivos YAML de workflow CI/CD do EAS.

Documentação de Referência

Busque estes recursos antes de gerar ou validar arquivos de workflow. Primeiro, resolva o diretório desta skill e, em seguida, use o script de busca no seu diretório scripts/. Ele é implementado usando Node.js e armazena respostas em cache usando ETags para eficiência:

# Fetch resources
node <skill-dir>/scripts/fetch.js <url>

1. JSON Schema — https://api.expo.dev/v2/workflows/schema

   • É NECESSÁRIO buscar este schema
   • Fonte da verdade para validação
   • Todos os tipos de jobs e seus parâmetros obrigatórios/opcionais
   • Tipos de gatilhos e configurações
   • Tipos de runners, imagens de VM e todos os enums

2. Documentação de Sintaxe — https://raw.githubusercontent.com/expo/expo/refs/heads/main/docs/pages/eas/workflows/syntax.mdx

   • Visão geral da sintaxe YAML de workflow
   • Exemplos e explicações em inglês
   • Sintaxe de expressões e contextos

3. Jobs Pré-empacotados — https://raw.githubusercontent.com/expo/expo/refs/heads/main/docs/pages/eas/workflows/pre-packaged-jobs.mdx

   • Documentação para tipos de job pré-empacotados suportados
   • Parâmetros e saídas específicos do job

Não confie em valores memorizados; esses recursos evoluem à medida que novos recursos são adicionados.

Localização do Arquivo de Workflow

Workflows ficam em .eas/workflows/*.yml (ou .yaml).

Estrutura de Nível Superior

Um arquivo de workflow tem estas chaves de nível superior:

• name — Nome de exibição para o workflow
• on — Gatilhos que iniciam o workflow (pelo menos um é obrigatório)
• jobs — Definições de jobs (obrigatório)
• defaults — Padrões compartilhados para todos os jobs
• concurrency — Controle de execuções paralelas de workflow

Consulte o schema para a especificação completa de cada seção.

Expressões

Use a sintaxe ${{ }} para valores dinâmicos. O schema define os contextos disponíveis:

• github.* — Informações do repositório e evento do GitHub
• inputs.* — Valores das entradas do workflow_dispatch
• needs.* — Saídas e status de jobs dependentes
• jobs.* — Saídas de jobs (sintaxe alternativa)
• steps.* — Saídas de passos dentro de jobs personalizados
• workflow.* — Metadados do workflow

Geração de Workflows

Ao gerar ou editar workflows:

1. Busque o schema para obter os tipos de jobs atuais, parâmetros e valores permitidos
2. Valide se os campos obrigatórios estão presentes para cada tipo de job
3. Verifique se as referências de jobs em needs e after existem no workflow
4. Verifique se as expressões referenciam contextos e saídas válidos
5. Garanta que as condições if respeitem as restrições de comprimento do schema

Validação

Após gerar ou editar um arquivo de workflow, valide-o contra o schema:

# Install dependencies if missing
[ -d "<skill-dir>/scripts/node_modules" ] || npm install --prefix <skill-dir>/scripts

node <skill-dir>/scripts/validate.js <workflow.yml> [workflow2.yml ...]

O validador busca o schema mais recente e verifica a estrutura do YAML. Corrija quaisquer erros relatados antes de considerar o workflow completo.

Respondendo Perguntas

Quando os usuários perguntarem sobre opções disponíveis (tipos de jobs, gatilhos, tipos de runners, etc.), busque o schema e derive a resposta dele em vez de confiar em informações potencialmente desatualizadas.

Limitações

• Use esta skill apenas quando a tarefa corresponder claramente ao escopo do seu produto ou API upstream.
• Verifique comandos, comportamento de API, preços, cotas, credenciais e efeitos de implantação contra a documentação oficial atual antes de fazer alterações.
• Não trate exemplos gerados como substitutos para testes específicos do ambiente, revisão de segurança ou aprovação do usuário para ações destrutivas ou custosas.