auto-pr
Ziel: Auf ein beliebiges GitHub-Repository zeigen und N mergebare PRs eröffnen – nicht N PRs. Jeder PR löst ein echtes Issue (oder eine echte, entdeckte Verbesserung), besteht den eigenen Test-Gate des Repos lokal und wird von einer zweiten Engine abgenommen, bevor er einen Maintainer erreicht.
Dies ist eine dünne Orchestrierungsschicht über dem vouch auto-pr CLI. Es ist ein Geschwisterwerkzeug zur Wissensdatenbank: Es schreibt nie in den Speicher / Proposals / Audit-Log, und das Review-Gate bleibt unberührt.
Aufruf
vouch auto-pr <repo-url> \
--workspace <dir> --count <N> \
--claude-effort <low|medium|high|max> \
--codex-effort <low|medium|high|max> \
[--issue-label good-first-issue] \
[--fork-owner <login>] \
[--max-revise 2] [--autonomy edit|full] \
[--dry-run] [--json]
<repo-url> kann https://github.com/<owner>/<name>,
[email protected]:<owner>/<name>.git oder die Kurzform <owner>/<name> sein.
Ausgabe: Die URLs der tatsächlich eröffneten PRs (eine pro Zeile oder als JSON-Array unter --json). Fehlgeschlagene Versuche werden auf stderr als übersprungen mit einem Grund gemeldet – sie werden niemals eröffnet. Echte PRs sind besser als wackelige N PRs; Teilerfolg ist das beabsichtigte Verhalten, kein Fehler.
Voraussetzungen
ghCLI authentifiziert für das Ziel-Repo (gh auth statusgibt eine Sitzung zurück). Wird für Fork/Clone, Issue-Listing, Dedup-Suche und PR-Erstellung verwendet.claude(Claude Code) undcodeximPATH– beide Engines werden verwendet; eine repariert, während die andere reviewt, abwechselnd pro PR.vouchCLI imPATH(pip install vouch-kb).
Fehlt claude oder codex, stoppen und den Benutzer informieren – Kreuzvalidierung ist der ganze Sinn; nicht stillschweigend auf eine einzelne Engine zurückfallen.
Funktionsweise (die Pipeline)
- Arbeitsbereich auflösen – falls
--workspacebereits ein Klon ist, verwenden; sonstgh repo fork --clone(oder einen einfachen Klon, wenn man Push-Zugriff hat). Den Standard-Branch synchronisieren. - Anleitungen erkennen oder bootstrappen – Das Repo nach
CONTRIBUTING.md,AGENTS.md,CLAUDE.md,.claude/skills/**/SKILL.md,.codex/,.github/PULL_REQUEST_TEMPLATE.mddurchsuchen. Falls vorhanden, werden sie zum Kontext für Fixer/Reviewer. Falls keine vorhanden sind, die gemergten PRs des Repos abrufen und eine Beitrags-SKILL.mdsynthetisieren, die in.claude/skills/(und einem.codex/-Spiegel) des Klons geschrieben wird, damit sie beim nächsten Lauf wiederverwendet wird. - N Arbeitselemente beschaffen – Zuerst offene nicht zugewiesene Issues (filterbar nach
--issue-label); falls nach Dedup weniger als N übrig sind, die Engines echte Fehler/Verbesserungen entdecken lassen, um den Rest zu füllen. Jeder Kandidat wird gegen die bestehenden PRs des Repos auf Duplikate geprüft. - Pro Element (isolierter
auto-pr/<slug>-Branch): Die Fixer-Engine bearbeitet und commitet; der eigene Gate des Repos läuft (make check/pytest/npm test/cargo test/go test); die andere Engine reviewt den Diff. Ein roter Gate oder eine Ablehnung führt zurück zum Fixer für bis zu--max-reviseRunden. Immer noch fehlgeschlagen ⇒ mit Grund überspringen. Bestanden ⇒ zum Fork pushen undgh pr create.
Hausregeln, die es durchsetzt
- Conventional-Commit-Titel; Fließtext-Textkörper in Kleinbuchstaben.
- Kein
Co-Authored-By/ KI-Attributionstrailer in generierten Commits. - Dedup vor dem Öffnen – kein N-tes Duplikat einer versuchten/abgelehnten Korrektur.
- Der CI-äquivalente Gate des Repos muss lokal grün sein, bevor ein PR eröffnet wird.
- Eine logische Änderung pro PR; das Issue, das es adressiert, verlinken/schließen.
Aufwandsstufen
--claude-effort / --codex-effort stimmen jede Engine unabhängig ab:
| Stufe | Claude-Modell | Codex-Reasoning |
|---|---|---|
| low | haiku | low |
| medium | sonnet | medium |
| high | opus | high |
| max | opus | high (Codex-Cap) |
(Claude-Modelle werden als Aliase übergeben – opus/sonnet/haiku – damit das Tool das neueste Modell jeder Stufe verfolgt. high und max wählen beide opus; Codex begrenzt den Reasoning-Aufwand auf high.)
high für echte Beiträge verwenden; nur für günstige explorative Läufe auf low/medium zurückfallen. Mit --dry-run gegen ein neues Repo beginnen, um zu sehen, was es öffnen würde, bevor man eine Engine für das echte Ding einsetzt.
Autonomie und Sicherheit
Der Fixer treibt die Engines kopflos gegen einen Klon eines nicht vertrauenswürdigen Drittanbieter-Repos, daher ist die Voreinstellung eingeschränkt:
--autonomy edit(Standard) – claudeacceptEdits(Dateibearbeitungen automatisch akzeptieren, keine willkürliche Befehlsausführung) und codex--sandbox workspace-write(Schreibzugriff auf den Klon beschränkt, kein Netzwerk). Ausreichend für die meisten Korrekturen, da der Test-Gate über den eigenen Runner von vouch läuft, nicht über die Engine.--autonomy full– claude aufbypassPermissionshochstufen (die Engine kann beliebige Befehle ohne Berechtigungsaufforderung ausführen). Nur für Repos verwenden, deren Korrektur wirklich Befehle ausführen muss, und nur für Repos, denen Sie genug vertrauen, um sie auszuführen. Es ist eine explizite, laufspezifische Operator-Wahl – niemals die Standardeinstellung.
Reviewing ist immer schreibgeschützt (claude plan / codex read-only).
Fehlersemantik
- Arbeitsbereich-Auflösung schlägt fehl ⇒ der gesamte Lauf wird abgebrochen; nichts wurde eröffnet.
- Keine Arbeitselemente ⇒ sauber mit „Nichts zu tun” beenden.
- Ein einzelnes Element schlägt fehl (kein Diff, roter Gate, nach Cap abgelehnt, Push/
gh-Fehler) ⇒ dieses Element wird mit einem Grund übersprungen; der Stapel wird fortgesetzt. - Eine fehlende Engine-Binärdatei ⇒ schnell fehlschlagen und die Binärdatei nennen.