Claude Collab（Claude 対話ディベート）

2つの Claude Code インスタンスが tmux 経由で自律的に N ラウンドの議論を行うスキル。 メイン Claude は中立的なオーケストレーターとして進行を管理し、Role A / Role B は両方 claude -p で実行する。

概要

前提条件（実行前に確認）

以下をすべて確認してから開始すること:

1. tmux セッション内で実行していること
2. claude CLI がインストール済み・認証済みであること
3. claude -p "hello" が正常に応答を返すこと

確認コマンド:

echo $TMUX                              # 空でなければ tmux 内
env -u CLAUDECODE claude -p "hello"     # 応答が返れば OK

重要: Claude Code セッション内から claude -p を実行するには CLAUDECODE 環境変数をアンセットする必要がある。 すべての claude -p 実行は env -u CLAUDECODE claude -p ... の形式で行うこと。

いずれかが失敗した場合は、ユーザーに案内して中断する。

ワークフロー

Phase 0: Configuration（設定）

AskUserQuestion ツールを使って以下を確認する:

1. 議論テーマ: ユーザーが指定したテーマを確認。引数があればそれを使用
2. ロールモード: 以下から選択（デフォルト: advocate-vs-devils-advocate）
   • advocate-vs-devils-advocate: 賛成 vs 反対
   • expert-perspectives: 専門家視点ペア（references/role_presets.md から選択）
   • custom: ユーザーが Role A/B を自由定義
3. ラウンド数: デフォルト 3（範囲: 2-7）
4. コンテキスト（任意）: 議論に含めるコードファイルやドキュメント

Phase 1: Setup（セットアップ）

tmux ペインを作成する。Role A と Role B は同じペインで順番に実行する。

# プラグインルートの特定（tmux_ai.sh のパス解決）
PLUGIN_ROOT=$(dirname "$(claude skill show claude-collab 2>/dev/null | grep -m1 'path:' | awk '{print $2}')" 2>/dev/null)
if [ -z "$PLUGIN_ROOT" ]; then
  # フォールバック: よく使われるパスを順に探索
  for dir in \
    "$HOME/.claude/plugins/dev-tools-plugin" \
    "$HOME/workspace/claude-plugins/dev-tools-plugin" \
    "$(pwd)"; do
    if [ -f "$dir/skills/tmux-ai-chat/scripts/tmux_ai.sh" ]; then
      PLUGIN_ROOT="$dir"
      break
    fi
  done
fi
SCRIPT_DIR="${PLUGIN_ROOT}/skills/tmux-ai-chat/scripts"

# tmux_ai.sh でシェルペインを作成
pane=$("${SCRIPT_DIR}/tmux_ai.sh" split --direction h --percent 40 --name "Claude-Debate" --print-pane-id)

注意: tmux_ai.sh が見つからない場合は直接 tmux コマンドでフォールバックする:

tmux split-window -h
pane=$(tmux list-panes -F "#{pane_id}" | tail -1)

セッション固有の一時ディレクトリ: 並列実行時のファイル名衝突を防ぐため、セッション固有のディレクトリを使用する:

COLLAB_TMPDIR="/tmp/claude-collab-$$"
mkdir -p "$COLLAB_TMPDIR" && chmod 700 "$COLLAB_TMPDIR"

以降の一時ファイルはすべて $COLLAB_TMPDIR/ 配下に作成する。

Phase 2: Discussion Loop（議論ループ）

論点台帳（Issue Ledger） をオーケストレーターが管理する。

論点台帳の形式

| issue_id | topic | status | evidence_a | evidence_b |
|----------|-------|--------|------------|------------|

• status: open（未解決）/ resolved（合意済）/ dropped（除外）
• 各ラウンドのプロンプトには台帳全体 + 直近2ラウンドの発言を含める

各ラウンドの手順

以下を round = 1 から max_rounds まで繰り返す:

Step 1: Role A のプロンプト作成

以下の内容を $COLLAB_TMPDIR/roleA-round-{round}.txt に書き出す:

あなたは「{Role A の名前と説明}」として議論に参加しています。

## 議論テーマ
{topic}

## コンテキスト
{context_if_any}

## 論点台帳（現在の状態）
{issue_ledger}

## 直近の議論（最大2ラウンド分）
{recent_history}

## 指示
- これはラウンド {round}/{max_rounds} です
- 前の発言者の主張に対して、あなたの立場から応答してください
- 具体的な根拠やコード例を含めてください
- 新しい論点があれば提起してください
- 必ず反論や別の視点を含めてください（安易に同意しないでください）
- 1000文字以内で回答してください
- 出力はプレーンテキストで、余計なマークアップや装飾は含めないでください

Step 2: Role A の実行

出力をファイルにリダイレクトし、完了を done ファイルで検出する（マーカー方式は claude -p のような長時間コマンドでは不安定なため非推奨）:

# tmux ペインでコマンド実行（出力はファイルにリダイレクト、終了コードも記録）
tmux send-keys -t "$pane" "env -u CLAUDECODE claude -p < \"$COLLAB_TMPDIR/roleA-round-${round}.txt\" > \"$COLLAB_TMPDIR/roleA-out-${round}.txt\" 2>&1; echo \$? > \"$COLLAB_TMPDIR/roleA-exit-${round}.txt\""

tmux send-keys -t "$pane" Enter

# 完了を待機（最大120秒、2秒間隔でポーリング）
for i in $(seq 1 60); do
  [ -f "$COLLAB_TMPDIR/roleA-exit-${round}.txt" ] && break
  sleep 2
done

# タイムアウト判定
if [ ! -f "$COLLAB_TMPDIR/roleA-exit-${round}.txt" ]; then
  echo "TIMEOUT: Role A round ${round}"
  # → リトライ1回（同じコマンドを再送信）。2回目も失敗なら "(タイムアウト)" として記録し次ラウンドへ
fi

# 終了コード判定 + 出力取得
exit_code=$(cat "$COLLAB_TMPDIR/roleA-exit-${round}.txt" 2>/dev/null || echo "1")
if [ "$exit_code" != "0" ]; then
  response_a="(エラー: claude -p が終了コード ${exit_code} で失敗。出力: $(head -5 "$COLLAB_TMPDIR/roleA-out-${round}.txt" 2>/dev/null))"
  # → リトライ1回。2回目も失敗なら上記のエラー内容をユーザーに表示し次ラウンドへ
else
  response_a=$(cat "$COLLAB_TMPDIR/roleA-out-${round}.txt" 2>/dev/null || echo "(応答なし)")
fi
rm -f "$COLLAB_TMPDIR/roleA-exit-${round}.txt"

重要: tmux send-keys と Enter は別々の Bash 呼び出しで実行すること（codex-collab と同じ制約）。

Step 3: Role A の応答をユーザーに表示

── Round {round}/{max_rounds} ──

🔵 Role A（{role_a_name}）:
{response_a}

Step 4: Role B のプロンプト作成

Role A の応答を含めて $COLLAB_TMPDIR/roleB-round-{round}.txt に書き出す。 構造は Role A と同じだが、Role B の説明と「Role A の直前の発言」を追加する。

Step 5: Role B の実行

Step 2 と同じファイルベース方式で実行する。コマンドは以下の通り:

tmux send-keys -t "$pane" "env -u CLAUDECODE claude -p < \"$COLLAB_TMPDIR/roleB-round-${round}.txt\" > \"$COLLAB_TMPDIR/roleB-out-${round}.txt\" 2>&1; echo \$? > \"$COLLAB_TMPDIR/roleB-exit-${round}.txt\""

tmux send-keys -t "$pane" Enter

完了待機・タイムアウト判定・終了コード判定は Step 2 と同一パターン（ファイル名は roleB-* に置換）。

Step 6: Role B の応答をユーザーに表示

🔴 Role B（{role_b_name}）:
{response_b}

Step 7: 論点台帳の更新

オーケストレーター（メイン Claude）が以下を行う:

• Role A と Role B の応答から新しい論点を抽出 → 台帳に追加（status: open）
• 両者が合意した論点 → status を resolved に更新
• evidence_a / evidence_b に各発言の要約を記録

Step 8: 収束チェック

以下のいずれかが成立したら早期終了（終了理由を記録すること）:

1. new_points == 0 が2ラウンド連続 → 終了理由: converged-early
2. 全論点が resolved または dropped → 終了理由: converged-early
3. max_rounds に到達 → 終了理由: max-rounds

堂々巡りの検出:

• 3ラウンド以上で同じ論点の evidence が実質的に変わっていない
• → 対処: 新しい切り口を注入して続行。注入しても改善しない場合 → 終了理由: circular-break

Phase 3: Judge（中立要約）

議論終了後、別の claude -p で中立的な Judge を実行する。

Judge プロンプトの作成:

以下の内容を $COLLAB_TMPDIR/judge.txt に書き出す:

あなたは中立的な Judge として、以下のディベートの最終要約を作成してください。
どちらの立場にも偏らず、両方の論点を公平に扱ってください。

## 議論テーマ
{topic}

## ロール
- Role A: {role_a_name}（{role_a_description}）
- Role B: {role_b_name}（{role_b_description}）

## 論点台帳（最終状態）
{final_issue_ledger}

## 全ラウンド記録
{all_rounds_history}

## 出力形式
以下のテンプレートに従って要約を作成してください:

1. TL;DR（3点以内の箇条書き）
2. 合意点（両者が同意した点）
3. 対立点（解消されなかった対立、各側の立場とトレードオフ）
4. トレードオフ分析（表形式）
5. 推奨アクション（中立的な提案）
6. 全ラウンド記録（details タグで折りたたみ）

1000文字以内の制約はありません。網羅的に要約してください。
出力はプレーンテキストで、余計なマークアップや装飾は含めないでください。

Judge の実行:

# tmux ペインで Judge 実行（出力はファイルにリダイレクト、終了コードも記録）
tmux send-keys -t "$pane" "env -u CLAUDECODE claude -p < \"$COLLAB_TMPDIR/judge.txt\" > \"$COLLAB_TMPDIR/judge-out.txt\" 2>&1; echo \$? > \"$COLLAB_TMPDIR/judge-exit.txt\""

tmux send-keys -t "$pane" Enter

# 完了を待機（最大180秒、3秒間隔でポーリング）
for i in $(seq 1 60); do
  [ -f "$COLLAB_TMPDIR/judge-exit.txt" ] && break
  sleep 3
done

# タイムアウト判定
if [ ! -f "$COLLAB_TMPDIR/judge-exit.txt" ]; then
  echo "TIMEOUT: Judge"
  # → リトライ1回。2回目も失敗なら "(Judge タイムアウト)" としてユーザーに報告
fi

# 終了コード判定 + 出力取得
exit_code=$(cat "$COLLAB_TMPDIR/judge-exit.txt" 2>/dev/null || echo "1")
if [ "$exit_code" != "0" ]; then
  judge_output="(エラー: Judge が終了コード ${exit_code} で失敗。出力: $(head -5 "$COLLAB_TMPDIR/judge-out.txt" 2>/dev/null))"
else
  judge_output=$(cat "$COLLAB_TMPDIR/judge-out.txt" 2>/dev/null || echo "(Judge 応答なし)")
fi

Judge の出力をユーザーに表示する。

Phase 4: Cleanup（後片付け）

# tmux ペインを終了（tmux_ai.sh があれば使用、なければ直接 tmux コマンド）
if [ -x "$SCRIPT_DIR/tmux_ai.sh" ]; then
  "$SCRIPT_DIR/tmux_ai.sh" kill --pane "$pane"
else
  tmux kill-pane -t "$pane" 2>/dev/null
fi

# セッション固有の一時ディレクトリを削除
rm -rf "$COLLAB_TMPDIR"

ロールモード

advocate-vs-devils-advocate（デフォルト）

最も汎用的なモード。提案に対する推進と批判的検証。 詳細は references/role_presets.md のセクション1を参照。

expert-perspectives

専門家の視点ペアを選択する。AskUserQuestion で以下から選択:

詳細は references/role_presets.md を参照。

custom

ユーザーが Role A と Role B の説明を自由に定義する。 AskUserQuestion で各ロールの名前と説明を入力してもらう。

使用例

設計判断のディベート

ユーザー: 「認証方式として JWT と セッションベース、どちらが良いか議論して」
→ デフォルトの advocate-vs-devils-advocate で議論
→ Role A が JWT を推進、Role B が批判的に検証

コードレビューの多角的分析

ユーザー: 「このリファクタリング方針について、maintainer-vs-innovator で議論して」
→ expert-perspectives モードで指定ペアを使用
→ 保守性と革新性の観点から多角的に検討

技術選定のトレードオフ分析

ユーザー: 「PostgreSQL vs MongoDB の選定を cost-vs-reliability で議論して」
→ コスト最適化と信頼性の両面から分析

待機時間の目安

エラーハンドリング

リトライ制限

リカバリー手順

1. エラー内容をユーザーに表示
2. tmux ペインの状態を確認: tmux list-panes
3. ペインが存在すれば、一時ファイルの状態を確認
4. 可能なら次のステップから再開、不可能なら Phase 4（Cleanup）へ

ツール使用ルール

重要: tmux send-keys と Enter 送信は && で連結しないこと。 各コマンドは別々の Bash 呼び出しで実行する（codex-collab と同じ制約）。

参照ファイル

• references/role_presets.md - 10種のプリセットロール定義
• references/discussion_summary_template.md - Judge 用サマリーテンプレート