/qa — Fluxo de Trabalho de Garantia de Qualidade
Execute este skill para realizar uma Garantia de Qualidade completa em alterações recentes ou em um arquivo específico.
Arquivos Alterados Recentemente
!git diff --name-only HEAD~1 2>/dev/null | head -20 || echo "nenhuma alteração recente detectada"
Fase 1: Reconhecimento
- Detectar framework de teste verificando:
Gemfilecom rspec/minitest → RSpec ou Minitestmix.exs→ ExUnitpackage.jsoncom jest/vitest → Jest ou Vitestplaywright.config→ Playwright
- Identificar arquivos alterados — se
$ARGUMENTSfor um caminho de arquivo, use esse; caso contrário, executegit diff --name-only HEAD~1 - Classificar cada arquivo por nível de risco:
- CRÍTICO: autenticação, pagamentos, modelos de dados, utilitários compartilhados, endpoints de API
- ALTO: lógica de negócio, serviços, controladores
- MÉDIO: visões, serializadores, helpers, configuração
- BAIXO: documentos, comentários, formatação
- Ler cada arquivo alterado e seus testes existentes (se houver). Se mais de ~5 arquivos
foram alterados, delegue essa leitura ao agente
codebase-explorere trabalhe a partir de seu resumo — mantenha o contexto principal para as perguntas e os testes. - Construir uma tabela de contexto:
| Arquivo | Tipo | Risco | Testes Existentes? |
|---|---|---|---|
| ... | ... | ... | ... |
Fase 2: Interrogatório
Antes de escrever qualquer teste, faça de 3 a 8 perguntas de sondagem usando AskUserQuestion. Agrupe as perguntas — não pergunte uma de cada vez.
Boas perguntas (focadas em risco):
- "Isso mexe no fluxo de pagamento — devo testar casos extremos de reembolso?"
- "A nova validação rejeita entrada em branco. E sobre strings apenas com unicode?"
- "Este serviço chama uma API externa — devo simulá-la ou testar a integração?"
Perguntas ruins (não faça estas):
- "O que este código faz?" (leia você mesmo)
- "Devo escrever testes?" (sim, sempre)
- "Qual framework de teste devo usar?" (detecte-o)
Fase 3: Plano de Teste
Apresente um plano de teste estruturado ANTES de escrever qualquer especificação. Organize por categoria:
Categorias de Teste
- Caminho Feliz — entradas esperadas produzem saídas esperadas
- Casos Limite — valores de fronteira, entradas vazias, valores máximos, nulo/nil
- Casos de Erro — entrada inválida, falhas de rede, timeouts, permissão negada
- Bizarras/Adversariais — strings de injeção SQL, tags de script, emoji, strings de 10MB, acesso concorrente
- Desempenho — consultas N+1, coleções ilimitadas, consultas lentas (apenas para risco CRÍTICO/ALTO)
- Integração — interações entre componentes (apenas quando múltiplos arquivos foram alterados)
Apresente como uma tabela:
| # | Categoria | Descrição do Teste | Nível de Risco |
|---|---|---|---|
| 1 | Caminho Feliz | Cria registro com parâmetros válidos | ALTO |
| ... | ... | ... | ... |
Aguarde a aprovação do usuário antes de prosseguir.
Fase 4: Escrita de Especificações
Escreva especificações seguindo estes padrões:
- Uma asserção por teste (quando prático)
- Nomes descritivos —
it "retorna 404 quando registro não é encontrado"nãoit "funciona" - Estrutura Organizar-Atuar-Afirmar
- Sem convidados misteriosos — todos os dados de teste visíveis no teste
- Teste comportamento, não implementação — não teste métodos privados diretamente
- Use fábricas/fixtures apropriadas ao framework
- Agrupe por comportamento com blocos
describe/context
Qualidade do Código de Teste
Testes também são código — aplique os mesmos princípios:
- KISS: Sem helpers de teste superengenhados. Se a configuração tem >10 linhas, simplifique o teste ou o código sob teste.
- YAGNI: Não teste cenários que não podem acontecer. Não adicione testes "por via das dúvidas" para estados impossíveis.
- DRY (com moderação): Prefira duplicação clara a exemplos compartilhados engenhosos. Um teste deve ser legível de cima a baixo sem pular para 3 arquivos auxiliares.
- Clean Code: Nomes de teste descritivos que leem como documentação. Sem convidados misteriosos — todos os dados visíveis no teste.
Veja @reference.md para notas de teste específicas do framework (RSpec, Minitest, ExUnit, Jest/Vitest).
Fase 5: Execução e Verificação
- Executar as novas especificações — execução direcionada (apenas o novo arquivo)
- Corrigir quaisquer falhas — leia o erro, leia a origem, corrija a causa raiz
- Executar a suíte completa — garantir que nada mais quebrou
- Produzir o relatório de QA — Veja @reference.md para o modelo de relatório, auditoria de valores centrais e verificação de racionalização.
Veredito: SHIP IT / FIX AND RE-TEST / NEEDS REWORK