CommunityCodierung & Entwicklunggithub.com

mtai0524/claude-skills

Systematisches Debugging, das die Ursache findet und behebt, statt Symptome zu überdecken. Nutzbar für jeden Bug, Fehler, fehlschlagenden Test oder unerwartetes Verhalten.

Was ist claude-skills?

Diese Skill-Anleitung führt Entwickler durch einen sechsstufigen Debugging-Prozess, der darauf abzielt, die eigentliche Ursache eines Fehlers zu identifizieren und zu beheben, anstatt nur Symptome zu behandeln. Sie ist für jede Art von Bug, Fehlermeldung, fehlschlagendem Test oder unerwartetem Verhalten geeignet und unterstützt alle Plattformen, die auf Markdown-Dokumentation für KI-Agenten setzen, wie Claude Code, Cursor oder Codex. Die Schritte umfassen das Reproduzieren des Fehlers, das Lokalisieren der fehlerhaften Codezeile, das Aufstellen einer fundierten Hypothese, das einmalige Beheben der Ursache auf Quellcode-Ebene sowie das Verifizieren des Fixes durch Tests. Die Anleitung betont ausdrücklich, keine Fehler zu unterdrücken, blinde `try/catch`-Blöcke einzufügen oder Wiederholungen ohne Verständnis der Fehlerursache zu versuchen.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mtai0524/claude-skills/tree/HEAD/skills/debug-root-cause

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

Debugging der Ursache

  1. Reproduzieren: Erhalte die exakte Fehlermeldung, den Stacktrace und die kleinsten Schritte, die den Fehler auslösen. Wenn du ihn nicht reproduzieren kannst, sage dies, bevor du rätst.
  2. Lokalisieren: Folge dem Stacktrace zur fehlschlagenden Zeile und lies dann rückwärts bis zu der Stelle, an der der fehlerhafte Zustand erzeugt wurde.
  3. Hypothese aufstellen: Formuliere eine Ursache in einem Satz. Verifiziere sie mit einem Log, einem Test oder durch Lesen des Codes. Keine Behebung, bevor die Ursache bestätigt ist.
  4. Einmalig an der Quelle beheben: Durchsuche alle Aufrufer der Funktion, die du änderst; behebe den gemeinsamen Code, nicht jede Aufrufstelle.
  5. Beweisen: Füge einen Test hinzu oder führe einen Test aus, der vor der Behebung fehlschlug und danach erfolgreich ist, und führe die zugehörigen Tests erneut aus. Kein Testprojekt: Baue das betroffene Projekt und gehe den Fehlerfall im Code Schritt für Schritt durch.
  6. Melden: Ursache, Behebung, Überprüfung – drei Zeilen.

Niemals: den Fehler unterdrücken, einen blinden try/catch hinzufügen oder wiederholen, ohne zu verstehen, warum es fehlschlug.

Individual skills in this repo

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

Verwandte Skills