Issue Triage (Problemuntersuchung)
Untersuche ein gemeldetes Problem, finde seine Ursache und erstelle ein GitHub-Issue mit einem TDD-Fixplan. Dies ist ein weitgehend automatischer Workflow – minimiere Rückfragen an den Benutzer.
Ablauf
1. Problem erfassen
Erhalte eine kurze Beschreibung des Problems vom Benutzer. Falls keine Beschreibung vorliegt, stelle EINE Frage: „Welches Problem beobachtest du?“
Stelle noch KEINE weiteren Fragen. Beginne sofort mit der Untersuchung.
2. Erkunden und Diagnose
Verwende das Agent-Tool mit subagent_type=Explore, um die Codebasis gründlich zu untersuchen. Ziel ist es, folgendes zu finden:
- Wo der Fehler auftritt (Einstiegspunkte, UI, API-Antworten)
- Welcher Codepfad betroffen ist (verfolge den Ablauf)
- Warum er fehlschlägt (die Ursache, nicht nur das Symptom)
- Welcher verwandte Code existiert (ähnliche Muster, Tests, benachbarte Module)
Sieh dir folgendes an:
- Relevante Quelldateien und ihre Abhängigkeiten
- Vorhandene Tests (was wird getestet, was fehlt)
- Kürzliche Änderungen an betroffenen Dateien (
git logfür relevante Dateien) - Fehlerbehandlung im Codepfad
- Ähnliche Muster an anderen Stellen der Codebasis, die korrekt funktionieren
3. Lösungsansatz identifizieren
Basierend auf deiner Untersuchung ermittle:
- Die minimale Änderung, die zur Behebung der Ursache nötig ist
- Welche Module/Schnittstellen betroffen sind
- Welches Verhalten durch Tests verifiziert werden muss
- Ob es sich um einen Regression, eine fehlende Funktion oder einen Designfehler handelt
4. TDD-Fixplan entwerfen
Erstelle eine konkrete, geordnete Liste von ROT-GRÜN-Zyklen. Jeder Zyklus ist ein vertikaler Ausschnitt:
- ROT: Beschreibe einen spezifischen Test, der das fehlerhafte/fehlende Verhalten erfasst
- GRÜN: Beschreibe die minimale Codeänderung, um diesen Test zu bestehen
Regeln:
- Tests überprüfen das Verhalten über öffentliche Schnittstellen, nicht über Implementierungsdetails
- Ein Test nach dem anderen, vertikale Ausschnitte (NICHT zuerst alle Tests, dann den gesamten Code)
- Jeder Test sollte interne Refactorings überleben
- Füge bei Bedarf einen abschließenden Refactoring-Schritt hinzu
- Beständigkeit: Schlage nur Korrekturen vor, die radikale Codeänderungen überleben würden. Beschreibe Verhalten und Verträge, nicht die interne Struktur. Tests prüfen beobachtbare Ergebnisse (API-Antworten, UI-Zustand, sichtbare Effekte), nicht den internen Zustand. Ein guter Vorschlag liest sich wie eine Spezifikation; ein schlechter wie ein Diff.
5. GitHub-Issue erstellen
Erstelle ein GitHub-Issue mit gh issue create und der folgenden Vorlage. Frage den Benutzer NICHT um Überprüfung vor der Erstellung – erstelle es einfach und teile die URL.
Problem
Eine klare Beschreibung des Fehlers oder Problems, einschließlich:
- Was passiert (tatsächliches Verhalten)
- Was passieren sollte (erwartetes Verhalten)
- Wie zu reproduzieren (falls zutreffend)
Ursachenanalyse
Beschreibe, was du bei der Untersuchung gefunden hast:
- Der betroffene Codepfad
- Warum der aktuelle Code fehlschlägt
- Begünstigende Faktoren
Füge NICHT spezifische Dateipfade, Zeilennummern oder Implementierungsdetails ein, die an das aktuelle Code-Layout gekoppelt sind. Beschreibe stattdessen Module, Verhalten und Verträge. Das Issue sollte auch nach größeren Refactorings nützlich bleiben.
TDD-Fixplan
Eine nummerierte Liste von ROT-GRÜN-Zyklen:
-
ROT: Schreibe einen Test, der [erwartetes Verhalten beschreibt] GRÜN: [Minimale Änderung, um ihn zu bestehen]
-
ROT: Schreibe einen Test, der [nächstes Verhalten beschreibt] GRÜN: [Minimale Änderung, um ihn zu bestehen]
...
REFACTOR: [Aufräumarbeiten, die nach Bestehen aller Tests nötig sind]
Akzeptanzkriterien
- Kriterium 1
- Kriterium 2
- Alle neuen Tests bestehen
- Vorhandene Tests bestehen weiterhin
Nachdem du das Issue erstellt hast, gib die Issue-URL und eine einzeilige Zusammenfassung der Ursache aus.