Wie beschreiben Sie einen Bug einem KI-Assistenten, damit dieser ihn genau diagnostizieren kann?

Question

Accepted Answer

Ein guter Bug-Report für eine KI ist dasselbe wie ein guter Bug-Report für einen Menschen: Geben Sie ihr **genug Kontext, um das Problem in ihrem Kopf nachzustellen**, und reduzieren Sie das Rauschen. Die KI kann nur über das nachdenken, was Sie einfügen — vage Beschreibungen führen zu vagen Vermutungen.

## Was gehört hinein

- **Die genaue Fehlermeldung und der vollständige Stack Trace** — kopieren Sie ihn wörtlich, nicht paraphrasiert. Die Datei und die Zeile im Trace sind der einzelne nützlichste Hinweis.
- **Der relevante Code** — die Funktion, die die Exception wirft, plus ihre unmittelbaren Aufrufer, nicht das ganze Repo.
- **Erwartetes vs. tatsächliches Verhalten** — "Ich erwarte X, aber ich bekomme Y" ist der Kern jeden Bug-Reports.
- **Repro-Schritte** — die genaue Eingabe oder Sequenz, die es auslöst.
- **Umgebung/Versionen** — Sprache, Framework- und Bibliotheksversionen (ein Bug kann versionsspezifisch sein).
- **DB-Schema oder Beispieldaten** — wenn der Bug eine Abfrage oder Datenform betrifft.

## Was man weglassen sollte

Un­zusammenhängende Dateien, Ihre ganze Konfiguration, Geheimnisse/API-Schlüssel und "Ich denke, es könnte X sein"-Theorien, die die Diagnose beeinflussen. Geben Sie Fakten, keine Vermutungen.

## Schwacher vs. starker Report

```text
❌ WEAK: "My login is broken, it throws an error. Why?"
   → no error text, no code, no repro → the AI can only guess

✅ STRONG:
   Error (verbatim):
     TypeError: Cannot read properties of undefined (reading 'id')
       at getUser (auth.js:42)
   Code (auth.js:40-43):
```

```js
function getUser(token) {
  const session = sessions.find(s => s.token === token); // returns undefined if not found
  return session.user.id; // line 42: crashes when session is undefined
}
```

```text
   Expected: return null for an unknown token.
   Actual:   throws TypeError above.
   Repro:    call getUser('expired-token').
   Env:      Node 20, no framework.
```

Mit der starken Version kann die KI direkt auf die fehlende `undefined`-Prüfung hinweisen und einen Guard vorschlagen, denn jede Tatsache, die sie braucht, steht auf der Seite.

## Warum es wichtig ist

Ein KI-Assistent hat **keinen Zugriff auf Ihr laufendes System** — er denkt nur über das nach, was Sie liefern. Ein schwacher Report zwingt ihn, gleichzeitig über den Bug, den Code und die Umgebung zu raten, und eine falsche Vermutung verschwendet einen Roundtrip. Ein starker Report (genaue Trace + relevanter Code + erwartet/tatsächlich + Repro + Versionen) macht die Diagnose zu einer fokussierten Aufgabe und bekommt normalerweise die richtige Behebung beim ersten Versuch. Zu lernen, wie man enge Bug-Reports schreibt, macht Sie auch selbst zu einem besseren Debugger, denn es zwingt Sie, die Fakten zu isolieren, bevor Sie fragen.