CommunityCodierung & Entwicklunggithub.com

teefayb/claude-code-setup-demo

Diagnostizieren Sie einen fehlschlagenden oder flaky Vitest-Test oder einen fehlschlagenden CI-Check, finden Sie die Ursache und schlagen Sie die kleinste korrekte Lösung vor oder wenden Sie sie an. Verwenden Sie dies, wenn ein Test lokal oder in der CI fehlschlägt.

Was ist claude-code-setup-demo?

Diese Skill hilft Entwicklern, fehlschlagende Vitest-Tests oder CI-Checks schnell zu diagnostizieren und zu beheben. Sie ist nützlich, um die Ursache von Testfehlern zu identifizieren – sei es ein Code-Bug, ein veralteter Test, ein Test-Isolationsproblem oder ein Umgebungsproblem – und die kleinste korrekte Lösung vorzuschlagen oder anzuwenden. Die Skill unterstützt die Lokalisierung des Fehlers durch reproduzierbare Schritte, Analyse von Assertion-Diffs und Stacktraces, Git-Änderungsprotokolle und Klassifizierung der Fehlerursache. Sie ist für Claude Code und ähnliche KI-Agenten konzipiert, die mit Vitest-Tests und CI-Umgebungen arbeiten. Der Ablauf umfasst das Reproduzieren des Fehlers, das Lesen von Diffs und Stacktraces, das Finden von Änderungen, das Klassifizieren der Ursache und das Anwenden der minimalen Korrektur, ohne bestehende Assertions zu umgehen oder Daten unzulässig zu verändern. Die Skill stellt sicher, dass der Fix korrekt ist und der gesamte Test-Suite weiterhin bestanden wird.

Funktioniert mit✓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 Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Übernehmen Sie die Triage dieses Fehlers: $ARGUMENTS

Schritte

  1. Reproduzieren. Führen Sie nur die fehlschlagende Datei aus: npx vitest run <datei> (fügen Sie -t "<testname>" hinzu, um einzugrenzen). Wenn keine Datei angegeben wurde, führen Sie npm test aus und wählen Sie den ersten Fehler aus. Wenn der Test besteht, führen Sie ihn 5-mal aus (npx vitest run <datei> --repeat 4), um auf Flakiness zu prüfen.
  2. Lesen Sie den Assertion-Diff und den Stacktrace, bevor Sie den Code lesen. Nennen Sie die fehlschlagende Erwartung.
  3. Finden Sie heraus, was sich geändert hat: git log --oneline -10 -- <quellcode> <testdatei> und git diff main...HEAD -- <dateien>.
  4. Klassifizieren Sie die Ursache und sagen Sie, welche es ist:
    • Code-Bug — der Test ist richtig; beheben Sie den Quellcode.
    • Veralteter Test — das Verhalten wurde absichtlich geändert; aktualisieren Sie den Test und nennen Sie den Commit, der die Änderung bewirkt hat.
    • Test-Isolation — gemeinsamer Zustand zwischen Tests (Datendatei, Umgebungsvariable, Zeit, Reihenfolge). Überprüfen Sie in diesem Repository, ob der Test useTempDataFile() verwendet und ein explizites now an createLink übergibt, anstatt sich auf die Uhr zu verlassen.
    • Umgebung — Node-Version, fehlende Installation, nur in CI vorhandener Unterschied.
  5. Beheben Sie die Ursache. Überspringen, löschen oder lockern Sie niemals eine Assertion, nur damit der Test besteht. Bearbeiten Sie niemals data/seed.json, um einen Test zu bestehen, ohne dies zu erwähnen.
  6. Führen Sie die Datei erneut aus, dann npm test.
  7. Bericht: Ursache (ein Satz), Klassifizierung, die Behebung und die ausgeführten Befehle.

Individual skills in this repo

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

Verwandte Skills