Communityライティング&編集github.com

vouchdev/vouch

AIエージェント向けのgitネイティブなレビューゲート付きナレッジベース:エージェントが書き込みを提案し、あなたが承認します。すべての主張はソースを引用し、すべての変更はリポジトリ内の差分として記録されます。MCP + CLI対応。

vouch とは?

これは`vouch auto-pr` CLIの薄いオーケストレーション層であり、GitHub上の任意のリポジトリを対象に、マージ可能なプルリクエスト(PR)を自動で生成するスキルです。通常のPR作成ツールと異なり、検出された課題や改善案ごとに、Claude Code(修正役)とCodex(レビュー役)の2つのAIエンジンを交互に使い、リポジトリ自身のテストゲート(例:`make check`)をローカルで通過し、かつレビューエンジンが承認した場合のみPRを実際にオープンします。これにより、メンテナーの手を煩わせることなく、高品質でマージ可能なPRのみを届けることができます。主にClaude CodeとCodexの両方が利用可能な環境で動作し、`gh` CLIによるGitHub認証が必要です。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add vouchdev/vouch

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

auto-pr

目標: 任意のGitHubリポジトリを対象に、N個の「マージ可能なPR」をオープンすること。単にN個のPRを出すのではありません。 各PRは実際の課題(または発見された正当な改善)を解決し、リポジトリ自身のテストゲートをローカルで通過し、メンテナーに届く前に別のエンジンによって承認されます。

これは vouch auto-pr CLI の薄いオーケストレーション層です。ナレッジベースの兄弟ツールであり、ストレージやプロポーザル、監査ログへの書き込みは一切行わず、レビューゲートにも影響を与えません。

呼び出し方

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> は https://github.com/<owner>/<name>、[email protected]:<owner>/<name>.git、または <owner>/<name> の短縮形のいずれかを受け付けます。

出力:実際にオープンされたPRのURL(1行に1つ、--json の場合はJSON配列)。検証に失敗した試行はstderrに理由付きで skipped として報告され、決してオープンされません。N個の不安定なPRよりもM個の確実なPRの方が優れています。部分的な成功は意図された動作であり、エラーではありません。

前提条件

  • gh CLI がターゲットリポジトリに対して認証済みであること(gh auth status がセッションを返す)。フォーク/クローン、課題一覧、重複検索、PR作成に使用されます。
  • claude(Claude Code)と codex が PATH 上にあること。両方のエンジンが使用され、一方が修正し、もう一方がレビューします(PRごとに交代)。
  • vouch CLI が PATH 上にあること(pip install vouch-kb)。

もし claude または codex が欠けている場合は、処理を停止してユーザーに伝えてください — 相互検証が肝心です。単一エンジンに静かにフォールバックしてはいけません。

動作の仕組み(パイプライン)

  1. ワークスペースを解決 — --workspace が既にクローンであればそのまま使用。そうでなければ gh repo fork --clone(またはプッシュアクセスがある場合は単純なクローン)。デフォルトブランチを同期します。
  2. ガイダンスを検出またはブートストラップ — リポジトリ内で CONTRIBUTING.md、AGENTS.md、CLAUDE.md、.claude/skills/**/SKILL.md、.codex/、.github/PULL_REQUEST_TEMPLATE.md をスキャン。存在すればそれらが修正役/レビュー役のコンテキストになります。存在しない場合は、リポジトリのマージ済みPRを取得し、コントリビューション用の SKILL.md を合成して、クローンの .claude/skills/(および .codex/ ミラー)に書き込みます。これにより次回実行時に再利用されます。
  3. N個の作業項目を調達 — まずはオープンで アサインされていない 課題を取得(--issue-label でフィルタ可能)。重複除外後もN個に満たない場合、エンジンに本当のバグや改善を発見させて残りを埋めます。すべての候補はリポジトリの既存PRと重複チェックされます。
  4. 項目ごとに(独立した auto-pr/<slug> ブランチで):修正役エンジンが編集+コミット。リポジトリ自身のゲートが実行されます(make check / pytest / npm test / cargo test / go test)。もう一方の エンジンが差分をレビュー。ゲートが赤またはレビュー拒否の場合、最大 --max-revise ラウンドまで修正役にフィードバックされます。それでも失敗すれば理由付きでスキップ。成功すればフォークにプッシュし、gh pr create を実行します。

適用されるハウスルール

  • conventional-commit 形式のタイトル。説明文は小文字で記述。
  • 生成されたコミットには Co-Authored-By / AI帰属のトレーラーは含めない。
  • オープン前に重複チェック — 試行済み/拒否された修正のN番目の重複は作成しない。
  • リポジトリ自身のCI相当のゲートがローカルでグリーンになってからPRをオープンする。
  • 1PRにつき1つの論理的な変更。対応する課題にリンクし、クローズする。

努力レベル

--claude-effort / --codex-effort で各エンジンの努力レベルを独立して設定します:

レベルclaude モデルcodex reasoning
lowhaikulow
mediumsonnetmedium
highopushigh
maxopushigh(codex の上限)

(claudeモデルはエイリアスで指定 — opus/sonnet/haiku — ツールは各層の最新モデルを追跡します。high と max はどちらも opus を選択。codex の reasoning effort は high が上限です。)

実際のコントリビューションには high を使用。試運転的に安価に試す場合のみ low/medium に下げてください。新しいリポジトリでは実際のエンジンを使う前に --dry-run で何がオープンされるか確認することをお勧めします。

自律性と安全性

修正役は、信頼できないサードパーティリポジトリのクローンに対してヘッドレスでエンジンを駆動するため、デフォルトは制約付きです:

  • --autonomy edit(デフォルト) — claude は acceptEdits(ファイル編集は自動承認、任意のコマンド実行は不可)、codex は --sandbox workspace-write(クローン内への書き込みに制限、ネットワーク不可)。ほとんどの修正に十分です。テストゲートはvouch自身のランナーで実行され、エンジン経由ではないためです。
  • --autonomy full — claude を bypassPermissions にエスカレーション(エンジンは許可プロンプトなしで任意のコマンドを実行可能)。修正にコマンド実行が本当に必要なリポジトリでのみ、かつ十分に信頼できるリポジトリでのみ使用してください。これは明示的な、実行ごとのオペレーターの選択であり、決してデフォルトではありません。

レビューは常に読み取り専用です(claude plan / codex read-only)。

失敗のセマンティクス

  • ワークスペース解決に失敗 ⇒ 実行全体が中断。何もオープンされません。
  • 作業項目なし ⇒ 「やることはありません」とクリーンに終了。
  • 単一項目の失敗(差分なし、赤ゲート、上限を超えた拒否、プッシュ/gh エラー) ⇒ その項目は理由付きでスキップされ、バッチは継続。
  • エンジンのバイナリが見つからない ⇒ バイナリ名を明示して即座に失敗。

関連スキル