Grundlagen der Code-Review
Überprüfen Sie die Änderungen, auf die der Benutzer zeigt. Wenn keine Angabe erfolgt, überprüfen Sie den aktuellen Branch gegen seinen Basis-Branch:
- Finden Sie die Basis: versuchen Sie
git merge-base HEAD origin/main, dannorigin/master, dannorigin/develop. Wenn keine existiert, überprüfen Sie unbestätigte Änderungen (git diff HEAD). - Lesen Sie den vollständigen Diff, öffnen Sie dann den umgebenden Code für jede Änderung, die Sie allein aus dem Diff nicht beurteilen können.
Checkliste
Arbeiten Sie jeden Punkt durch. Melden Sie nur Punkte mit einem echten Befund.
Korrektheit
- Tut der Code das, was die Änderung beabsichtigt? Achten Sie auf Off-by-one-Fehler, falsche Bedingungen, unbehandelte
None/null und geschluckte Ausnahmen. - Sind Grenzfälle behandelt: leere Eingabe, sehr große Eingabe, gleichzeitige Aufrufe, Wiederholungen?
Tests
- Ist jedes Verhaltensänderung durch einen Test abgedeckt, der ohne sie fehlschlagen würde?
- Überprüfen die Tests das Verhalten, nicht die Implementierungsdetails?
Lesbarkeit
- Sind die Namen zutreffend? Würde ein neues Teammitglied dies beim ersten Lesen verstehen?
- Ist toter Code, Debug-Ausgabe oder auskommentierter Code zurückgelassen worden?
Sicherheit (Grundlagen)
- Keine Geheimnisse, Token oder Anmeldedaten in Code, Konfiguration oder Logs.
- Benutzereingaben werden validiert und Abfragen sind parametrisiert, niemals durch Zeichenkettenverkettung erstellt.
Konsistenz
- Folgt es den Konventionen in CLAUDE.md und dem umgebenden Code?
Ausgabe
Gruppieren Sie Befunde nach Schweregrad:
- Muss behoben: Fehler, Sicherheitsprobleme, fehlende Tests für riskante Logik.
- Sollte behoben: Wartbarkeitsprobleme, die später Zeit kosten werden.
- Kosmetik: optionale Verbesserungen. Halten Sie diese wenige.
Geben Sie für jeden Befund datei:zeile, das Problem und einen konkreten Verbesserungsvorschlag an. Beenden Sie mit einem einzeiligen Urteil: bereit zum Mergen, bereit nach Muss-Fixes oder benötigt weitere Überarbeitung. Wenn Sie in einer Kategorie nichts finden, lassen Sie die Kategorie weg. Erfinden Sie keine Probleme, um Platz zu füllen.
Die Pro-Edition fügt vollständige Checklisten für Sicherheit, Leistung, Barrierefreiheit und API-Design sowie einen
/review-Befehl hinzu, der die passenden für den Diff auswählt.