CommunityProgramación y desarrollogithub.com

teefayb/claude-code-setup-demo

Diagnostica una prueba Vitest fallida o inestable, o una verificación de CI fallida; encuentra la causa raíz y propone o aplica la corrección más pequeña y correcta. Úsalo cuando falle una prueba localmente o en CI.

¿Qué es claude-code-setup-demo?

Este skill está diseñado para diagnosticar y solucionar pruebas Vitest que fallan o son inestables, así como verificaciones de CI fallidas. Cuando se activa, el agente reproduce la falla ejecutando el archivo de prueba específico, analiza el diff de aserción y el stack trace, revisa los cambios recientes con comandos de git y clasifica la causa raíz en una de cuatro categorías: error de código (la prueba es correcta, la fuente debe corregirse), prueba desactualizada (el comportamiento cambió intencionalmente), aislamiento de prueba (estado compartido entre pruebas) o problema de entorno (versión de Node, falta de instalación). Luego aplica la corrección más pequeña posible sin eliminar ni relajar aserciones, y finalmente reporta la causa, clasificación, corrección y comandos ejecutados. Es útil para equipos que mantienen proyectos con pruebas Vitest y necesitan un flujo rápido y consistente para solucionar fallos.

Compatible con✓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 Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Diagnostica esta falla: $ARGUMENTS

Pasos

  1. Reproduce. Ejecuta solo el archivo que falla: npx vitest run <archivo> (añade -t "<nombre de prueba>" para acotar). Si no se proporcionó un archivo, ejecuta npm test y elige la primera falla. Si pasa, ejecútalo 5 veces (npx vitest run <archivo> --repeat 4) para verificar si es inestable.
  2. Lee el diff de aserción y el stack trace antes de leer el código. Nombra la expectativa que falla.
  3. Encuentra qué cambió: git log --oneline -10 -- <archivo fuente> <archivo de prueba> y git diff main...HEAD -- <archivos>.
  4. Clasifica la causa y di cuál es:
    • Error de código — la prueba está bien; corrige el código fuente.
    • Prueba desactualizada — el comportamiento cambió intencionalmente; actualiza la prueba y di qué commit lo cambió.
    • Aislamiento de prueba — estado compartido entre pruebas (archivo de datos, variable de entorno, tiempo, orden). En este repositorio, verifica que la prueba use useTempDataFile() y pase un now explícito a createLink en lugar de depender del reloj.
    • Entorno — versión de Node, instalación faltante, diferencia solo en CI.
  5. Corrige la causa raíz. Nunca omitas, elimines ni relajes una aserción solo para que pase, y nunca edites data/seed.json para satisfacer una prueba sin decirlo.
  6. Vuelve a ejecutar el archivo y luego npm test.
  7. Reporta: la causa (una oración), la clasificación, la corrección y los comandos ejecutados.

Individual skills in this repo

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

Skills relacionados