Überblick
review-pro ist ein gestaffeltes KI-Codeprüfungssystem: Triage → relevante Spezialisten-Prüfer → Synthese. Es prüft Code, der von KI-Agenten geschrieben wurde, mit KI-Agenten. Es ist gebaut, um die Fehlermuster zu erfassen, die KI-generierter Code tatsächlich ausliefert: Code, der ignoriert, was das Repository bereits weiß, überflüssige Abhängigkeiten, Über-Engineering, halluzinierte APIs.
Diese CLI installiert den review-pro-Kern (13 Prüfer-Skills + Subagenten + den review-pro-Orchestrator) in dein Agenten-Tool und die Stack-Pakete in die .review-pro/ deines Repos. Unterstützte Ziele: opencode · Claude Code · Cursor · Codex.
Installation
Claude Code: als Plugin installieren
Fügt dieses Repository als Plugin-Marketplace hinzu und installiert den Kern von dort. Kein Node.js nötig. Stack-Pakete kommen weiterhin über die CLI.
/plugin marketplace add tufantunc/review-pro
/plugin install review-pro@review-pro
Jede Plattform: Installer-CLI
Einmalig. Interaktiv — sie fragt, welche Plattformen und welche Stack-Pakete installiert werden sollen.
npx review-pro init # interactive: pick platforms + stacks
Nicht-interaktiv (CI)? Verwende --target <platform|all|auto> und --no-stacks.
Hinweise pro Plattform
- opencode — Skills nach
~/.config/opencode/skills/, Agenten nach~/.config/opencode/agents/($OPENCODE_HOMEüberschreibt). - Claude Code — Skills nach
~/.claude/skills/, Agenten nach~/.claude/agents/(das Feldskills:des Agenten lädt seine Rubrik vor). - Cursor — über Cursor
/add-plugininstalliert; führe/add-plugin https://github.com/tufantunc/review-proin Cursor aus (das Repo liefert eine.cursor-plugin/plugin.jsonmit). - Codex — Skills nach
~/.agents/skills/, Agenten automatisch zu~/.codex/agents/*.tomltransformiert. Codex entdeckt Skills automatisch; Agenten erben den Skill-Satz der Session.
Füge dann die Stack-Pakete hinzu, die du nutzt (unten), starte dein Tool neu, damit die neuen Skills/Agenten entdeckt werden, und führe eine Prüfung aus.
Manuelle Installation (ohne Node.js)
review-pro besteht aus reinen Markdown-Skills und -Agenten — keine Laufzeitabhängigkeit. Wenn du kein Node.js hast (oder die CLI nicht nutzen möchtest), kopiere die Dateien von Hand:
- Kern — kopiere
core/skills/<name>/in den Skills-Ordner deines Tools undcore/agents/*.mdin dessen Agenten-Ordner (Pfade wie pro Plattform oben). - Stack-Pakete — kopiere
stacks/<pack>/in die.review-pro/<pack>/des geprüften Repos.
# example: opencode core + python stack, by hand
cp -R core/skills/* ~/.config/opencode/skills/
cp core/agents/*.md ~/.config/opencode/agents/
mkdir -p .review-pro && cp -R stacks/python .review-pro/python
Die CLI automatisiert nur diese Kopien (plus die Codex .md→.toml-Transformation und Versionsverfolgung). Manuelle und CLI-Installationen sind gleichwertig.
Stack-Pakete
Pakete schichten sprach-/frameworkspezifische Signale zur Prüfzeit auf die Prüfer. Installiere die, die ein Repo nutzt, in dessen .review-pro/. Framework-/Domain-Pakete setzen auf einem Sprachpaket auf. Neben den Paketen kann ein Repo eine eigene .review-pro/rules.md führen: Regeln wie „wenn sich X ändert, muss sich auch Y ändern“, die jede Prüfung aus der Merge-Basis liest und Regel für Regel berichtet.
npx review-pro # interactive multi-select
npx review-pro add python # one pack, CI-safe
npx review-pro list # catalog + installed + drift
Katalog (16): python · go · rust · typescript-react · node · php · dotnet · kotlin · swift · flutter · capacitor · nextjs · tanstack-start · react-native · wordpress · ai-ml. Beispiele: ein Next.js-Repo aktiviert typescript-react + nextjs; eine LLM-App aktiviert python + ai-ml.
Befehle
| Befehl | Was er tut |
|---|---|
npx review-pro | Interaktiv — Stacks zur Installation in .review-pro/ auswählen |
init [--target <platform>] | Das Kern-Plugin im Home eines Tools installieren |
uninstall [--target <platform>] | Entfernt das Kern-Plugin aus dem Home eines Tools (Agenten + Skills). Stack-Pakete in .review-pro/ bleiben unangetastet. |
add <stack> | Ein Stack-Paket installieren (nicht-interaktiv) |
remove <stack> | Ein installiertes Paket entfernen |
update [stack] | Installierte Pakete auf die Katalogversion aktualisieren |
list | Katalog-Stacks + installierte Versionen + Drift anzeigen |
doctor | Installierte Pakete validieren (Versionsdrift, Roster-Integrität, Waisen) |
Prüfung ausführen
Nach Installation + Neustart, im Repo, das du prüfen willst (auf einem Feature-Branch):
- bitte die Session, diesen Branch mit review-pro zu prüfen, oder
- rufe den
review-pro-Skill direkt auf.
Der Agent führt die gesamte Pipeline nativ aus — git diff, liest geänderte Dateien, durchsucht .review-pro/ nach aktiven Stacks, leitet die relevanten Prüfer-Subagenten mit ihren Stack-Signalen weiter, lässt einen unabhängigen Verifizierer bis zu 8 Code-Befunde ab Medium zu widerlegen versuchen, berichtet, welche geänderten Dateien die Prüfer nach eigener Angabe untersucht haben, und synthetisiert ein Urteil: BLOCK / REQUEST CHANGES / APPROVE. Keine Env-Vars, keine Skripte zur Prüfzeit.
Die 13 Prüfer
security · correctness · craft · ai-antipatterns · dry · performance · backend · frontend · a11y · db · api-contract · tests · spec. Der ai-antipatterns-Prüfer ist erstklassig: ignorierte bestehende Helfer, überflüssige Abhängigkeiten, erfundene Config-/Env-Keys und halluzinierte APIs/Symbole/Imports. Der spec-Prüfer misst den Diff an dem Issue, aus dem er stammt: fehlende oder halb erledigte Anforderungen, falsch umgesetzte Anforderungen und Arbeit, die niemand verlangt hat. Wird als eigene Achse berichtet und nie mit den Code-Findings zusammengeführt.
FAQ
Braucht es Node.js?
Nur die Installer-CLI (Node ≥ 18). Das Plugin selbst besteht aus reinen Markdown-Skills und -Agenten, daher funktioniert die manuelle Installation ohne Node auf jeder Plattform.
Worin unterscheidet sich das von einem einzelnen „Prüfe das“-Prompt?
Ein einzelner Prompt verlangt von einem Agenten, alle Anliegen auf einmal abzudecken. review-pro gibt jedem Anliegen einen eigenen Prüfer und eine eigene Rubrik, verlangt von jedem Befund die Angabe, wo seine Belege gefunden wurden, und lässt einen separaten Agenten versuchen, die schwerwiegenden Befunde zu widerlegen. Die Synthese kalibriert dann den Schweregrad gegen Übermeldungen.
Woher kommen die Stack-Pakete?
Der Katalog wird innerhalb dieses Pakets mitgeliefert, zum Veröffentlichungszeitpunkt als Schnappschuss. Neue Pakete erscheinen, nachdem eine neue Version veröffentlicht wurde. Siehe stacks/CONTRIBUTING.md im Repo, um eigene hinzuzufügen.
Ist es wirklich plattformübergreifend?
Ja — eine kanonische Quelle installiert sich in opencode, Claude Code, Cursor und Codex. Codex-Agenten werden automatisch zu TOML transformiert; die anderen verwenden dieselben Markdown-Agenten.