O que Analisador de Cobertura de Testes faz?
Esta skill ajuda a identificar lacunas na cobertura de testes e sugere casos de teste específicos para melhorar a qualidade do código.
Quando Usar Esta Skill
- O usuário pede para analisar a cobertura de testes
- O usuário deseja melhorar a cobertura de testes
- O usuário solicita sugestões para testes faltantes
- Trabalhando para aumentar a porcentagem de cobertura de código
- O usuário menciona "lacunas de cobertura", "código não testado" ou "sugestões de teste"
Instruções
1. Detectar Framework de Teste
Identifique o(s) framework(s) de teste usado(s) no projeto:
JavaScript/TypeScript:
- Jest:
jestno package.json oujest.config.js - Mocha:
mochano package.json ou.mocharc - Vitest:
vitestno package.json ouvitest.config.js - Jasmine:
jasmineno package.json
Python:
- pytest:
pytestno requirements.txt oupytest.ini - unittest: Biblioteca padrão, verifique arquivos de teste
- coverage.py:
coverageno requirements.txt
Ruby:
- RSpec:
rspecno Gemfile - Minitest: Biblioteca padrão
Go:
- Integrado:
go test(cobertura viago test -cover)
Java:
- JUnit: Procure por JUnit no pom.xml ou build.gradle
- JaCoCo: Configuração da ferramenta de cobertura
Use Glob e Grep para encontrar arquivos de configuração.
2. Localizar Relatórios de Cobertura
Encontre relatórios de cobertura existentes:
Locais comuns:
- Diretório
coverage/ .nyc_output/(NYC para Node.js)htmlcov/(coverage.py para Python)target/site/jacoco/(JaCoCo para Java)- Arquivos de cobertura:
lcov.info,coverage.json,.coverage
Se nenhum relatório de cobertura existir:
- Oriente o usuário a executar a cobertura:
npm test -- --coverage,pytest --cov, etc. - Aguarde a geração do relatório antes de analisar
3. Analisar Dados de Cobertura
Extraia informações de cobertura:
Do lcov.info:
- Linhas cobertas vs. total
- Funções cobertas vs. total
- Ramificações cobertas vs. total
- Números de linhas não cobertas por arquivo
Do coverage.json (Jest):
- Porcentagem de cobertura de declarações
- Porcentagem de cobertura de ramificações
- Porcentagem de cobertura de funções
- Porcentagem de cobertura de linhas
- Linhas não cobertas por arquivo
Do .coverage (Python):
- Use
coverage reportoucoverage json - Intervalos de linhas perdidas
- Linhas excluídas
De relatórios HTML:
- Leia as estatísticas resumidas
- Identifique arquivos com baixa cobertura
4. Identificar Lacunas de Cobertura
Priorize arquivos/funções que precisam de teste:
Alta prioridade:
- Lógica de negócios com 0% de cobertura
- APIs públicas e funções exportadas
- Caminhos de tratamento de erros (blocos catch, callbacks de erro)
- Casos extremos e condições de contorno
- Caminhos críticos (autenticação, pagamento, validação de dados)
Prioridade média:
- Funções utilitárias com cobertura parcial
- Funções privadas chamadas por APIs públicas
- Código de configuração e inicialização
Prioridade baixa:
- Getters/setters simples
- Definições de tipo
- Código gerado automaticamente
- Código de terceiros
5. Analisar Caminhos de Código Não Testados
Para cada arquivo com lacunas de cobertura:
- Leia o arquivo fonte para entender a estrutura do código
- Identifique código não testado:
- Linhas e intervalos de linhas não cobertas
- Ramificações condicionais não testadas (if/else)
- Manipuladores de erro não cobertos
- Cobertura de função ausente
- Categorize os testes ausentes:
- Testes de caminho feliz
- Testes de erro/exceção
- Testes de caso extremo
- Testes de integração
6. Gerar Sugestões de Teste
Para cada lacuna de cobertura, sugira casos de teste específicos:
Formato:
Arquivo: src/utils/validator.js (42% de cobertura)
Cobertura Ausente:
- Linhas 15-18: Caminho de erro de validação de e-mail
- Linhas 23-25: Tratamento de entrada vazia
- Linhas 30-35: Caso extremo para caracteres especiais
Testes Sugeridos:
1. Testar validação de e-mail com formato inválido (cobre linhas 15-18)
2. Testar validador com entrada de string vazia (cobre linhas 23-25)
3. Testar tratamento de caracteres especiais em nomes (cobre linhas 30-35)
Detalhes do caso de teste devem incluir:
- Descrição do teste
- Dados de entrada
- Saída/comportamento esperado
- Linhas/ramificações cobertas
7. Criar Stubs de Teste (Opcional)
Se o usuário desejar, gere stubs de arquivos de teste:
- Use a sintaxe apropriada do framework de teste
- Inclua blocos describe/test com comentários TODO
- Adicione estrutura de exemplo de teste
- Referencie o modelo em
templates/test-template.js(ou extensão apropriada)
Exemplo (Jest):
describe('Validator', () => {
describe('validateEmail', () => {
it('deve rejeitar formato de e-mail inválido', () => {
// TODO: Testar caminho de erro de validação de e-mail (linhas 15-18)
const result = validateEmail('invalid-email');
expect(result.valid).toBe(false);
});
it('deve tratar entrada de string vazia', () => {
// TODO: Testar tratamento de entrada vazia (linhas 23-25)
});
});
});
8. Calcular Métricas de Cobertura
Forneça estatísticas resumidas:
- Porcentagem de cobertura geral
- Cobertura por arquivo/diretório
- Funções/métodos sem testes
- Arquivos críticos com baixa cobertura
- Tendência de cobertura (se houver dados históricos disponíveis)
9. Priorizar Recomendações
Ordene as sugestões por:
- Impacto: Lógica de negócios crítica primeiro
- Risco: Áreas de alto risco (segurança, integridade de dados)
- Complexidade: Lógica complexa precisa de mais testes
- Facilidade: Vitórias rápidas (testes simples para alto ganho de cobertura)
10. Formato de Saída
Apresente os resultados em um formato claro e acionável:
Resumo da Análise de Cobertura
==============================
Cobertura Geral: 67%
- Declarações: 65%
- Ramificações: 58%
- Funções: 72%
- Linhas: 67%
Arquivos que Precisam de Atenção (ordenados por prioridade):
1. src/payment/processor.js (23% de cobertura) - ALTA PRIORIDADE
- Ausente: Tratamento de erros para falhas de pagamento
- Ausente: Testes de lógica de repetição
- Ausente: Validação de transação
2. src/auth/validator.js (45% de cobertura) - PRIORIDADE MÉDIA
- Ausente: Tratamento de token inválido
- Ausente: Testes de sessão expirada
Casos de Teste Sugeridos:
[Sugestões detalhadas para cada arquivo]
Melhores Práticas
- Foque em cobertura significativa: 100% de cobertura nem sempre é necessário
- Teste comportamento, não implementação: Sugira testes que verifiquem funcionalidade
- Priorize caminhos críticos: Autenticação, pagamentos, validação de dados primeiro
- Considere tipos de teste: Unitários, integração e e2e quando apropriado
- Verifique testes existentes: Não sugira testes que já existem
- Dados de teste realistas: Use entradas plausíveis nos exemplos
- Limiares de cobertura: Sugira metas mínimas de cobertura (ex.: 80%)
Executando Relatórios de Cobertura
Forneça comandos com base no framework detectado:
Jest: npm test -- --coverage ou jest --coverage
Vitest: npm test -- --coverage ou vitest run --coverage
Mocha + NYC: nyc mocha
pytest: pytest --cov=src --cov-report=html
Go: go test -cover ./... ou go test -coverprofile=coverage.out
JUnit + JaCoCo: mvn test jacoco:report
Arquivos de Suporte
scripts/parse-coverage.sh: Script auxiliar para extrair dados de coberturatemplates/test-template.js: Modelo de arquivo de teste para JavaScripttemplates/test-template.py: Modelo de arquivo de teste para Pythontemplates/test-template.go: Modelo de arquivo de teste para Go