teefayb/claude-code-setup-demo

Diagnostique um teste Vitest com falha ou instável ou uma verificação de CI com falha, encontre a causa raiz e proponha ou aplique a menor correção correta. Use quando um teste falhar localmente ou no CI.

O que é claude-code-setup-demo?

Esta skill orienta agentes de IA (como Claude Code) no processo de diagnóstico e correção de falhas em testes Vitest ou verificações de CI. Ela fornece um fluxo de trabalho estruturado em 7 etapas que inclui reprodução do teste, leitura de diffs de asserção e stack traces, análise de histórico de alterações com git, classificação da causa raiz (bug de código, teste desatualizado, isolamento de teste ou ambiente), aplicação da correção mínima sem remover asserções, e re-execução para verificação. É útil para desenvolvedores que precisam de assistência automatizada para depuração de testes em projetos JavaScript/TypeScript que usam Vitest. A skill se apoia em comandos CLI e ferramentas padrão (git, npx vitest), e enfatiza que nenhuma asserção deve ser removida ou enfraquecida apenas para fazer o teste passar.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/teefayb/claude-code-setup-demo/tree/HEAD/.claude/skills/triage-test

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Faça o diagnóstico desta falha: $ARGUMENTS

Etapas

  1. Reproduza. Execute apenas o arquivo com falha: npx vitest run <arquivo> (adicione -t "<nome do teste>" para restringir). Se nenhum arquivo foi fornecido, execute npm test e escolha a primeira falha. Se passar, execute 5 vezes (npx vitest run <arquivo> --repeat 4) para verificar instabilidade.
  2. Leia o diff da asserção e o stack trace antes de ler o código. Nomeie a expectativa que está falhando.
  3. Descubra o que mudou: git log --oneline -10 -- <arquivo de código fonte> <arquivo de teste> e git diff main...HEAD -- <arquivos>.
  4. Classifique a causa e diga qual é:
    • Bug no código — o teste está correto; corrija o código fonte.
    • Teste desatualizado — o comportamento foi alterado de propósito; atualize o teste e diga qual commit o alterou.
    • Isolamento do teste — estado compartilhado entre testes (arquivo de dados, variável de ambiente, tempo, ordenação). Neste repositório, verifique se o teste usa useTempDataFile() e passa um now explícito para createLink em vez de depender do relógio.
    • Ambiente — versão do Node, instalação ausente, diferença específica do CI.
  5. Corrija a causa raiz. Nunca pule, exclua ou afrouxe uma asserção apenas para fazê-la passar, e nunca edite data/seed.json para satisfazer um teste sem informar isso.
  6. Reexecute o arquivo, depois npm test.
  7. Relate: causa (uma frase), classificação, a correção e os comandos executados.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Habilidades Relacionadas