Aus einer Coding-Assistant-Sitzung einen Fehlerbericht machen
Ein realistisches Beispiel, wie aus einer chaotischen KI-Debugging-Session ein GitHub- oder Jira-Bug-Report mit Repro, Evidenz und Aufgaben wird.
14. Mai 2026
Eine Debugging-Session mit einem Coding Assistant springt oft zwischen Hypothesen, Logs, Testideen und Fixversuchen. Ein Bug Report braucht dagegen eine klare Reproduktion und verwertbare Evidenz.
Highlight Reel
Debugging-Chat als Issue-taugliche Notiz teilen
Wähle Logs, Hypothesen und Repro-Schritte aus und teile daraus einen klaren Bug Report.
Das Beispiel ist fiktiv, aber typisch für GitHub Issues, Jira-Tickets oder interne Engineering-Notizen.
Für ein Engineering-Team zählt am Ende nicht, welche Hypothesen der Assistent ausprobiert hat, sondern was reproduzierbar ist: erwartetes Verhalten, tatsächliches Verhalten, Logs, betroffene Dateien und nächste Aufgabe.
Kurzantwort
- Der Bug Report sollte Erwartung, Ist-Verhalten, Repro, Evidenz, betroffenen Bereich, Hypothese und Aufgaben enthalten.
- Kennzeichne KI-Hypothesen als Hypothesen, nicht als bewiesene Ursache.
- Entferne irrelevante Promptwechsel und nicht geprüfte Fixideen.
Vorher: Auszug aus der KI-Sitzung
Ich: Der CSV-Import bricht manchmal ab.
KI: Prüfe Encoding, leere Spalten und Zeitüberschreitung.
Ich: Log sagt: Cannot read property 'trim' of undefined.
KI: Dann ist vermutlich ein optionales Feld leer. Suche im Mapping.
Ich: Test mit leerer Spalte reproduziert es.
KI: Ergänze Guard vor trim() und Testfall für leeres Feld.Nachher: Fehlerbericht
# CSV-Import bricht bei leerer optionaler Spalte ab
## Erwartetes Verhalten
Leere optionale Spalten werden übersprungen oder als leerer Wert importiert.
## Tatsächliches Verhalten
Der Import bricht mit „Cannot read property 'trim' of undefined“ ab.
## Repro-Schritte
1. CSV mit leerer optionaler Spalte hochladen.
2. Import starten.
3. Fehler im Mapping-Schritt beobachten.
## Evidenz
- Logauszug: trim() auf undefined.
- KI-Hypothese: optionales Feld wird vor trim() nicht geprüft.
## Aufgaben
- [ ] Guard vor trim() ergänzen.
- [ ] Testfall für leere optionale Spalte ergänzen.
- [ ] Fehlermeldung für ungültige CSV-Zeile prüfen.Was wurde verändert?
| Chat-Inhalt | Issue-Inhalt | Warum |
|---|---|---|
| Fehlermeldungen verstreut | Evidenzblock | schneller Review |
| KI-Vermutung | Root-Cause-Hypothese | nicht als Fakt verkaufen |
| Testversuche | Repro-Schritte | nachvollziehbar |
| Fixideen | Aufgabenliste | planbar |
Wie Highlight Reel hier hilft
Bei Coding-Assistenten ist der nützliche Teil selten die ganze Session. Highlight Reel hilft, Fehlermeldung, Hypothese, verworfene Fixes und den finalen Repro-Schritt aus der Unterhaltung zu lösen, damit ein Bug Report nicht wie ein Debug-Tagebuch gelesen werden muss.
Häufige Fragen
Darf ich KI-Hypothesen in Issues schreiben?
Ja, aber klar als Hypothese markieren.
Sollte der Chat im Issue verlinkt werden?
Nur wenn der Chat bereinigt ist oder der Empfänger Zugriff auf den gesamten Verlauf braucht.