wjttc-tester
Ensina seu agente de IA a testar o código e achar erros antes dos usuários.
O que ela faz
Esta ferramenta executa planos de teste e gera relatórios detalhados sobre os resultados. Ela ajuda a encontrar e corrigir bugs, verificando se o código funciona corretamente em diferentes situações.
Quando usar
- ✓Executar um plano de teste existente.
- ✓Investigar e corrigir um bug reportado.
- ✓Validar o comportamento do código em casos extremos ou de erro.
Exemplo do que pedir para a IA
“Execute o plano de teste 'smoke' e me diga quais testes falharam.”
Quer saber mais? Abra as seções abaixo.
Como usar
O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.
Link da skill
Mensagem pronta para colar
Como funciona
A ferramenta roda os testes definidos em um plano, anota quais passaram e quais falharam, e gera um relatório com os detalhes, incluindo a causa e a correção dos problemas encontrados.
Instalação
Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.
No terminal (Claude Code, Codex, Cursor), na pasta do projeto:
npx skills add sickn33/agentic-awesome-skills --skill wjttc-testerOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/skills/wjttc-tester/SKILL.md -o SKILL.mdConteúdo técnico (SKILL.md)
Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.
Testador do Campeonato WJTTC
"Nós quebramos coisas para que outros nunca precisem saber que elas foram quebradas."
Aplique padrões inspirados na F1 aos testes de software. Assim como os freios devem funcionar impecavelmente em ritmo de corrida, o código em produção também deve. Esta habilidade executa planos de teste e registra relatórios — é o piloto, não o engenheiro. Para planejar e gerar o conjunto de testes, use wjttc-builder.
Quando usar esta habilidade
- Executar um plano de teste existente ou recém-escrito e relatar os resultados
- Reproduzir e identificar a causa raiz de um bug reportado
- Validação de casos extremos / tratamento de erros / regressão
- Auditar se o sinal de CI do conjunto de testes ainda pode ser confiável
- Produzir um relatório WJTTC com um veredito de nível
Os cinco níveis do WJTTC
Triagem de cada teste pelo raio de impacto. Os três primeiros definem a gravidade; Pneu e Pit cobrem durabilidade e o portão de liberação.
| Nível | Símbolo | Significado | Exemplos |
|---|---|---|---|
| Freio | 🚨 | Crítico para a vida — falha catastrófica | perda de dados, bypass de autenticação, erros de pagamento, operações destrutivas sem confirmação |
| Motor | ⚡ | Crítico para o desempenho — resultados incorretos / UX ruim | precisão da API, transformações de dados, cálculos, conformidade de formato, desempenho |
| Aerodinâmica | 🏁 | Polimento e casos extremos — inconveniente menor | peculiaridades da UI, formatação rara de mensagens, limites de recursos opcionais, documentação |
| Pneu | 🛞 | Durabilidade sob carga — degradação ao longo do tempo | estresse/volume, concorrência, crescimento de memória, entradas grandes |
| Pit | 🔧 | Portão de liberação — a parada que permite seguir em frente | suíte de fumaça/regressão, CI verde, relatório WJTTC registrado |
Teste o Freio primeiro. Se os freios não funcionarem, nada mais importa.
Passo 0 — Pré-auditoria de Integridade do Sinal (execute ANTES de adicionar/executar qualquer coisa nova)
CI vermelho é um contrato: deve sempre significar "pare, olhe, corrija." Uma suíte com alta cobertura, mas com falhas intermitentes, é menos confiável do que uma suíte menor com zero alarmes falsos — porque a equipe parou de ler os alertas vermelhos. Corrija o sinal antes de adicionar mais testes.
Método — classifique os últimos 30 dias de falhas de CI:
| Categoria | Definição | Veredito |
|---|---|---|
| Bug real | Vermelho mapeado para um defeito real; corrigido por uma alteração de código | ✓ Sinal funcionou |
| Falha intermitente | Ruído de tempo/rede/concorrência; passou na nova execução, sem alteração de código | ✗ Defeito de design do teste |
| Infra | Segredo ausente, alteração na imagem do runner, dependência upstream — não o código | ✗ Defeito de design do fluxo de trabalho |
Pontuação de Integridade do Sinal: SI = Real bugs / (Real bugs + Flakes + Infra) × 100
| % SI | Veredito | Ação |
|---|---|---|
| 100% | ✪ | Manter — sinal exemplar |
| 95–99% | ★ Campeonato | Anotar qualquer falha intermitente imediatamente |
| 85–94% | ◇ Aceitável | Agendar a correção da classe de falha intermitente nesta sprint |
| 70–84% | ● Erodindo | Parar de adicionar testes — corrigir falhas intermitentes primeiro |
| <70% | ○ Sinal morto | Bloquear merges até que o sinal seja restaurado |
Eliminar à vista: asserções de desempenho de tempo absoluto rígidas em runners compartilhados (expect(t).toBeLessThan(30)) → mover para um fluxo de trabalho não restritivo; chamadas de rede na suíte principal → mockar na fronteira; testes de concorrência sem ordenação explícita; etapas dependentes de segredos que falham rigidamente quando ausentes → ignorar cinza.
A regra inversa: CI verde que passa enquanto algo está quebrado é igualmente uma violação. Se um bug real foi lançado apesar do CI verde, escreva o teste de regressão ANTES que a correção seja aplicada.
A conversa é o verdadeiro portão. O CI é infraestrutura de suporte para a auditoria humana + IA; CI intermitente desperdiça a largura de banda da auditoria. A Integridade do Sinal mantém o CI digno da conversa.
Loop de execução
- Escopo — o que deve fazer? caminho feliz, casos extremos, modos de falha, metas de desempenho, nível de cada um.
- Auditar sinal (Passo 0) antes de confiar ou estender a suíte.
- Executar cada teste: configurar, preparar dados, executar, observar o real vs. o esperado, registrar aprovação/falha/bloqueado, capturar evidências em caso de falha.
- Reproduzir deterministicamente cada falha; identificar a causa raiz; anotar a correção.
- Verificação de cobertura por nível — confirmar que cada teste está nivelado:
faf wjttc --path tests # audit tier coverage (vendor-neutral) faf wjttc --strict --json # CI gate: non-zero if any test is untiered - Relatório — registrar o relatório WJTTC (abaixo), então apresentar o veredito de nível.
Formato do relatório WJTTC
Salve os relatórios em ./wjttc-reports/ no projeto sob teste (ou em um caminho especificado pelo usuário). Nunca escreva em um caminho absoluto/pessoal. Nomeie os arquivos YYYY-MM-DD-{project}-{feature}-tests.yaml.
---
# Relatório de Teste WJTTC
projeto: "nome-do-projeto"
…
Perguntas frequentes
O que são os 'tiers' (Brake, Engine, Aero, Tyre, Pit)?
São categorias que classificam a gravidade de um problema, inspiradas nas categorias de segurança da Fórmula 1. Brake é crítico (vida), Engine é importante (funcionalidade), Aero é cosmético, Tyre é sobre durabilidade e Pit é sobre a liberação do produto.
O que é 'Signal Integrity'?
É uma métrica que mede a confiabilidade dos resultados dos testes. Se os testes falham com frequência por motivos aleatórios (flakiness), a confiança nos resultados diminui, e a ferramenta ajuda a identificar e corrigir isso.
Qual a diferença entre wjttc-tester e wjttc-builder?
wjttc-builder é usado para planejar e criar os testes, enquanto wjttc-tester é usado para executar esses testes e gerar os relatórios.
Detalhes
Descrição original do autor
F1-inspired test EXECUTOR + reporter. Runs a test plan, finds and reproduces bugs, audits suite signal integrity, then files a WJTTC report (Brake/Engine/Aero/Tyre/Pit) with a tier verdict.
Popularidade
- Estrelas no GitHub
- 48 mil
- Posição no ranking
- #4578
- Licença
- MIT
- Atualizada em
- 15/10/2026
Comentários
- …
Mais skills deste repositório
00-andruia-consultant
Ajuda seu agente a iniciar ou melhorar projetos de IA. Ele analisa código, sugere ferramentas e cria planos de ação em espanhol.
sickn33/agentic-awesome-skills
007
Faz seu agente realizar auditorias de segurança e modelagem de ameaças. É útil para proteger projetos contra ataques e vulnerabilidades.
sickn33/agentic-awesome-skills
10-andruia-skill-smith
Ajuda seu agente a criar ou melhorar ferramentas de IA. Ele define como as ferramentas funcionam, escreve a documentação e valida a estrutura.
sickn33/agentic-awesome-skills
20-andruia-niche-intelligence
Faz seu agente criar um resumo sobre um setor específico. É útil para entender o contexto, regras, padrões de uso e riscos de um projeto, usando fontes confiáveis.
sickn33/agentic-awesome-skills
Skills parecidas
cpp-testing
Faz seu agente escrever e melhorar testes para código C++. Ajuda a configurar ferramentas de teste e a corrigir erros.
affaan-m/ECC
csharp-testing
Ajuda seu agente a criar testes para código C# e .NET. Ele usa as melhores práticas para garantir que os testes sejam eficientes e confiáveis.
affaan-m/ECC
django-tdd
Faz seu agente aplicar estratégias de teste para Django com pytest-django e TDD. É útil para escrever testes robustos e garantir a qualidade do código, especialmente para APIs DRF.
affaan-m/ECC