So schreibst du einen guten Fehlerbericht (für eine KI oder einen Entwickler)

Ein guter Fehlerbericht ermöglicht es jemand anderem, einem Entwickler oder einer KI, dasselbe Problem zu sehen, das du gesehen hast, ohne dir eine Rückfrage zu stellen. Er braucht einen konkreten Titel, die genauen Schritte zum Nachstellen, was du erwartet hast, was tatsächlich passiert ist, jede Fehlermeldung wortwörtlich kopiert und die Angabe, wo es passiert ist: welche Seite, welcher Browser, welches Gerät und welcher Nutzer. Ein Fehler pro Bericht, mit einem Screenshot, wenn er hilft.

Die meisten Fehler sind schwerer zu verstehen als zu beheben. Ein klarer Bericht nimmt den Verständnisteil weg. Das ist bei KI-Werkzeugen noch wichtiger: Eine KI kann nicht nachfragen, was du mit „Die Kasse ist komisch“ gemeint hast. Sie rät also, und ein falscher Tipp kann etwas anderes kaputt machen.

Die Vorlage

Kopiere sie und fülle sie aus:

Titel: [Was ist falsch, wo] — z. B. „Buchungsformular lehnt Uhrzeiten nach 18 Uhr ab“

Schritte zum Nachstellen:
1. ...
2. ...
3. ...

Erwartet: [was passieren sollte]
Tatsächlich: [was stattdessen passiert ist]

Fehlermeldung: [genauer Text, falls vorhanden]
Wo: [Seite/URL, Browser, Gerät, angemeldet als welcher Nutzer]
Wie oft: [jedes Mal / manchmal / einmal]
Screenshot oder Aufnahme: [angehängt]

Der Rest dieses Leitfadens erklärt jeden Teil.

Schritt 1: Zuerst nachstellen

Bevor du schreibst, versuche, den Fehler erneut auszulösen. Du erfährst, welche Schritte wichtig sind und ob er jedes Mal auftritt.

• Beginne von einem sauberen Zustand aus: neu laden oder ab- und wieder anmelden.
• Notiere jeden Klick und jede Eingabe.
• Versuche, den kürzesten Weg zu finden, der den Fehler auslöst.
• Probiere einen zweiten Browser oder ein anderes Konto. Wenn es nur bei einem Nutzer auftritt, ist das ein großer Hinweis.

Mehr dazu: wie du eine KI-gebaute App debuggst.

Schritt 2: Einen konkreten Titel schreiben

Der Titel sollte sagen, was falsch ist und wo, damit jemand beim Durchsehen einer Liste erkennt, welcher Fehler gemeint ist.

Schritt 3: Genaue Schritte auflisten

Nummeriere sie. Sei wörtlich: welche Seite, welcher Button, was du eingegeben hast.

1. Als Kunde anmelden (Testkonto: customer@example.com).
2. Das „Starter-Kit“ in den Warenkorb legen.
3. Den Rabattcode WELCOME10 eingeben und auf Anwenden klicken.
4. Auf Zur Kasse klicken.

„Versuch mal mit einem Code zu bezahlen“ lässt die Details weg, auf die es oft ankommt: welcher Nutzer, welches Produkt, welcher Code und ob er vorher angewendet wurde.

Schritt 4: Erwartet vs. tatsächlich

Das ist der Kern des Berichts. Schreibe beides auf, denn der Unterschied ist der Fehler.

• Erwartet: Die Kassenseite öffnet sich, und die Summe zeigt den Rabatt von 10 %.
• Tatsächlich: Der Button zeigt eine Sekunde lang einen Ladekreis, dann passiert nichts. Ohne Rabattcode funktioniert die Kasse.

Ohne „erwartet“ weiß der Leser vielleicht nicht, dass das Verhalten falsch ist. Ohne „tatsächlich“ weiß er nicht, wonach er suchen soll.

Schritt 5: Fehler genau kopieren

Fehlermeldungen sind der schnellste Weg zur Ursache. Kopiere sie als Text, wortwörtlich, nicht umschreiben.

Wo du sie findest:

• Auf dem Bildschirm: jede Meldung, die die App anzeigt.
• Browser-Konsole: Öffne die Entwicklerwerkzeuge (F12 oder Rechtsklick → Untersuchen) und schau im Tab Konsole nach roten Zeilen.
• Netzwerk-Tab: Finde in den Entwicklerwerkzeugen die fehlgeschlagene Anfrage und notiere ihre URL und den Statuscode (zum Beispiel POST /api/checkout → 500).
• Server-Logs, falls du Zugriff hast.

Eine Zeile wie TypeError: Cannot read properties of undefined (reading 'percent') at checkout.ts:48 zeigt oft direkt auf das Problem.

Schritt 6: Kontext ergänzen

• Wo: die Seiten-URL, die Umgebung (Vorschau, Staging oder Live).
• Wer: welcher Nutzer oder welche Rolle: Admin, Mitglied, abgemeldet.
• Gerät und Browser: „Safari auf dem iPhone“ gegenüber „Chrome unter Windows“ kann einen Unterschied machen.
• Daten: alles Ungewöhnliche am Datensatz: sehr langer Text, Sonderzeichen, eine große Anzahl an Einträgen.
• Wann es begann: „nach der gestrigen Änderung an den Rabattcodes“ ist Gold wert.
• Wie oft: jedes Mal oder einmal in zehn Versuchen.

Schritt 7: Es zeigen

Ein Screenshot mit markiertem Problem oder eine kurze Bildschirmaufnahme beseitigt Mehrdeutigkeit, besonders bei Layoutfehlern. Wenn dein KI-Werkzeug Bilder annimmt, hänge eines an. Schneide alles Private heraus, auch Schlüssel und Daten anderer Menschen.

Fehlerberichte für einen KI-Builder schreiben

Derselbe Aufbau funktioniert als Prompt. Zwei Ergänzungen helfen:

• Sag, was sich nicht ändern darf, damit die Korrektur kein neues Problem verursacht.
• Bitte darum, die Korrektur zu überprüfen, nicht nur sie zu schreiben.

Als Kunde angemeldet, mit dem „Starter-Kit“ im Warenkorb und angewendetem Code WELCOME10, passiert beim Klick auf Zur Kasse nichts. Erwartet: Die Kassenseite öffnet sich mit 10 % Rabatt auf die Summe. Tatsächlich: kurzer Ladekreis, dann nichts. Der Netzwerk-Tab zeigt, dass POST /api/checkout mit 500 antwortet. Die Kasse ohne Code funktioniert. Finde die Ursache und behebe sie, ohne die Preisberechnung für Bestellungen ohne Code zu ändern. Prüfe danach die Kasse mit einem Prozent-Code, einem Festbetrags-Code und ohne Code.

Wenn du die Ursache nicht kennst, bitte zuerst um eine Diagnose:

Ändere noch keinen Code. Welche Ursachen sind auf Basis dieses Berichts wahrscheinlich, und was würde jede davon bestätigen?

Häufige Fehler

• „Es ist kaputt.“ Keine Schritte, kein erwartetes Ergebnis, nichts, womit man arbeiten kann.
• Mehrere Fehler in einem Bericht. Manche werden behoben, andere gehen verloren.
• Umschriebene Fehlermeldungen. „Irgendein undefined-Ding“ verbirgt den nützlichen Teil.
• Nutzer oder Rolle fehlen. Viele Fehler betreffen nur Admins oder nur neue Nutzer.
• Nur die gewünschte Korrektur beschreiben („füge eine Null-Prüfung hinzu“) statt des Problems.
• Geheimnisse teilen, in Screenshots oder eingefügten Logs.

Checkliste

• Ich habe den Fehler nachgestellt und den kürzesten Weg gefunden.
• Der Titel sagt, was falsch ist und wo.
• Die Schritte sind nummeriert und wörtlich.
• Erwartet und tatsächlich sind beide angegeben.
• Fehlermeldungen sind genau kopiert, mit fehlgeschlagener Anfrage und Statuscode.
• Seite, Umgebung, Nutzer, Gerät und Browser sind angegeben.
• Ich habe geschrieben, wie oft es passiert und seit wann.
• Ein Screenshot oder eine Aufnahme ist angehängt, private Daten sind entfernt.
• Ein Fehler pro Bericht.

Fehler an den Agenten von Mythex melden

In einem Mythex-Projekt ist der Bericht der Prompt. Einige Funktionen helfen:

• Hänge einen Screenshot der Vorschau oder des Fehlerbildschirms an, bis zu 5 Dateien pro Nachricht.
• /fix richtet den Agenten auf die Behebung eines Fehlers aus; im Modus Plan kann er vor dem Bearbeiten untersuchen.
• /test lässt den Agenten Abläufe direkt in der Vorschau nachstellen und berichten, was er sieht.
• Zu diesem Punkt zurückkehren macht eine Korrektur rückgängig, die alles verschlimmert hat.

Die Seite Debuggen mit Prompts der Dokumentation verwendet denselben Aufbau aus Schritten, Erwartung und Tatsache. Für die Schleife aus Korrektur und Prüfung drumherum siehe wie du eine KI-gebaute App iterierst.

Fragen