Agent Teams 並列コーディング スキル

概要

Agent Teamsを使用して、複数エージェントが安全に並列コーディングを行うためのオーケストレーションスキル。 ファイル所有権の事前設計が核心であり、これにより上書き競合を完全に防止する。

                          ┌──────────────┐
                          │   リーダー   │
                          │ (delegate)   │
                          └──────┬───────┘
                                 │
                    ┌────────────┼────────────┐
                    │            │            │
              ┌─────┴─────┐ ┌───┴────┐ ┌────┴─────┐
              │ Worker A  │ │Worker B│ │ Worker C │
              │ files: a/ │ │files:b/│ │ files:c/ │
              └───────────┘ └────────┘ └──────────┘
                    │            │            │
                    ▼            ▼            ▼
              ┌─────────────────────────────────────┐
              │    排他的ファイル所有権マップ        │
              │  A: src/api/*, tests/api/*           │
              │  B: src/ui/*,  tests/ui/*            │
              │  C: src/db/*,  tests/db/*            │
              │  shared: types/ → A のみ書込可       │
              └─────────────────────────────────────┘

前提条件

環境変数の有効化

Agent Teams は実験的機能のため、環境変数の設定が必要。

# PowerShellで環境変数を設定
$env:CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS = "1"

# 永続化する場合（ユーザー環境変数に追加）
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS", "1", "User")

確認方法

Agent Teamsが有効かどうかは、TeamCreate ツールが使用可能であることで判断する。

核心ルール: ファイル競合防止（10箇条）

1. 1ファイル1オーナー: 各ファイルは1人のワーカーだけが書き込み可能
2. 所有権は事前確定: タスク開始前にファイル割当を完了する
3. 禁止ファイルの明示: 各ワーカーに「触ってはいけないファイル」を明示する
4. 共有ファイルは single_writer: types/、package.json等は必ず1人だけが変更権を持つ
5. 所有権移譲は3ステップ: 通知 → 受領確認 → 編集停止（暗黙の移譲禁止）
6. プロンプトに writable/forbidden 必須: ワーカースポーン時に所有権範囲を明記
7. 統合は固定順序: DB層 → 型定義 → API → UI → テスト → エントリーポイント
8. 統合前に競合検査: 変更ファイルの重複チェックを必ず実行
9. ワーカー上限4人: 管理コスト > 統合利点にならないよう制限
10. コミット前にTeamDelete禁止: worktreeディレクトリが削除され未コミット変更が消失

7ステップ実行フロー（概要）

チーム構造パターン（4種）

クイックスタート（最小手順）

1. 環境変数確認
   → CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS = "1"

2. コードベースの構造を把握
   → Glob / Read でディレクトリ構造確認

3. 所有権マップ作成（最重要）
   → 所有権契約テンプレートを埋める

4. タスク作成
   → TaskCreate で依存関係・ファイル割当を明記

5. チーム作成 & ワーカースポーン
   → TeamCreate → Task tool (name, team_name, mode: "delegate")
   → プロンプトに writable / forbidden を必ず記載

6. 監視 & 完了報告収集
   → TaskList で進捗確認、SendMessage で調整

7. 統合 & 検証
   → 基盤層から順に統合 → テスト → クリーンアップ

詳細リファレンス

references/execution-flow.md

• 7ステップ実行フロー詳細（各Stepの入力・出力・完了条件・具体例）
• 所有権契約テンプレート（YAML形式）
• TaskCreate の記述ルール・プロンプト例
• 統合順序（固定順序の理由）
• 検証チェックリスト・クリーンアップ項目
• タスクサイズガイドライン

references/team-patterns.md

• パターン1: フロントエンド + バックエンド分離（所有権・失敗パターン・防止策）
• パターン2: 機能モジュール分離（所有権・失敗パターン・防止策）
• パターン3: 実装 + テスト分離（テスト担当の先行作業、所有権・防止策）
• パターン4: リファクタリング（ディレクトリ分離、統合順序制御）

references/conflict-prevention.md

• コアルール6箇条の詳細（排他的所有権、共有ファイル管理、競合ゾーン、所有権移譲プロトコル）
• 統合前競合検査スクリプト（PowerShell）
• アンチパターン一覧（12項目 + 理由 + 正しいやり方）
• 関連スキル・参考情報

トラブルシューティング

関連スキル

• /git-worktree-parallel: git worktree を使った並行実装。ワーカーごとに独立ディレクトリを提供し、ファイル競合をOSレベルで完全防止。Agent Teams との併用推奨
• /github-cli: PR作成・マージのワークフロー。統合後のPR管理に使用

改訂履歴