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の方が優れています。部分的な成功は意図された動作であり、エラーではありません。
前提条件
ghCLI がターゲットリポジトリに対して認証済みであること(gh auth statusがセッションを返す)。フォーク/クローン、課題一覧、重複検索、PR作成に使用されます。claude(Claude Code)とcodexがPATH上にあること。両方のエンジンが使用され、一方が修正し、もう一方がレビューします(PRごとに交代)。vouchCLI がPATH上にあること(pip install vouch-kb)。
もし claude または codex が欠けている場合は、処理を停止してユーザーに伝えてください — 相互検証が肝心です。単一エンジンに静かにフォールバックしてはいけません。
動作の仕組み(パイプライン)
- ワークスペースを解決 —
--workspaceが既にクローンであればそのまま使用。そうでなければgh repo fork --clone(またはプッシュアクセスがある場合は単純なクローン)。デフォルトブランチを同期します。 - ガイダンスを検出またはブートストラップ — リポジトリ内で
CONTRIBUTING.md、AGENTS.md、CLAUDE.md、.claude/skills/**/SKILL.md、.codex/、.github/PULL_REQUEST_TEMPLATE.mdをスキャン。存在すればそれらが修正役/レビュー役のコンテキストになります。存在しない場合は、リポジトリのマージ済みPRを取得し、コントリビューション用のSKILL.mdを合成して、クローンの.claude/skills/(および.codex/ミラー)に書き込みます。これにより次回実行時に再利用されます。 - N個の作業項目を調達 — まずはオープンで アサインされていない 課題を取得(
--issue-labelでフィルタ可能)。重複除外後もN個に満たない場合、エンジンに本当のバグや改善を発見させて残りを埋めます。すべての候補はリポジトリの既存PRと重複チェックされます。 - 項目ごとに(独立した
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 |
|---|---|---|
| low | haiku | low |
| medium | sonnet | medium |
| high | opus | high |
| max | opus | high(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エラー) ⇒ その項目は理由付きでスキップされ、バッチは継続。 - エンジンのバイナリが見つからない ⇒ バイナリ名を明示して即座に失敗。