jpskill.com
🛠️ 開発・MCP コミュニティ

orchestrating-parallel-agents

複数のAIコーディングエージェントを立ち上げ、Gitのワークツリーを使ってGitHubの関連課題を同時並行で進めることで、大規模な機能開発を効率化したり、タスクを段階的に実行したりするSkill。

📜 元の英語説明(参考)

Spawns multiple AI coding agents to work on related GitHub issues concurrently using git worktrees. Use when breaking down a large feature into multiple issues, running parallel agents with --print flag, or managing wave-based execution of related tasks.

🇯🇵 日本人クリエイター向け解説

一言でいうと

複数のAIコーディングエージェントを立ち上げ、Gitのワークツリーを使ってGitHubの関連課題を同時並行で進めることで、大規模な機能開発を効率化したり、タスクを段階的に実行したりするSkill。

※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux 
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o orchestrating-parallel-agents.zip https://jpskill.com/download/16747.zip && unzip -o orchestrating-parallel-agents.zip && rm orchestrating-parallel-agents.zip
🪟 Windows (PowerShell) 
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/16747.zip -OutFile "$d\orchestrating-parallel-agents.zip"; Expand-Archive "$d\orchestrating-parallel-agents.zip" -DestinationPath $d -Force; ri "$d\orchestrating-parallel-agents.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)
  1. 1. 下の青いボタンを押して orchestrating-parallel-agents.zip をダウンロード
  2. 2. ZIPファイルをダブルクリックで解凍 → orchestrating-parallel-agents フォルダができる
  3. 3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
  4. 4. Claude Code を再起動
⬇ .zip でダウンロード(推奨) ⬇ .skill 形式(上級者用) 元のソース ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

  1. 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
  2. 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
  3. 3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
    • · macOS / Linux: ~/.claude/skills/
    • · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →
最終更新
2026-05-18
取得日時
2026-05-18
同梱ファイル
1

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

並列エージェントのオーケストレーション

git worktree を使用して、関連する問題を並行して処理するために複数の Claude エージェントを生成します。

哲学

  • Issue はプロンプトである - 自律的な作業に十分なコンテキストを含む Issue を記述します
  • 並列処理を最大化する - 独立した作業を波にグループ化します
  • 素早く失敗する - エージェントができない場合は、git/PR を手動で完了します
  • 信頼するが検証する - 差分を確認し、手動で競合を解決します

ワークフローチェックリスト

コピーして進捗状況を追跡します。

並列エージェントのオーケストレーション:
- [ ] 1. 機能を Issue に分割する (それぞれ 1〜3 個のファイル)
- [ ] 2. 波に編成する (独立 → 依存)
- [ ] 3. settings.local.json で git の権限を事前承認する
- [ ] 4. --print フラグを使用して波を生成する
- [ ] 5. 進捗状況を監視する
- [ ] 6. 遅れているものを手動で完了する
- [ ] 7. PR をマージする (同じファイルの競合の間でリベースする)
- [ ] 8. ワークツリーをクリーンアップする

Issue テンプレート

各 Issue は単独で完了できる必要があります。

## 問題
何が壊れているか、または欠落しているか。

## 解決策
大まかなアプローチ。

## 変更するファイル
- `path/to/file` - どのような変更か

## 実装
コードスニペットまたは疑似コード。

## 受け入れ基準
- [ ] テスト可能な結果

重要: ファイルパスとコード例を含めます。エージェントは具体的な開始点があると最も効果的に機能します。

波の編成

Wave 1: 独立した変更 (共有ファイルなし)
Wave 2: 同じファイルに触れる可能性のある変更 (競合が予想される)
Wave 3: 統合/テスト (上記すべてに依存)

ルール: 同じファイルの Issue は、異なる波または同じエージェントに配置します。

権限の事前承認

非対話型の --print モードのために、.claude/settings.local.json に追加します。

"Bash(git -C /absolute/path/to/worktree add:*)",
"Bash(git -C /absolute/path/to/worktree commit:*)",
"Bash(git -C /absolute/path/to/worktree push:*)"

エージェントの生成

for issue in 101 102 103; do
  (claude --print "/worktree-issue $issue" > "issue-${issue}.log" 2>&1) &
done

監視

ps aux | grep "claude.*worktree" | wc -l  # 実行中のエージェント
git worktree list                          # 作成されたワークツリー
tail -f issue-*.log                        # ライブログ

遅れているものを完了する

エージェントがコードを完了したが、git で失敗した場合:

git -C <worktree> add -A
git -C <worktree> commit -m "feat: description"
git -C <worktree> push -u origin <branch>
gh pr create --head <branch> --title "..." --body "Closes #N"

競合を伴うマージ

gh pr merge N --squash --delete-branch

以前のマージ後に競合が発生した場合:

cd <worktree> && git fetch origin main && git rebase origin/main
# 競合を解決する
git push --force-with-lease

クリーンアップ

git worktree remove <path>
git branch -D <branch>
git worktree prune

クイックリファレンス

ヒント 理由
Issue ごとに 1〜3 個のファイル 成功率が高い
"Files to Modify" を含める エージェントがコードをより早く見つける
バックエンドファーストの波 フロントエンドの競合が少ない
同じファイルの PR を順番にマージする それぞれの間でリベースする
問題 解決策
エージェントが権限でスタックしている git を手動で完了する
マージの競合 リベース、解決、強制プッシュ
エージェントがスコープ外になった PR を拒否し、Issue を明確にする
競合が多すぎる より小さな波、順番にマージ
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

Orchestrating Parallel Agents

Spawn multiple Claude agents to work on related issues concurrently using git worktrees.

Philosophy

  • Issues ARE the prompts - Write issues with enough context for autonomous work
  • Maximize parallelism - Group independent work into waves
  • Fail fast - Complete git/PR manually if agents can't
  • Trust but verify - Review diffs, resolve conflicts manually

Workflow Checklist

Copy and track progress:

Parallel Agent Orchestration:
- [ ] 1. Break feature into issues (1-3 files each)
- [ ] 2. Organize into waves (independent → dependent)
- [ ] 3. Pre-approve git permissions in settings.local.json
- [ ] 4. Spawn wave with --print flag
- [ ] 5. Monitor progress
- [ ] 6. Complete stragglers manually
- [ ] 7. Merge PRs (rebase between same-file conflicts)
- [ ] 8. Cleanup worktrees

Issue Template

Each issue should be completable in isolation:

## Problem
What's broken or missing.

## Solution
High-level approach.

## Files to Modify
- `path/to/file` - what changes

## Implementation
Code snippets or pseudocode.

## Acceptance Criteria
- [ ] Testable outcomes

Key: Include file paths and code examples. Agents work best with concrete starting points.

Wave Organization

Wave 1: Independent changes (no shared files)
Wave 2: Changes that may touch same files (expect conflicts)
Wave 3: Integration/testing (depends on all above)

Rule: Same-file issues go in different waves OR same agent.

Pre-approve Permissions

Add to .claude/settings.local.json for non-interactive --print mode:

"Bash(git -C /absolute/path/to/worktree add:*)",
"Bash(git -C /absolute/path/to/worktree commit:*)",
"Bash(git -C /absolute/path/to/worktree push:*)"

Spawn Agents

for issue in 101 102 103; do
  (claude --print "/worktree-issue $issue" > "issue-${issue}.log" 2>&1) &
done

Monitor

ps aux | grep "claude.*worktree" | wc -l  # Running agents
git worktree list                          # Worktrees created
tail -f issue-*.log                        # Live logs

Complete Stragglers

If agent finishes code but fails on git:

git -C <worktree> add -A
git -C <worktree> commit -m "feat: description"
git -C <worktree> push -u origin <branch>
gh pr create --head <branch> --title "..." --body "Closes #N"

Merge with Conflicts

gh pr merge N --squash --delete-branch

If conflicts after prior merges:

cd <worktree> && git fetch origin main && git rebase origin/main
# resolve conflicts
git push --force-with-lease

Cleanup

git worktree remove <path>
git branch -D <branch>
git worktree prune

Quick Reference

Tip Why
1-3 files per issue Higher success rate
Include "Files to Modify" Agents find code faster
Backend-first waves Fewer frontend conflicts
Merge same-file PRs sequentially Rebase between each
Problem Solution
Agent stuck on permissions Complete git manually
Merge conflict Rebase, resolve, force-push
Agent went off-scope Reject PR, clarify issue
Too many conflicts Smaller waves, sequential merge