Ein Bug Report, der Stunden Rückfrage-Zeit spart, hat eine feste Form: reproduzierbare Schritte, eine klare Trennung zwischen dem, was passieren sollte, und dem, was tatsächlich passiert, vollständige Umgebungsdaten und eine Einschätzung der Dringlichkeit. Dieses Protokoll nimmt eine unstrukturierte Meldung, gleich ob aus dem Support, von QA oder direkt vom Produktteam, und formt sie in genau dieses Muster.
\nEs eignet sich für alle, die Fehler an ein Entwicklungsteam weitergeben, ohne selbst täglich in einem Ticketing-System zu arbeiten: Kundenmeldungen, interne Beobachtungen, Testprotokolle. Das Ergebnis lässt sich direkt in Jira, Linear oder GitHub Issues übernehmen.
\nDas Protokoll bewertet nicht, ob ein gemeldetes Verhalten tatsächlich ein Fehler ist, und es schätzt Severity nur so gut ein, wie die gelieferten Informationen es zulassen. Fehlen Umgebungsdaten oder Reproduktionsschritte, kennzeichnet der Assistent das als offene Lücke statt sie zu erfinden.
\n" }, { "id": "skill-text", "title": "Skill-Text", "html": "Kopieren Sie den Prompt unten komplett in Ihr KI-Tool. Als Datei: bugreport-protokoll.de.json
\n" } ], "schritte": [ { "nr": 1, "titel": "Fehler beschreiben", "beschreibung": "Die Beschreibung nennt, was passiert und was stattdessen erwartet wurde, ergänzt um die verfügbaren Umgebungsdaten.", "rolle": "mensch" }, { "nr": 2, "titel": "Fehler verstehen", "beschreibung": "Der Kern des Problems wird von den Symptomen getrennt und als Ausgangspunkt für die Strukturierung festgehalten.", "rolle": "automatisch" }, { "nr": 3, "titel": "Report strukturieren", "beschreibung": "Titel, Reproduktionsschritte sowie erwartetes und tatsächliches Verhalten werden in die feste Form gebracht.", "rolle": "automatisch" }, { "nr": 4, "titel": "Severity und Workaround bewerten", "beschreibung": "Die Dringlichkeit wird eingeschätzt und ein bekannter Workaround wird dokumentiert.", "rolle": "automatisch" }, { "nr": 5, "titel": "Bug Report", "beschreibung": "Der fertige, strukturierte Report steht zur direkten Übernahme ins Ticketing-System bereit.", "rolle": "ergebnis" } ], "herausgeber": "Voyage Digital", "version": "2.0", "stand": "2026-07-26", "umsetzung": [ { "titel": "Skill-Text kopieren", "text": "Der Skill-Text wird kopiert und in das gewählte KI-Tool eingefügt, der Fehler wird so beschrieben, wie er aufgefallen ist." }, { "titel": "Umgebungsdaten ergänzen", "text": "Browser, Betriebssystem und Screenshots werden ergänzt, sie steigern den Wert des Bug Reports spürbar." }, { "titel": "Ergebnis prüfen", "text": "Der fertige Report wird geprüft und direkt ins Ticketing-System übernommen, etwa Jira, Linear oder GitHub Issues." } ], "zutaten": [ "Fehlerbeschreibung", "Umgebungsdaten" ], "beispielSzenario": "Ein Kunde meldet, die App stürze ständig ab, sobald er auf den Button klickt. Diese Beschreibung wird an die KI übergeben, ergänzt um Browser und Betriebssystem. Zurück kommt ein strukturierter Bug Report mit suchbarem Titel, fünf exakten Reproduktionsschritten, vollständigen Umgebungsdaten und der Einschätzung Major, funktionale Einschränkung, mit dem Workaround, vorübergehend einen Desktop-Browser zu verwenden.", "eingaben": [ { "feld": "Fehlerbeschreibung: was passiert, was sollte stattdessen passieren", "pflicht": true }, { "feld": "Schritte zur Reproduktion, grob oder detailliert", "pflicht": true }, { "feld": "Umgebung: Browser, Betriebssystem, Version, Gerät", "pflicht": false }, { "feld": "Screenshots, Logs, Häufigkeit, Auswirkung", "pflicht": false } ], "ausgabe": "Ein neunteiliger Bug Report mit Titel, Zusammenfassung, nummerierten Reproduktionsschritten, erwartetem und tatsächlichem Verhalten, Umgebungsdaten, Severity-Einschätzung, Workaround und ergänzenden Informationen.", "prompt": "# BESCHREIBUNG\nSie wandeln Fehlerbeschreibungen in strukturierte, direkt umsetzbare Bug Reports um. Fokus: Reproduzierbarkeit, saubere Trennung von erwartetem und tatsächlichem Verhalten, vollständige Umgebungsinformationen. Fehlen Angaben, kennzeichnen Sie fehlende oder angenommene Informationen ausdrücklich als Annahme, statt sie stillschweigend zu ergänzen.\n\n# EINGABE\n- Fehlerbeschreibung (was passiert, was sollte stattdessen passieren)\n- Schritte zur Reproduktion, grob oder detailliert\n- Optional: Screenshots oder Logs, Umgebung (Browser, Betriebssystem, Version), Häufigkeit, Auswirkung\n\n# AUSGABE\nEin strukturierter Bug Report mit folgenden Abschnitten:\n1. Titel: kurz, beschreibend, gut auffindbar\n2. Zusammenfassung: ein Satz, der das Problem benennt\n3. Schritte zur Reproduktion: nummeriert, exakt\n4. Erwartetes Verhalten\n5. Tatsächliches Verhalten\n6. Umgebung: Browser, Betriebssystem, Version, Gerät\n7. Severity und Priorität: Critical, Major, Minor oder Trivial\n8. Workaround, falls vorhanden\n9. Zusätzliche Informationen: Logs, Screenshots, Kontext\n\n# KONTEXT\n- Reproduzierbarkeit ist das wichtigste Kriterium für einen brauchbaren Bug Report.\n- Severity und Priorität sind zwei unterschiedliche Dimensionen und werden nicht vermischt.\n- Ein Bug Report behandelt genau einen Fehler. Mehrere Symptome nicht in einem Report zusammenfassen.\n- Screenshots und Logs sind wertvoll und werden, wenn vorhanden, immer aufgenommen.\n\n# ARBEITSANWEISUNG\n## Schritt 1: Fehler verstehen\nDen Kern des Problems aus der Nutzerbeschreibung herausarbeiten und von reinen Symptomen trennen.\n\n## Schritt 2: Titel und Zusammenfassung formulieren\nEinen prägnanten, suchbaren Titel und eine Ein-Satz-Zusammenfassung schreiben.\n\n## Schritt 3: Reproduktionsschritte erstellen\nExakte, nummerierte Schritte zur Reproduktion des Fehlers dokumentieren.\n\n## Schritt 4: Erwartetes und tatsächliches Verhalten dokumentieren\nBeide Zustände klar getrennt und ohne Vermischung beschreiben.\n\n## Schritt 5: Severity und Workaround bewerten\nSeverity einschätzen (Critical, Major, Minor, Trivial), Umgebungsinformationen erfassen und einen Workaround dokumentieren, falls einer bekannt ist. Wo Informationen fehlen, dies im Report als offene Annahme kennzeichnen statt zu erfinden.\n\n# DEFINITION OF DONE\n[ ] Titel ist kurz, beschreibend und suchbar\n[ ] Reproduktionsschritte sind exakt und nummeriert\n[ ] Erwartetes und tatsächliches Verhalten sind klar getrennt\n[ ] Umgebungsinformationen sind vollständig oder als fehlend gekennzeichnet\n[ ] Severity ist eingeschätzt\n[ ] Der Report behandelt genau einen Bug\n\n# ANSPRACHE\nSprechen Sie Nutzerinnen und Nutzer durchgehend in der Sie-Form an.\n\n# GESPRÄCHSSTART\nWelchen Bug möchten Sie dokumentieren? Beschreiben Sie den Fehler, was Sie erwartet haben und was stattdessen passiert ist, ich strukturiere daraus einen klaren Bug Report.", "einrichtung": { "intro": "Schritt-für-Schritt-Anleitungen für ChatGPT, Claude, Copilot Studio und Langdock.", "plattformen": [ { "plattform": "ChatGPT", "anbieter": "OpenAI", "schritte": [ "Kopieren Sie den Skill-Text oben über die Kopieren-Schaltfläche.", "Klicken Sie auf Ihr Profilbild und wählen Sie „Skills“.", "Klicken Sie auf „Skill erstellen“ und fügen Sie den kopierten Text als Anweisung ein.", "Passen Sie Eingaben, Ausgaben und Format an, wo es für Ihren Fall nötig ist.", "Speichern Sie den Skill. Er steht ab sofort in allen Chats zur Verfügung." ], "doku": { "label": { "de": "OpenAI Dokumentation: Skills in ChatGPT", "en": "OpenAI documentation: Skills in ChatGPT" }, "url": "https://help.openai.com/de-de/articles/20001066-skills-in-chatgpt" } }, { "plattform": "Claude", "anbieter": "Anthropic", "schritte": [ "Kopieren Sie den Skill-Text oben über die Kopieren-Schaltfläche.", "Öffnen Sie claude.ai und gehen Sie in Ihrem Profil auf „Skills“.", "Legen Sie einen neuen Skill an und fügen Sie den kopierten Text als Anweisung ein.", "Der Skill arbeitet in claude.ai, in Claude Code und über die API.", "Verfügbar in den Tarifen Pro, Max, Team und Enterprise." ], "doku": { "label": { "de": "Anthropic Dokumentation: Benutzerdefinierte Skills erstellen", "en": "Anthropic documentation: Creating custom skills" }, "url": "https://support.claude.com/de/articles/12512198-benutzerdefinierte-skills-erstellen" } }, { "plattform": "Copilot Studio", "anbieter": "Microsoft", "schritte": [ "Kopieren Sie den Skill-Text oben über die Kopieren-Schaltfläche.", "Öffnen Sie Copilot Studio und legen Sie einen neuen Agent an.", "Fügen Sie den kopierten Text als Anweisung ein.", "Verbinden Sie bei Bedarf Wissensquellen und Werkzeuge.", "Veröffentlichen Sie den Agent für sich selbst oder für Ihre Organisation." ], "doku": { "label": { "de": "Microsoft Dokumentation: Einen Agent erstellen und bereitstellen", "en": "Microsoft documentation: Create and deploy an agent" }, "url": "https://learn.microsoft.com/de-de/microsoft-copilot-studio/fundamentals-get-started" } }, { "plattform": "Langdock", "anbieter": null, "schritte": [ "Kopieren Sie den Skill-Text oben über die Kopieren-Schaltfläche.", "Öffnen Sie die Seitenleiste und klicken Sie auf „Skill hinzufügen“.", "Fügen Sie den kopierten Text direkt als Anweisung ein.", "Verbinden Sie den Skill bei Bedarf mit Integrationen, etwa Gmail oder Slack.", "Speichern Sie den Skill und geben Sie ihn für sich oder Ihr Team frei." ], "doku": { "label": { "de": "Langdock Dokumentation: Skills", "en": "Langdock documentation: Skills" }, "url": "https://docs.langdock.com/de/product/chat/skills" } } ] }, "itemIcon": "bug", "recommended": [ { "slug": "api-drehbuch", "category": "skill", "name": "Das API-Drehbuch", "teaser": "Verwandelt eine technische API-Spezifikation in eine vollständige, entwicklerfreundliche Dokumentation, von der ersten Anfrage bis zur Fehlerreferenz.", "domaene": "Softwareentwicklung & technische Infrastruktur", "itemIcon": "webhook" }, { "slug": "anleitungs-dokumentierer", "category": "assistent", "name": "Der Anleitungs-Dokumentierer", "teaser": "Verwandelt Produktinfos und technische Spezifikationen in eine vollständige, verständliche Dokumentation, von der Übersicht bis zum Troubleshooting.", "domaene": "Softwareentwicklung & technische Infrastruktur", "itemIcon": "book-open-check" }, { "slug": "review-protokoll", "category": "skill", "name": "Das Review-Protokoll", "teaser": "Verwandelt grobe Review-Notizen zu einem Code-Diff in ein strukturiertes, konstruktives Feedback mit klarer Kategorisierung und Empfehlung.", "domaene": "Softwareentwicklung & technische Infrastruktur", "itemIcon": "search-check" }, { "slug": "stripe-agent-skills", "category": "tool", "name": "Stripe Agent Skills", "teaser": "Stripes offizielle Sammlung aus Agent-Skills für Best-Practices, Projekt-Setup und API-Versions-Upgrades, damit KI-Coding-Agenten korrekte Stripe-Integrationen schreiben.", "domaene": "Softwareentwicklung & technische Infrastruktur", "logoFile": "stripe-agent-skills.png", "logoEinzug": 0.78 }, { "slug": "mcp-builder", "category": "skill", "name": "Das Schnittstellen-Gerüst", "teaser": "Führt durch Recherche, Implementierung, Test und Evaluation eines MCP-Servers: typisierte Tools, saubere Fehlerbehandlung, Paginierung und zehn verifizierte Evaluationsfragen für zuverlässigen Zugriff eines Sprachmodells auf einen externen Dienst.", "domaene": "Softwareentwicklung & technische Infrastruktur", "itemIcon": "plug" }, { "slug": "vba-uebersetzer", "category": "assistent", "name": "Der VBA-Übersetzer", "teaser": "Übersetzt Automatisierungsaufgaben in Excel in lauffähigen VBA-Code, analysiert dafür die konkrete Dateistruktur und debuggt bestehende Makros.", "domaene": "Softwareentwicklung & technische Infrastruktur", "itemIcon": "code" }, { "slug": "supabase", "category": "tool", "name": "Supabase", "teaser": "Open-Source-Backend-as-a-Service auf Basis von Postgres, mit Authentication, Storage, Edge Functions, Realtime-Diensten und automatisch generierten APIs aus dem Datenbankschema.", "domaene": "Softwareentwicklung & technische Infrastruktur", "logoFile": "supabase.png", "logoEinzug": 0.78 }, { "slug": "vercel", "category": "tool", "name": "Vercel", "teaser": "Git-zentrierte Deployment- und Hosting-Plattform für Web-Anwendungen, mit integriertem AI Model Gateway, isolierten Sandboxes für Agenten-Code und einem Sicherheits- und Observability-Stack in derselben Oberfläche.", "domaene": "Softwareentwicklung & technische Infrastruktur", "logoFile": "vercel.svg", "logoEinzug": 1 }, { "slug": "windsurf", "category": "tool", "name": "Windsurf", "teaser": "KI nativer Code Editor auf Basis von VS Code mit autonomem Cascade Agent für Multi File Änderungen, schneller kontextbewusster Tab Completion und Inline Chat.", "domaene": "Softwareentwicklung & technische Infrastruktur", "logoFile": "windsurf.svg", "logoEinzug": 0.78 }, { "slug": "angebots-schiene", "category": "workflow", "name": "Die Angebots-Schiene", "teaser": "Ein Workflow, der aus einer eingehenden Angebotsanfrage automatisch einen geprüften Angebots-Draft baut, von der Anforderungsanalyse bis zur Freigabe durch den Vertrieb.", "domaene": "Vertrieb & Outreach", "itemIcon": "file-badge" } ] }