Guide · Reviewing agent PRs

Prüfe die Absicht, lass die Maschinen den Rest erledigen

Wenn Agenten mehr Pull Requests öffnen, als du Zeile für Zeile lesen kannst, muss sich das Reviewen ändern. Lass Maschinen alles prüfen, was sie können, bevor ein PR dich erreicht — und prüfe gegen die Story, nicht nur gegen den Diff.

Von Aerunit-Team · Zuletzt aktualisiert

Das Problem

Warum Agent-PRs anders sind

Agent-Pull-Requests kommen in größerer Zahl, wirken selbstbewusst, und du kannst den Autor hinterher nicht fragen "was hast du dir dabei gedacht?". Erste Forschung zeigt allmählich, was das in der Praxis bedeutet.

Eine Studie zu 7.156 Agent-PRs ergab, dass die Art der Aufgabe mehr zählt als der Agent, der sie geschrieben hat: "documentation tasks achieve 82.1% acceptance compared to 66.1% for new features." Kein Agent gewann in jeder Kategorie. [2] Eine zweite Studie untersuchte 654 abgelehnte Agent-PRs und fand sieben Ablehnungsmuster, die nur bei Agent-PRs auftreten — und dass "a large proportion of rejected PRs (67.9%) lack explicit reviewer feedback." [1] Mit anderen Worten: Meistens sagt niemand dem Agenten warum.

Beide Studien nutzen denselben öffentlichen Datensatz von Agent-PRs (AIDev) und wurden beide im Februar 2026 veröffentlicht; Agenten haben sich seitdem weiterentwickelt — lies die Zahlen als Richtung, nicht als Rangliste.

Bevor es dich erreicht

Prüfungen nach links verschieben

Alles, was eine Maschine prüfen kann, sollte nie einen Menschen erreichen: Formatierung, Typen, Lint, Komplexität, Tests. Jedes davon gehört früher in die Kette — beim Edit des Agenten, beim Commit, in der CI. Wie du das aufsetzt, zeigen wir in unserem Guide zu sofortigem Feedback für Coding-Agenten.

Googles Guide zu Code-Reviews gilt weiterhin für Agenten: Der Reviewer schaut auf Design, Funktionalität, Komplexität, Tests, Namensgebung und Kommentare — die Dinge, die eine Codebasis über die Zeit gesünder machen. [3] Der Unterschied bei Agenten ist, dass der mechanische Teil dieser Liste fast vollständig automatisiert werden kann.

Die Übergabe

Verlange Beweise vom Agenten, keine Behauptungen

"Fertig, alle Tests bestehen" ist eine Behauptung. Verlange stattdessen Beweise. Füge jeder Story eine Übergabezeile hinzu, die den Agenten bittet, "summarize changed files, checks run, failures encountered, and any remaining risk." [8] Cursors Cloud Agents können dem Pull Request außerdem Screenshots, Videos und Log-Referenzen anhängen, sodass du sehen kannst, dass die Änderung funktioniert, ohne den Branch auszuchecken. [7]

Beispiel einer PR-Übergabe
## What changed
- auth/login-form.tsx — locked-account message + reset link
- auth/login-form.test.tsx — new test for the locked case

## Checks run
- npm run typecheck ✔
- npm test -- auth ✔ (14 passed)

## Failures hit
- First run broke the signup error style; fixed by reusing ErrorBanner.

## Remaining risk
- Copy not reviewed by product. Lockout threshold unchanged (non-goal).
Frischer Blick

Ein zweiter, unabhängiger Reviewer

Lass den Agenten nicht seine eigene Arbeit bewerten. Ein automatischer Reviewer in einem frischen Kontext erkennt Dinge, für die der Autor blind ist. Die Claude-Code-Doku beschreibt ein Schreiber/Reviewer-Muster: "A fresh context improves code review since Claude won't be biased toward code it just wrote." [4] Cursor Bugbot "analyzes PR diffs and leaves comments with explanations and fix suggestions" [5], und GitHub Copilot code review macht dasselbe auf GitHub. [6] Claude Code im Web kann noch einen Schritt weiter gehen und Pull Requests automatisch reparieren: Es beobachtet einen PR und reagiert auf CI-Fehler und Review-Kommentare — ein gutes Beispiel dafür, Befunde an den Agenten zurückzuschicken. [9]

Es gibt eine Kehrseite, und dieselbe Doku spricht sie offen an:

"A reviewer prompted to find gaps will usually report some, even when the work is sound, because that is what it was asked to do. Chasing every finding leads to over-engineering." [4]

Handle also nur bei Befunden, die Korrektheit oder die genannten Anforderungen betreffen. Alles andere ist optional.

Der menschliche Teil

Was nur du prüfen kannst

Absicht

Ist das Verhalten, das die Story verlangt hat — nicht nur Verhalten, das die Tests besteht?

Produktgefühl

Fühlt sich die Nutzung richtig an? Screenshots und Videos helfen hier.

Namensgebung

Versteht die nächste Person (oder der nächste Agent) diese Namen ohne die PR-Beschreibung?

Architekturrichtung

Bewegt das die Codebasis dorthin, wo du hinwillst, oder nur irgendwohin, wo es funktioniert?

Alles außerhalb der Story

Änderungen, die die Story nicht verlangt hat, sind eine Frage, kein Bonus.

Den Kreis schließen

Feedback hinterlassen, das der Agent nutzen kann

Erinnere dich an die 67,9 %: Die meisten abgelehnten Agent-PRs tragen keinen expliziten Grund. [1] Wenn du einen PR ablehnst oder Änderungen verlangst, sag warum — im PR oder in der Story. "Falsch" lehrt nichts. "Das sollte das bestehende ErrorBanner wiederverwenden, siehe signup-form.tsx" behebt diesen Durchlauf und den nächsten. Wenn dasselbe Feedback immer wieder auftaucht, gehört es in eure gemeinsamen Konventionen, nicht in einen weiteren Kommentar.

Wo wir ansetzen

Wo Aerunit ansetzt

Das Argument dieses Guides ist, dass Review in Schichten ablaufen sollte: zuerst Maschinen, dann ein unabhängiger Reviewer, zuletzt du — gemessen an der Story. Aerunit deckt die mittlere Schicht und den Maßstab ab. Wenn ein Agent einen Pull Request öffnet, prüft Aerunit ihn automatisch und kann die Befunde an dieselbe Agenten-Session zurückschicken, damit der PR, den du öffnest, bereits eine Runde durchlaufen hat.

Der Maßstab ist die Story selbst: Aerunits Story-Writer schlägt Linear-Issues mit Umfang, Akzeptanzkriterien und Non-Goals vor, sodass du gegen ein benanntes Ziel prüfst. Und Team-Konventionen, die du sonst in Review-Kommentaren wiederholen würdest, leben einmal in geteiltem Kontext und Skills und fließen in jede Story und jeden Lauf ein.

Automatisches Review

Jeder Agent-PR wird geprüft, Befunde gehen zurück an die Session des Agenten.

Ein klarer Maßstab

Akzeptanzkriterien und Non-Goals in der Story, gegen die du prüfst.

In derselben Session behoben

Befunde gehen zurück an den Agenten, der den PR geschrieben hat — du prüfst einen zweiten Durchgang, keinen ersten Entwurf.

Schnelle Antworten

Häufige Fragen

Muss ich jede Zeile prüfen, die ein Agent schreibt?

Nicht Zeile für Zeile, nicht sobald die maschinellen Prüfungen stehen. Lass Formatierung, Typen, Lint, Tests und einen automatischen Reviewer das abdecken, was sie können. Dein Review sollte das abdecken, was sie nicht können: Ist das Verhalten, das die Story verlangt hat, die richtige Form, die richtigen Namen, die richtige Richtung für die Codebasis.

Kann eine KI KI-Code überprüfen?

Ja, und es hilft — solange es ein unabhängiger Reviewer in einem frischen Kontext ist, nicht derselbe Agent, der seine eigene Arbeit bewertet. Die Claude-Code-Dokumentation merkt an, dass ein frischer Kontext das Review verbessert, weil der Reviewer nicht voreingenommen gegenüber Code ist, den er gerade geschrieben hat. Produkte wie Cursor Bugbot und GitHub Copilot code review machen genau das bei Pull Requests. [4] [5] [6]

Wie groß sollte ein Agent-PR sein?

Klein genug, dass du die Absicht in einer Sitzung beurteilen kannst — eine Story, ein Slice. Wenn ein PR Bereiche berührt, die die Story nicht erwähnt hat, ist das ein Signal, die Story aufzuteilen, nicht härter zu lesen.

Was mache ich mit einem PR, der zu 90 % richtig ist?

Behebe die letzten 10 % nicht still von Hand. Hinterlasse den Grund als Review-Kommentar oder aktualisiere die Story und schicke den PR dann an den Agenten zurück. So wird der Fix dokumentiert, und der nächste Durchlauf startet vom korrigierten Auftrag.

Aerunit

Halte die Agenten beschäftigt. Du übernimmst das Denken.

Aerunit ist im Early Access, nur auf Einladung. Bezahle nur, was du nutzt — keine Abos, die man vergisst, und Teams teilen sich ohne Aufpreis einen Credit-Pool.

Frühen Zugang anfragen