PR Reviewer Skill für OpenClaw

OpenClaw PR Reviewer Skill — Überblick

Der PR Reviewer Skill verwandelt OpenClaw in einen automatisierten Code-Review-Assistenten für Ihre Pull Requests. Anstatt stundenlang auf das Review eines Teammitglieds zu warten, erhalten Sie sofort KI-gestütztes Feedback zu Code-Qualität, potenziellen Bugs, Sicherheitsproblemen und Style-Konsistenz.

Dieser Skill liest Pull-Request-Diffs und liefert strukturiertes, umsetzbares Feedback — ähnlich dem, was ein Senior-Entwickler bei einer Code-Review anmerken würde. Er arbeitet standardmäßig im Nur-Lese-Modus, das heißt er kommentiert und schlägt vor, führt aber ohne Ihre explizite Anweisung niemals Merges, Genehmigungen oder Code-Änderungen durch.

Der OpenClaw PR Reviewer Skill wurde entwickelt, um menschliche Reviewer zu ergänzen, nicht zu ersetzen. Er fängt mechanische Probleme ab (Tippfehler, ungenutzte Imports, fehlendes Error-Handling), damit sich Ihr Team auf Architektur, Logik und Design-Entscheidungen konzentrieren kann.

Typischer Workflow:

1. Öffnen Sie einen Pull Request auf GitHub.
2. Bitten Sie OpenClaw, den PR zu reviewen.
3. Der Agent holt den Diff, analysiert jede geänderte Datei und liefert ein strukturiertes Review mit Inline-Vorschlägen zurück.

Voraussetzungen für den PR Reviewer Skill

Bevor Sie den PR Reviewer Skill installieren, stellen Sie sicher, dass Sie haben:

• OpenClaw installiert und laufend (v1.0+)
• GitHub CLI (gh) installiert und authentifiziert — Installationsanleitung
• Zugang zum Repository mit dem Pull Request
• clawhub CLI installiert für Skill-Management

Überprüfen Sie Ihre Einrichtung:

# OpenClaw-Version prüfen
openclaw --version

# GitHub CLI Version prüfen
gh --version

# GitHub-Authentifizierung überprüfen
gh auth status

Der PR Reviewer Skill funktioniert am besten in Kombination mit dem GitHub Skill, der den zugrunde liegenden GitHub-API-Zugang bereitstellt.

PR Reviewer Skill installieren

Installieren Sie den PR Reviewer Skill mit einem einzigen Befehl:

npx clawhub@latest install pr-reviewer

Installation überprüfen:

clawhub list

Sie sollten pr-reviewer in der Liste der installierten Skills sehen. Der Skill ist sofort nach der Installation einsatzbereit.

PR Reviewer Skill Konfiguration

Der PR Reviewer Skill funktioniert sofort mit sinnvollen Standardeinstellungen. Er verwendet Ihre bestehende GitHub-Authentifizierung (über gh auth), um auf Pull-Request-Daten zuzugreifen.

Review-Umfang

Standardmäßig überprüft der Skill:

| Aspekt | Was geprüft wird | |--------|-----------------| | Code-Qualität | Ungenutzte Variablen, toter Code, unnötige Komplexität | | Bug-Erkennung | Null-Pointer-Risiken, Off-by-one-Fehler, Race Conditions | | Sicherheit | Hartcodierte Geheimnisse, SQL-Injection, XSS-Schwachstellen | | Style | Namenskonventionen, Formatierungsinkonsistenzen | | Testing | Fehlende Testabdeckung für neue Logik | | Dokumentation | Veraltete Kommentare, fehlende JSDoc/Docstrings |

Umgebungseinrichtung

# Sicherstellen, dass GitHub CLI authentifiziert ist
gh auth login

# Oder ein Personal Access Token mit repo-Scope setzen
export GITHUB_TOKEN=ghp_your_token_here

Wichtig: Der PR Reviewer Skill benötigt nur Lesezugriff auf Repository-Inhalte und Pull Requests. Gewähren Sie keine Schreib- oder Admin-Scopes, es sei denn, Sie möchten explizit, dass der Agent Kommentare in Ihrem Namen postet.

PR Reviewer Skill Verwendungsbeispiele

1. Einen bestimmten Pull Request reviewen

Sie: „Reviewe PR #42 in unserem Hauptrepo."

Der Agent holt den Diff von PR #42 mit gh pr diff 42, analysiert jede geänderte Datei und liefert ein strukturiertes Review:

• Zusammenfassung: 3 Dateien geändert, 127 Zeilen hinzugefügt, 45 entfernt. Fügt ein neues Zahlungsverarbeitungsmodul hinzu.
• Gefundene Probleme: 2 Bugs, 1 Sicherheitsbedenken, 3 Style-Vorschläge.
• Jedes Problem enthält Dateiname, Zeilennummer, Schweregrad und eine empfohlene Korrektur.

2. Nur auf Sicherheitsprobleme fokussieren

Sie: „Prüfe PR #128 auf Sicherheitslücken."

Der Agent führt ein sicherheitsfokussiertes Review durch und scannt nach:

• Hartcodierten API-Schlüsseln oder Geheimnissen
• SQL-Injection- oder NoSQL-Injection-Mustern
• Cross-Site-Scripting (XSS)-Vektoren
• Unsicherer Deserialisierung
• Fehlender Eingabevalidierung

Es werden nur sicherheitsrelevante Befunde zurückgegeben, mit OWASP-Referenzen wo zutreffend.

3. Änderungen eines großen PRs zusammenfassen

Sie: „Gib mir eine Zusammenfassung der Änderungen in PR #256. Das ist ein großer."

Der Agent liest den gesamten Diff durch und erstellt eine prägnante Zusammenfassung:

• Überblick darüber, was der PR erreicht
• Liste geänderter Dateien, gruppiert nach Modul oder Feature
• Wichtige architektonische Entscheidungen oder Trade-offs
• Potenzielle Risiken oder Bereiche, die bei der menschlichen Review besondere Aufmerksamkeit erfordern

4. Mit Coding-Standards vergleichen

Sie: „Reviewe PR #99 nach den TypeScript-Coding-Standards unseres Teams."

Der Agent wendet die Konventionen Ihres Teams auf das Review an und prüft:

• Konsistente Verwendung von interface vs type
• Korrekte Error-Handling-Muster
• Import-Reihenfolge und Barrel-Exports
• Komponenten-Namenskonventionen (PascalCase für React-Komponenten)

Sicherheit und Best Practices

Der PR Reviewer Skill ist standardmäßig nur lesend — er holt Diffs und generiert Feedback, postet aber keine Kommentare, genehmigt keine PRs und merged keinen Code, es sei denn, dies wird explizit angewiesen.

Befolgen Sie diese Richtlinien für sicheres Arbeiten:

• Nur-Lese-Modus beibehalten. Die Standardkonfiguration liest nur PR-Daten. Wenn Sie das Posten von Kommentaren aktivieren, überprüfen Sie jeden Kommentar, bevor er veröffentlicht wird.
• Minimale Berechtigungen verwenden. Gewähren Sie nur den repo:read-Scope, wenn Sie ein PAT verwenden. Der Skill benötigt keinen Schreibzugriff für seine Kern-Review-Funktionalität.
• Das Review überprüfen. KI-generiertes Feedback ist nicht unfehlbar. Wenden Sie immer Ihr eigenes Urteil an, bevor Sie Vorschläge umsetzen, insbesondere bei sicherheitssensitivem Code.
• Menschliches Review nicht überspringen. Dieser Skill beschleunigt den Review-Prozess, sollte aber nicht der einzige Reviewer sein. Nutzen Sie ihn als ersten Durchlauf, um mechanische Probleme zu finden.
• Sensible Repos schützen. Stellen Sie bei Repositories mit proprietären Algorithmen oder Geschäftsgeheimnissen sicher, dass die Richtlinien Ihrer Organisation KI-gestützte Code-Reviews erlauben.

Häufige Fehler beheben

"Could not fetch PR diff"

Die GitHub CLI kann nicht auf den Pull Request zugreifen. Häufige Ursachen:

# Bei GitHub neu authentifizieren
gh auth login

# Repository-Zugang prüfen
gh repo view owner/repo

# PR-Nummer überprüfen
gh pr view 42

"PR diff is too large to analyze"

Sehr große PRs (1000+ geänderte Zeilen) können Kontextgrenzen erreichen. Versuchen Sie:

Sie: „Reviewe nur die Änderungen in src/api/ in PR #200."

Die Einschränkung auf bestimmte Verzeichnisse oder Dateien hilft dem Agenten, fokussierteres Feedback höherer Qualität zu liefern.

"No issues found"

Dies kann bedeuten, dass der Code sauber ist oder der Diff zu klein für aussagekräftiges Feedback ist. Der Agent liefert dennoch eine Zusammenfassung der Änderungen, auch wenn keine Probleme erkannt werden.