team-mirai-volunteer/Parallel PR

Parallel PR

複数の独立したPRを、git worktree + エージェントチームで並列に作成するスキル。

前提条件

• ユーザーからPR一覧（ブランチ名、対象ファイル、作業内容）が提供されていること
• 提供されていなければ、まずプランモードで一覧を設計し承認を得る

ワークフロー

Phase 1: タスク整理

ユーザーの指示からPR一覧を整理する:

| # | ブランチ名 | 作業内容 | 対象ファイル |
|---|-----------|---------|-------------|
| 1 | feat/xxx  | ...     | src/...     |

PRの数に応じてエージェント数を決める（目安: 4-5が上限）。 1エージェントに1-2 PRを割り当てる。

Phase 2: worktree準備

エージェントごとにworktreeを作成する:

# {team} はチーム名の略称（例: test4, refactor2）
# {x} はエージェント識別子（a, b, c, d...）
git worktree add ../action-board-{team}-{x} -b {team}-{x}-base
mkdir -p ../action-board-{team}-{x}/.claude
cp .claude/settings.local.json ../action-board-{team}-{x}/.claude/

依存パッケージのインストール（全worktreeをバックグラウンドで並列実行）:

cd ../action-board-{team}-{x} && pnpm install --frozen-lockfile

Phase 3: チーム組成＆エージェント起動

1. TeamCreate でチームを作成
2. TaskCreate で各エージェントのタスクを作成（owner設定、in_progress）
3. Task で各エージェントをバックグラウンドで起動:

Task(
  subagent_type: "general-purpose",
  team_name: "{チーム名}",
  name: "agent-{x}",
  mode: "bypassPermissions",
  run_in_background: true,
  prompt: 下記テンプレート参照
)

エージェントプロンプトテンプレート

あなはworktree-workerです。以下の手順で作業してください。

## 作業環境
- worktreeパス: {絶対パス}
- 全コマンドはこのworktreeディレクトリ内で実行すること

## 担当PR一覧
### PR 1
- ブランチ名: {branch}
- 作業内容: {description}
- 対象ファイル: {files}

### PR 2 (あれば)
- ...

## 作業手順
1. `git checkout -b {branch} develop` でブランチ作成
2. 対象ファイルを読んで理解
3. 実装・修正
4. 検証（テスト実行 or typecheck）
5. `pnpm run biome:check:write` でフォーマット
6. コミット（Co-Authored-By: Claude Opus 4.6 <[email protected]>）
7. `git push -u origin {branch}`
8. `gh pr create --base develop --title "{title}" --body "..."`
9. 次のPRがあれば `git checkout -b {next-branch} develop` で次へ
10. 全完了後、リーダーにメッセージで報告（PR番号・URL）

Phase 4: 完了待ち＆CI確認

エージェントからの完了メッセージを待つ。全エージェント完了後:

# 全PRのCI状態を一括確認
for pr in {PR番号リスト}; do
  echo "=== PR #$pr ==="
  gh pr checks $pr
done

# 全PRのコメントを確認（CodeRabbitやレビューアからのフィードバック）
for pr in {PR番号リスト}; do
  echo "=== PR #$pr comments ==="
  gh pr view $pr --comments
done

CI失敗時の対応:

• flaky RLSテスト: gh run rerun <run-id> --failed で再実行
• TypeScript型エラー: worktreeで直接修正してpush
• Biomeエラー: worktreeで pnpm run biome:check:write して再push

PRコメント対応:

• CodeRabbitの指摘: 重要な指摘はworktreeで修正してpush
• 軽微な指摘（nitpick等）: マージ後に対応するか、必要に応じて対応

Phase 5: クリーンアップ

# 全エージェントにシャットダウン要求
SendMessage(type: "shutdown_request", recipient: "agent-{x}")

# worktree削除
git worktree remove ../action-board-{team}-{x}
git branch -D {team}-{x}-base

# チーム削除
TeamDelete

Phase 6: ユーザーに結果報告

作成したPR一覧をまとめて報告:

| # | PR | タイトル | CI |
|---|-----|---------|-----|
| 1 | #XX | feat: ... | Passed |

注意事項

• エージェント数は4-5が実用的上限（APIレート制限、CI負荷）
• CodeRabbitもレート制限にかかりやすい（9PR同時は避ける）
• CIのBuild & Testsはflaky（特にRLSテスト）→失敗時はログ確認してから再実行
• worktreeパスは ../action-board-{name} 形式（CLAUDE.mdのルール）
• settings.local.json のコピーは必須（権限設定のため）