Zum Inhalt springen

Bug Report Vorlage: kostenlos für Jira, GitHub und Linear

Kostenlose Bug Report Vorlage zum Kopieren, fertige Versionen für GitHub, Linear und Jira, ein GitHub Issue-Formular und ein ausgefülltes Beispiel.

Eine Bug Report Vorlage ist ein fester Satz an Feldern, der dafür sorgt, dass jeder Report dieselben Fragen beantwortet: Was ist schiefgelaufen, wo, wie lässt es sich nachstellen, was hätte passieren sollen, und welche Belege zeigen es? Die Vorlage unten umfasst Titel, Zusammenfassung, Umgebung, Schritte zum Reproduzieren, erwartetes und tatsächliches Ergebnis, Häufigkeit, Schweregrad, Anhänge und Logs. Kopier sie in deinen Issue Tracker, ein Support-Formular oder eine Chatnachricht und füll die Lücken aus. Weiter unten findest du fertige Versionen für GitHub, Linear und Jira, einschließlich eines GitHub Issue-Formulars.

Vorlagen gibt es, weil Entwickler die meiste Zeit mit fehlenden Details verlieren, nicht mit dem Fix. Ein Report mit genauen Schritten, der Browserversion und dem Konsolenfehler lässt sich oft noch am selben Tag beheben. Ein Report, in dem nur „Checkout ist kaputt“ steht, wird zu einem langen Thread voller Rückfragen.

Die Vorlage

Titel: [Was kaputt ist], wenn [Aktion] auf [Seite oder Funktion]

Zusammenfassung
Ein oder zwei Sätze in einfacher Sprache. Was ist passiert, und wer ist betroffen?

Umgebung
- URL:
- Browser und Version:
- Betriebssystem:
- Gerät / Bildschirmgröße:
- App-Version oder Build (falls bekannt):
- Account / Rolle / Testnutzer:
- Datum und Uhrzeit des Fehlers (mit Zeitzone):

Schritte zum Reproduzieren
1.
2.
3.

Erwartetes Ergebnis
Was hätte passieren sollen.

Tatsächliches Ergebnis
Was stattdessen passiert ist. Mit der genauen Fehlermeldung, als Text kopiert.

Häufigkeit
Immer / Manchmal (etwa X von Y Versuchen) / Einmal aufgetreten

Schweregrad
Blocker / Schwer / Leicht / Kosmetisch

Workaround
Ein Weg, das Problem zu umgehen, oder „Keiner gefunden“.

Anhänge
- Screenshot oder Bildschirmaufnahme:
- Konsolenfehler:
- Fehlgeschlagener Netzwerk-Request (URL, Status, Response):
- HAR-Datei (bereinigt), falls angefragt:

Notizen
Alles Weitere: seit wann es auftritt, was sich zuletzt geändert hat, verwandte Tickets.

So füllst du die einzelnen Felder aus

Titel

Den Titel überfliegen die Leute in einer Liste mit fünfzig Tickets, also mach ihn konkret. Ein nützliches Muster ist „was kaputt ist“ plus „wann“ plus „wo“. „Bezahlen-Button bleibt nach Eingabe einer gültigen Karte im Checkout deaktiviert“ schlägt „Checkout-Bug“. Vermeide Wörter wie „dringend“ oder „kaputt“ für sich allein; das transportiert das Feld für den Schweregrad.

Zusammenfassung

Ein oder zwei Sätze, die auch ein nicht technischer Kollege versteht. Sag, wer betroffen ist, wenn du es weißt: alle Nutzer, nur Admins, nur Safari-Nutzer, nur ein bestimmter Kunde.

Umgebung

Viele Bugs hängen vom Browser, vom Gerät, vom Account oder von den Daten ab. Notier die genaue URL, Name und Version des Browsers, das Betriebssystem und den Account oder die Rolle, mit der du unterwegs warst. Zeigt die App eine Version oder Build-Nummer an, gib sie mit an. Der Zeitpunkt des Fehlers samt Zeitzone hilft dem Entwickler, die passenden Einträge in den Server-Logs zu finden.

Schritte zum Reproduzieren

Das ist das wichtigste Feld. Nummeriere die Schritte, starte bei einem bekannten Zustand („angemeldet als Nutzer mit leerem Warenkorb“) und gib die genauen Daten an, die du verwendet hast. Schreib eine Aktion pro Schritt. Konntest du den Fehler kein zweites Mal auslösen, sag das und beschreib so genau wie möglich, was du beim ersten Mal getan hast.

Erwartetes und tatsächliches Ergebnis

Stell beide nebeneinander, damit die Abweichung sofort ins Auge fällt. Kopier Fehlermeldungen als Text, statt sie sinngemäß wiederzugeben; der Entwickler sucht genau nach diesem String im Code. „Nichts passiert“ ist ein gültiges tatsächliches Ergebnis, aber ergänze, was du geprüft hast, etwa „keine Fehlermeldung, der Button bleibt aktiv“.

Häufigkeit

Bugs, die „immer“ auftreten, sind am leichtesten zu beheben. Bugs, die nur „manchmal“ auftreten, brauchen mehr Daten. Schätz also die Quote („3 von 10 Versuchen“) und notier alles, was eine Rolle zu spielen scheint, etwa eine langsame Verbindung oder eine große Datei.

Schweregrad

Beim Schweregrad geht es um die Auswirkung, nicht darum, wie sehr dich der Bug nervt. Eine gängige Skala:

SchweregradBedeutungBeispiel
BlockerKern-Flow unmöglich, kein WorkaroundNiemand kann sich anmelden
SchwerWichtige Funktion kaputt oder Daten falsch, Workaround ist mühsamRechnungen zeigen die falsche Summe
LeichtFunktion geht, aber mit kleinem Problem oder einfachem WorkaroundSortierung wird nach Neuladen der Seite zurückgesetzt
KosmetischOptisches Problem ohne funktionale AuswirkungButton-Text überlappt auf kleinen Bildschirmen

Die Priorität, also wann der Bug behoben wird, legt meist das Team fest, dem das Backlog gehört, nicht die Person, die ihn meldet.

Workaround

Ein Workaround zeigt dem Team, wie dringend der Fix ist, und hilft dem Support, Kunden in der Zwischenzeit zu antworten.

Anhänge und Logs

Belege sparen am meisten Zeit. Häng einen Screenshot an, auf dem die Problemstelle markiert ist, oder eine kurze Bildschirmaufnahme, die die Schritte zeigt. Bei Web-Apps gehören die Konsolenfehler und der fehlgeschlagene Netzwerk-Request dazu. Unsere Anleitungen zum Exportieren von Konsolen-Logs in Chrome und zum Aufzeichnen von Netzwerkverkehr in Chrome zeigen, wie das geht. Fragt jemand nach einer HAR-Datei, folge der Anleitung So bekommst du eine HAR-Datei und bereinige sie vorher mit dem HAR Sanitizer, denn HAR-Dateien enthalten Cookies und Tokens.

Ein ausgefülltes Beispiel

Titel: Bezahlen-Button bleibt nach Eingabe einer gültigen Karte im Checkout deaktiviert

Zusammenfassung
Auf der Checkout-Seite wird der Bezahlen-Button nach Eingabe einer gültigen
Testkarte nie klickbar, die Bestellung lässt sich also nicht abschließen.
Beobachtet in Chrome und Edge.

Umgebung
- URL: https://staging.example.com/checkout
- Browser und Version: Chrome 154 unter Windows 11; ebenso Edge 154
- Gerät / Bildschirmgröße: Laptop, 1920x1080
- App-Version oder Build: web 4.18.0 (Footer)
- Account / Rolle / Testnutzer: [email protected], Standardkunde
- Datum und Uhrzeit: 2026-11-10 14:32 MEZ

Schritte zum Reproduzieren
1. Als [email protected] anmelden.
2. „Starter-Tarif, jährlich“ in den Warenkorb legen.
3. /checkout aufrufen.
4. Testkarte 4242 4242 4242 4242 eingeben, Ablauf 12/30, CVC 123.
5. Außerhalb des Kartenfelds klicken.

Erwartetes Ergebnis
Der Bezahlen-Button wird aktiv und zeigt „120,00 $ bezahlen“.

Tatsächliches Ergebnis
Der Bezahlen-Button bleibt grau und deaktiviert. Es erscheint keine Fehlermeldung.
Die Konsole zeigt: Uncaught TypeError: Cannot read properties of
undefined (reading 'postalCode') at validateCard (checkout.js:214)

Häufigkeit
Immer (5 von 5 Versuchen)

Schweregrad
Blocker: Kunden können nicht bezahlen

Workaround
Keiner gefunden. Funktioniert im Produktions-Build 4.17.2.

Anhänge
- Bildschirmaufnahme: Link in den Kommentaren
- Konsolenfehler: checkout-console.log
- Netzwerk: POST /api/cart/validate lieferte 200; keine weiteren Fehler

Notizen
Tritt seit dem Staging-Deploy heute Morgen auf.

Achte darauf, warum dieses Beispiel funktioniert. Die Schritte beginnen mit einem bekannten Account. Die Testkarte ist genannt. Der Konsolenfehler ist wörtlich zitiert. Die meldende Person hat einen anderen Browser und den vorherigen Build geprüft, was die Ursache schon auf die letzte Änderung eingrenzt.

Kürzere Varianten

Nicht jeder Bug braucht jedes Feld. Für eine schnelle Nachricht im Team-Chat reicht eine kompakte Version:

Bug: [Titel]
Wo: [URL], [Browser/Betriebssystem]
Schritte: 1) ... 2) ... 3) ...
Erwartet: ...
Tatsächlich: ...
Beleg: [Screenshot / Aufnahme / Konsolenfehler]

Support-Teams, die den Report eines Nutzers weiterleiten, ergänzen die Account-ID des Kunden, den Link zum Ticket und die Worte des Kunden selbst und markieren, welche Teile sie selbst nachgestellt haben.

Bei QA-Testläufen kommen die ID des Testfalls und der getestete Build dazu, damit der Bug auf den Test zurückverweist, der ihn gefunden hat.

Vorlagen für GitHub, Linear und Jira

Die reine Textvorlage funktioniert überall. Stellt dein Tracker Markdown dar, bleiben Überschriften und Checklisten mit dieser Version gut lesbar:

## Zusammenfassung
<!-- Ein oder zwei Sätze: Was ist passiert, und wer ist betroffen? -->

## Umgebung
- URL:
- Browser und Version:
- Betriebssystem:
- App-Version oder Build:
- Account / Rolle:

## Schritte zum Reproduzieren
1.
2.
3.

## Erwartetes Ergebnis

## Tatsächliches Ergebnis
<!-- Füge die genaue Fehlermeldung als Text ein. -->

## Häufigkeit
<!-- Immer / Manchmal (X von Y) / Einmal -->

## Schweregrad
<!-- Blocker / Schwer / Leicht / Kosmetisch -->

## Belege
- [ ] Screenshot oder Bildschirmaufnahme
- [ ] Konsolenfehler
- [ ] Fehlgeschlagener Netzwerk-Request

GitHub Issues

Speichere die Markdown-Version als .github/ISSUE_TEMPLATE/bug_report.md in deinem Repository, mit einem kurzen Header, damit GitHub sie in der Auswahl unter „New issue“ anbietet:

---
name: Bug Report
about: Etwas ist kaputt
labels: bug
---

GitHub unterstützt außerdem Issue-Formulare, die aus der Vorlage beschriftete Felder machen, die niemand überspringen kann. Speichere das hier als .github/ISSUE_TEMPLATE/bug_report.yml:

name: Bug Report
description: Etwas ist kaputt
labels: ["bug"]
body:
  - type: textarea
    id: summary
    attributes:
      label: Zusammenfassung
      description: Was ist passiert, und wer ist betroffen?
    validations:
      required: true
  - type: input
    id: url
    attributes:
      label: URL
  - type: input
    id: environment
    attributes:
      label: Browser, Betriebssystem und App-Version
      placeholder: Chrome 154 unter macOS 26, web 4.18.0
  - type: textarea
    id: steps
    attributes:
      label: Schritte zum Reproduzieren
      value: |
        1.
        2.
        3.
    validations:
      required: true
  - type: textarea
    id: expected
    attributes:
      label: Erwartetes Ergebnis
    validations:
      required: true
  - type: textarea
    id: actual
    attributes:
      label: Tatsächliches Ergebnis
      description: Füge die genaue Fehlermeldung als Text ein.
    validations:
      required: true
  - type: dropdown
    id: severity
    attributes:
      label: Schweregrad
      options:
        - Blocker
        - Schwer
        - Leicht
        - Kosmetisch
  - type: textarea
    id: evidence
    attributes:
      label: Screenshots, Aufnahme und Logs
      description: Zieh Dateien hierher oder füge einen Link zu einer Aufnahme ein.

Linear

Linear hat Issue-Vorlagen in den Einstellungen eines Teams. Leg eine Vorlage namens „Bug“ an, füge die Markdown-Version in ihre Beschreibung ein und setz das Label „Bug“ und den Triage-Status des Teams, damit jeder Report mit denselben Feldern startet.

Jira

In Jira fügst du die Text- oder Markdown-Version in die Beschreibung eines neuen Bugs ein. Jira Cloud hat keine eingebaute Standardbeschreibung pro Vorgangstyp, deshalb nutzen Teams, die die Vorlage vorausgefüllt haben wollen, eine App für Issue-Vorlagen aus dem Atlassian Marketplace. Ein Link zu einer Bildschirmaufnahme mit Konsolen- und Netzwerk-Logs gehört in die Beschreibung oder in einen Kommentar.

Fehler, die die Vorlage verhindert

Eine Vorlage ist vor allem eine Checkliste gegen immer dieselben paar Fehler:

  • Mehrere Bugs in einem Report. Ein Ticket pro Problem, damit jedes für sich behoben, getestet und geschlossen werden kann.
  • Umschriebene Fehlermeldungen. Nach „Da stand irgendwas mit Berechtigungen“ kann niemand suchen. Nach der genauen Meldung schon.
  • Fehlender Ausgangspunkt. Schritte, die mitten in einem Flow beginnen, funktionieren nur für die Person, die sie geschrieben hat.
  • Meinungen statt Beobachtungen. „Die API ist kaputt“ ist eine Vermutung. „POST /api/orders hat 500 zurückgegeben“ ist eine Tatsache, die der Entwickler prüfen kann.
  • Geheimnisse in Anhängen. Screenshots von Admin-Panels, HAR-Dateien und Konsolen-Logs können Tokens und Kundendaten enthalten. Zuschneiden, verpixeln oder bereinigen, bevor du sie anhängst.

Mach sie zum Standard in deinem Team

In den meisten Issue Trackern kannst du eine Standardbeschreibung oder eine Issue-Vorlage hinterlegen, sodass jeder neue Bug mit diesen Überschriften startet. Halte die Vorlage so kurz, dass die Leute sie auch wirklich ausfüllen. Ist ein Feld in den meisten Reports leer, streich es. Stellen Entwickler immer wieder dieselbe Rückfrage, ergänze ein Feld dafür.

Lass das Tool die technischen Felder ausfüllen

Am häufigsten übersprungen werden die technischen Felder: Browserversion, Konsolenfehler, der fehlgeschlagene Request. Midge, eine kostenlose Chrome-Erweiterung, hängt sie automatisch an eine Bildschirmaufnahme oder einen Screenshot, sodass die meldende Person nur Titel, Schritte und erwartetes Ergebnis schreibt. Jede Aufnahme enthält Konsolen-Logs, Netzwerk-Requests, Nutzeraktionen und Geräteinfos. Passwörter, Kartennummern, Tokens und Cookies werden in deinem Browser geschwärzt, bevor irgendetwas dein Gerät verlässt. Ein Report geht direkt an Jira, Linear, GitHub Issues oder Slack oder wird als Link geteilt, den du überall einfügen kannst.

Verwandte Anleitungen

Häufige Fragen

Was gehört in eine Bug Report Vorlage?

Ein klarer Titel, die Umgebung (URL, Browser, Betriebssystem, App-Version, Account), nummerierte Schritte zum Reproduzieren, erwartetes Ergebnis, tatsächliches Ergebnis, wie oft der Fehler auftritt, Schweregrad und Belege wie Screenshots, ein Video, Konsolen-Logs und Netzwerk-Requests.

Kann ich die Vorlage in Jira, Linear oder GitHub Issues verwenden?

Ja. Sie ist reiner Text mit Markdown-freundlichen Überschriften, du kannst sie also in jeden Tracker einfügen. GitHub und Linear können sie außerdem als Issue-Vorlage speichern, Jira mit einer App aus dem Marketplace.

Wo liegen GitHub Issue-Vorlagen?

Im Ordner .github/ISSUE_TEMPLATE des Repositorys. Eine .md-Datei fügt eine Markdown-Vorlage hinzu, eine .yml-Datei ein Issue-Formular mit Pflichtfeldern. GitHub listet sie auf, wenn jemand ein neues Issue anlegt.

Was ist der Unterschied zwischen Schweregrad und Priorität?

Der Schweregrad beschreibt, wie stark der Bug das Produkt oder die Nutzer beeinträchtigt. Die Priorität beschreibt, wie bald das Team ihn behebt. Ein schwerer Bug in einem selten genutzten Admin-Bildschirm kann eine niedrigere Priorität haben als ein kosmetischer Bug auf der Preisseite.

Muss ich jedes Feld ausfüllen?

Nein. Titel, Schritte, erwartetes und tatsächliches Ergebnis sind unverzichtbar. Den Rest füllst du aus, wenn du ihn kennst, und schreibst „unbekannt“, statt zu raten.