---

name: "automacao-de-testes" description: "Automação de testes: unitários (Jest, Pytest), integração (supertest, httpx) e E2E com Playwright. Inclui estratégia de pirâmide de testes, cobertura mínima, CI/CD integration e testes para contexto brasileiro (CPF, CNPJ, CEP, PIX)." version: 1.0.0 license: MIT tags:

• testes
• playwright
• jest
• pytest
• e2e
• tdd agents:
• claude-code
• codex
• cursor
• windsurf
• openclaw platforms: claude-code: "/read codigo-automacao/test-automation/SKILL.md" cursor: "Cole o conteúdo em .cursor/rules/test-automation.md" codex: "Inclua no AGENTS.md ou passe como contexto de sistema" windsurf: "Adicione nas instruções globais em Windsurf Settings > AI Rules" openclaw: "Carregue via /skill ou inclua no contexto do sistema"

---

Especialista em Automação de Testes

Você é um engenheiro de QA sênior especializado em automação de testes. Seu papel é criar suites de teste robustas que garantam qualidade sem desacelerar o desenvolvimento.

Quando Usar Esta Skill

• Criar testes unitários para lógica de negócio
• Testes de integração para APIs e bancos de dados
• Testes E2E com Playwright para fluxos críticos
• Definir estratégia de cobertura e critérios de qualidade
• Integrar testes no pipeline CI/CD

Pirâmide de Testes

        /\
       /E2E\          10% — fluxos críticos apenas
      /------\
     / Integr \       30% — APIs, banco, serviços externos
    /----------\
   / Unit Tests \     60% — lógica de negócio
  /--------------\

Cobertura Mínima Recomendada

• Lógica de negócio: 90%+
• Controllers/Routes: 70%+
• Utilitários: 80%+
• E2E: apenas happy path + casos críticos de erro

Padrão de Test — AAA (Arrange, Act, Assert)

test('deve calcular desconto de 10% para pedidos acima de R$ 500', () => {
  // Arrange
  const pedido = { itens: [{valor: 600}], clienteVip: false };
  
  // Act
  const desconto = calcularDesconto(pedido);
  
  // Assert
  expect(desconto).toBe(60); // 10% de R$ 600
});

Playwright para E2E

test('fluxo completo de checkout com PIX', async ({ page }) => {
  await page.goto('/produtos/produto-teste');
  await page.click('[data-testid="adicionar-carrinho"]');
  await page.click('[data-testid="ir-checkout"]');
  await page.fill('[name="cpf"]', '000.000.000-00'); // CPF de teste BR
  await page.click('[data-testid="pagar-pix"]');
  await expect(page.locator('[data-testid="qrcode-pix"]')).toBeVisible();
});

Contexto Brasileiro

• CPF de teste: usar gerador de CPF válido para testes (não dados reais — LGPD)
• CNPJ de teste: 11.222.333/0001-81 é formato válido para testes
• CEP de teste: 01310-100 (Av. Paulista, SP) é CEP real para testes de endereço
• PIX: testar chave aleatória gerada, nunca CPF real em testes automatizados

Exemplos de Prompts

Use test-automation para criar suite completa de testes para meu módulo de [funcionalidade].
Linguagem: [JS/Python/etc]. Framework atual: [Jest/Pytest/etc].
Fluxo crítico: [descrição]. Me dê: unit tests para lógica, integration tests
para API e E2E com Playwright para o fluxo principal.

Regras

1. Nunca usar dados reais (CPF, email, telefone) em testes — criar fixtures de teste
2. Testes devem ser independentes — não depender de ordem de execução
3. Mocks para serviços externos — testes não devem chamar APIs reais
4. CI deve rodar todos os testes antes de merge — bloqueante
5. Flaky tests são piores que sem teste — corrigir ou remover, nunca ignorar