CommunitySchreiben & Editierengithub.com

vouchdev/vouch

Eine git-native, review-gesteuerte Wissensdatenbank für KI-Agenten: Sie schlagen Änderungen vor, Sie genehmigen sie. Jede Behauptung zitiert eine Quelle, jede Änderung ist ein Diff in Ihrem Repository. MCP + CLI.

Was ist vouch?

Das Skill `vouchdev/vouch` dient als zentrale Wissensdatenbank und Orchestrierungsschicht für KI-Entwicklungsagenten. Es ermöglicht Agenten, Vorschläge (Proposals) zu erstellen, die von einem Menschen freigegeben werden müssen, und protokolliert alle Aktionen in einem Prüfpfad (Audit Log). Das Besondere: Jede Behauptung in einem Proposal muss mit einem Quellverweis belegt sein, und jede Änderung wird als nachvollziehbarer Diff im Git-Repository gespeichert. Das System unterstützt sowohl das MCP-Protokoll (Model Context Protocol) als auch eine direkte CLI. Es ist als 'Sibling Tool' zum auto-pr-Skill konzipiert, das nie in den Proposal-Speicher, das Audit Log oder die Review-Gate-Komponente schreibt. Für Entwickler bedeutet dies: Sie behalten die volle Kontrolle über Code-Änderungen, während KI-Agenten effizient arbeiten können, indem sie Änderungen vorschlagen und automatisch auf Qualität und Konsistenz prüfen lassen. Die Integration in bestehende Git-Workflows minimiert Reibungsverluste und sorgt für Transparenz.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor
npx skills add vouchdev/vouch

Installed? Explore more Schreiben & Editieren skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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

  • gh CLI authentifiziert für das Ziel-Repo (gh auth status gibt eine Sitzung zurück). Wird für Fork/Clone, Issue-Listing, Dedup-Suche und PR-Erstellung verwendet.
  • claude (Claude Code) und codex im PATH – beide Engines werden verwendet; eine repariert, während die andere reviewt, abwechselnd pro PR.
  • vouch CLI im PATH (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)

  1. Arbeitsbereich auflösen – falls --workspace bereits ein Klon ist, verwenden; sonst gh repo fork --clone (oder einen einfachen Klon, wenn man Push-Zugriff hat). Den Standard-Branch synchronisieren.
  2. Anleitungen erkennen oder bootstrappen – Das Repo nach CONTRIBUTING.md, AGENTS.md, CLAUDE.md, .claude/skills/**/SKILL.md, .codex/, .github/PULL_REQUEST_TEMPLATE.md durchsuchen. Falls vorhanden, werden sie zum Kontext für Fixer/Reviewer. Falls keine vorhanden sind, die gemergten PRs des Repos abrufen und eine Beitrags-SKILL.md synthetisieren, die in .claude/skills/ (und einem .codex/-Spiegel) des Klons geschrieben wird, damit sie beim nächsten Lauf wiederverwendet wird.
  3. 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.
  4. 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-revise Runden. Immer noch fehlgeschlagen ⇒ mit Grund überspringen. Bestanden ⇒ zum Fork pushen und gh 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:

StufeClaude-ModellCodex-Reasoning
lowhaikulow
mediumsonnetmedium
highopushigh
maxopushigh (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) – claude acceptEdits (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 auf bypassPermissions hochstufen (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.

Verwandte Skills