Ein brauchbares Code-Review ist zweierlei zugleich: Qualitätssicherung und Lerninstrument. Das Review-Protokoll nimmt einen Code-Diff und grobe Notizen entgegen und formuliert daraus einen strukturierten Kommentar, den man direkt in einen Pull Request übernehmen kann. Jede Anmerkung wird nach Schwere sortiert (Must-fix, Should-fix, Nice-to-have), mit einer Begründung versehen und, wo sinnvoll, mit einem konkreten Verbesserungsvorschlag ergänzt.
\nGedacht ist der Skill für Entwicklerinnen und Entwickler, die Reviews schreiben und dabei zwei Dinge gleichzeitig wollen: Klarheit in der Priorisierung und einen Ton, der nicht wie Gatekeeping wirkt. Positives Feedback ist deshalb ein eigener, fester Abschnitt, kein Nachgedanke.
\nWas der Skill bewusst nicht kann: Er ersetzt kein tiefes Verständnis der Codebasis. Er arbeitet mit dem, was im Diff und in den Notizen steht, und kennzeichnet fehlenden Kontext als Annahme statt ihn zu erfinden. Die fachliche Richtigkeit einer Sicherheits- oder Performance-Einschätzung bleibt bei der reviewenden Person.
\n" }, { "id": "skill-text", "title": "Skill-Text", "html": "Kopieren Sie den Prompt unten komplett in Ihr KI-Tool. Als Datei: review-protokoll.de.json
\n" } ], "schritte": [ { "nr": 1, "titel": "PR bereitstellen", "beschreibung": "Der Code-Diff, die Review-Notizen und, sofern vorhanden, die Team-Standards werden bereitgestellt.", "rolle": "mensch" }, { "nr": 2, "titel": "Diff analysieren", "beschreibung": "Der Code-Diff wird gelesen, der Feature-Kontext erfasst und positive Aspekte werden identifiziert.", "rolle": "automatisch" }, { "nr": 3, "titel": "Anmerkungen kategorisieren", "beschreibung": "Jede Anmerkung wird als Must-fix, Should-fix oder Nice-to-have eingeordnet und begründet.", "rolle": "automatisch" }, { "nr": 4, "titel": "Feedback entwerfen", "beschreibung": "Ein strukturiertes Review-Feedback mit Empfehlung wird formuliert.", "rolle": "automatisch" }, { "nr": 5, "titel": "Feedback prüfen", "beschreibung": "Der Entwurf wird geprüft und an die eigene Team-Kultur angepasst, bevor er in den Pull Request übernommen wird.", "rolle": "freigabe" }, { "nr": 6, "titel": "Fertiges Feedback", "beschreibung": "Ein konstruktives, kategorisiertes Code-Review mit Begründungen und einer klaren Empfehlung liegt vor.", "rolle": "ergebnis" } ], "herausgeber": "Voyage Digital", "version": "2.0", "stand": "2026-07-26", "umsetzung": [ { "titel": "Skill einrichten", "text": "Der Skill-Text wird kopiert und in das eigene KI-Tool eingefügt. Code-Diff und Review-Notizen werden als Eingabe bereitgestellt." }, { "titel": "Team-Standards ergänzen", "text": "Code-Conventions und der Kontext zum Feature werden ergänzt, das macht das Feedback treffsicherer." }, { "titel": "Feedback prüfen", "text": "Das Ergebnis wird geprüft, an die eigene Team-Kultur angepasst und erst danach in den Pull Request übernommen." }, { "titel": "Als festen Ablauf etablieren", "text": "Der Skill wird Teil des eigenen Review-Prozesses, damit jedes Feedback dieselbe Struktur und denselben Ton erhält." } ], "zutaten": [ "Code-Diff", "Review-Notizen", "Team-Standards", "Team-Kultur" ], "beispielSzenario": "Ein Junior-Entwickler hat einen Pull Request eingereicht. Im Diff finden sich eine potenzielle SQL-Injection, fehlendes Error-Handling und einige Style-Inkonsistenzen. Aus diesen Notizen entsteht ein strukturiertes Review: ein Must-fix mit Code-Beispiel zur SQL-Injection, zwei Should-fix-Punkte zum Error-Handling, drei Nice-to-have-Hinweise zum Stil und ausdrückliches Lob für die saubere Testabdeckung.", "eingaben": [ { "feld": "Code-Diff oder PR-Beschreibung", "pflicht": true }, { "feld": "Review-Notizen", "pflicht": true }, { "feld": "Code-Standards oder Konventionen des Teams", "pflicht": false }, { "feld": "Kontext zum Feature oder zur Aufgabenstellung", "pflicht": false } ], "ausgabe": "Ein siebenteiliges Review-Feedback: Zusammenfassung, positives Feedback, Must-fix, Should-fix, Nice-to-have, Verständnisfragen und eine Empfehlung (Approve, Request Changes oder Comment).", "prompt": "# BESCHREIBUNG\nSie formulieren aus einem Code-Diff und groben Review-Notizen ein strukturiertes, konstruktives Code-Review-Feedback. Jede Anmerkung wird nach Schwere kategorisiert, begründet und, wo möglich, mit einem konkreten Verbesserungsvorschlag versehen. Fehlen Informationen zu Team-Standards oder Kontext, kennzeichnen Sie das als Annahme, statt sie stillschweigend zu ergänzen.\n\n# EINGABE\n- Code-Diff / PR-Beschreibung\n- Review-Notizen (grobe Anmerkungen, Bedenken)\n- Optional: Code-Standards des Teams, Kontext des Features\n\n# AUSGABE\nEin strukturiertes Code-Review-Feedback mit folgenden Abschnitten:\n1. Zusammenfassung: Gesamteindruck des PRs in wenigen Sätzen\n2. Positives Feedback: was gut gelöst ist\n3. Must-fix: Bugs, Sicherheitslücken, Breaking Changes\n4. Should-fix: Performance, Wartbarkeit, Best Practices\n5. Nice-to-have: stilistische Verbesserungen\n6. Fragen: Verständnisfragen an die Autorin oder den Autor\n7. Empfehlung: Approve, Request Changes oder Comment, mit kurzer Begründung\n\n# KONTEXT\n- Ein Code Review ist Qualitätssicherung und Lerninstrument zugleich.\n- Das Warum ist wichtiger als das Was: jede Anmerkung wird begründet.\n- Positives Feedback wird nicht vergessen, es verstärkt gute Practices.\n- Must-fix und Nice-to-have werden klar getrennt, damit Prioritäten sofort erkennbar sind.\n\n# ARBEITSANWEISUNG\n## Schritt 1: Diff und Kontext verstehen\nPR-Beschreibung lesen, Feature-Kontext erfassen und den Code-Diff analysieren.\n\n## Schritt 2: Positive Aspekte identifizieren\nSaubere Lösungen, gute Patterns und Testabdeckung benennen.\n\n## Schritt 3: Anmerkungen kategorisieren und begründen\nJede Anmerkung als Must-fix, Should-fix oder Nice-to-have einordnen, das Warum erklären und wo möglich eine konkrete Alternative vorschlagen.\n\n## Schritt 4: Verständnisfragen formulieren\nBei Unklarheiten Fragen stellen statt Annahmen stillschweigend zu treffen.\n\n## Schritt 5: Empfehlung geben\nApprove, Request Changes oder Comment wählen und kurz begründen.\n\n# DEFINITION OF DONE\n[ ] Positives Feedback ist enthalten\n[ ] Anmerkungen sind nach Schwere kategorisiert\n[ ] Jede Anmerkung hat eine Begründung\n[ ] Ton ist konstruktiv und respektvoll\n[ ] Eine klare Empfehlung ist gegeben\n\n# ANSPRACHE\nSprechen Sie Nutzerinnen und Nutzer durchgehend in der Sie-Form an.\n\n# GESPRÄCHSSTART\nFür welchen Pull Request brauchen Sie Feedback? Teilen Sie mir den Code-Diff und Ihre Anmerkungen mit, ich formuliere daraus ein konstruktives, klar kategorisiertes Review-Feedback.", "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": "search-check", "recommended": [ { "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": "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": "bugreport-protokoll", "category": "skill", "name": "Das Bugreport-Protokoll", "teaser": "Bringt eine formlose Fehlerbeschreibung in eine Struktur, die ein Entwicklungsteam ohne Rückfrage bearbeiten kann.", "domaene": "Softwareentwicklung & technische Infrastruktur", "itemIcon": "bug" }, { "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": "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": "codex-cli", "category": "tool", "name": "OpenAI Codex CLI", "teaser": "Lokal laufender Terminal-Coding-Agent von OpenAI, nutzbar als eigenständige Coding-Umgebung oder als unabhängiger adversarieller Gegenprüfer neben einem anderen Coding-Agenten.", "domaene": "Softwareentwicklung & technische Infrastruktur", "logoFile": "codex-cli.png", "logoEinzug": 0.78 }, { "slug": "playwright", "category": "tool", "name": "Playwright", "teaser": "Quelloffenes Framework für Browser-Automatisierung und End-to-End-Tests über Chromium, Firefox und WebKit, mit paralleler Testausführung, Trace Viewer, Codegen-Recorder und Ad-hoc-Inspektion.", "domaene": "Softwareentwicklung & technische Infrastruktur", "logoFile": "playwright.svg", "logoEinzug": 1 }, { "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": "appwrite", "category": "tool", "name": "Appwrite", "teaser": "Quelloffene Backend-Plattform mit Authentifizierung, Datenbank, Speicher und Functions, wahlweise selbst gehostet oder als Cloud-Dienst.", "domaene": "Softwareentwicklung & technische Infrastruktur", "logoFile": "appwrite.svg", "logoEinzug": 1 }, { "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 } ] }