| name | claude-collab |
| description | Autonomous multi-round debate between two Claude Code instances via tmux. Supports advocate/devil's-advocate, expert perspectives, and custom roles for design decisions, code review, debugging, and brainstorming. Use when user wants "Claude同士で議論", "ディベート", "多角的に検討", "debate", "pros and cons". |
| version | 1.1.0 |
Claude Collab（Claude 対話ディベート）
2つの Claude Code インスタンスが tmux 経由で自律的に N ラウンドの議論を行うスキル。
メイン Claude は中立的なオーケストレーターとして進行を管理し、Role A / Role B は両方 claude -p で実行する。
概要
| 項目 | 値 |
|---|
| メイン Claude | 中立オーケストレーター（進行管理・論点台帳管理・収束判定） |
| Role A | tmux ペインの claude -p（ワンショット） |
| Role B | tmux ペインの claude -p（ワンショット） |
| Judge | tmux ペインの claude -p（最終要約） |
| デフォルトラウンド数 | 3（範囲: 2-7） |
| 1ラウンド文字数上限 | 1000文字 |
前提条件（実行前に確認）
以下をすべて確認してから開始すること:
- tmux セッション内で実行していること
claude CLI がインストール済み・認証済みであることclaude -p "hello" が正常に応答を返すこと
確認コマンド:
echo $TMUX
env -u CLAUDECODE claude -p "hello"
重要: Claude Code セッション内から claude -p を実行するには CLAUDECODE 環境変数をアンセットする必要がある。
すべての claude -p 実行は env -u CLAUDECODE claude -p ... の形式で行うこと。
いずれかが失敗した場合は、ユーザーに案内して中断する。
ワークフロー
Phase 0: Configuration（設定）
AskUserQuestion ツールを使って以下を確認する:
- 議論テーマ: ユーザーが指定したテーマを確認。引数があればそれを使用
- ロールモード: 以下から選択（デフォルト: advocate-vs-devils-advocate）
advocate-vs-devils-advocate: 賛成 vs 反対expert-perspectives: 専門家視点ペア（references/role_presets.md から選択）custom: ユーザーが Role A/B を自由定義
- ラウンド数: デフォルト 3（範囲: 2-7）
- コンテキスト（任意）: 議論に含めるコードファイルやドキュメント
Phase 1: Setup（セットアップ）
tmux ペインを作成する。Role A と Role B は同じペインで順番に実行する。
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"
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 の実行
ファイルベースの実行パターンで claude -p を実行する。
参照: references/execution_pattern.md の基本パターン（Step 2〜5）
- プロンプト:
$COLLAB_TMPDIR/roleA-round-${round}.txt
- 出力:
$COLLAB_TMPDIR/roleA-out-${round}.txt
- 待機: 最大120秒、2秒間隔ポーリング
- タイムアウト時: リトライ1回、失敗なら "(タイムアウト)" として記録
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 と同じ実行パターン（ファイル名は 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: 収束チェック
以下のいずれかが成立したら早期終了（終了理由を記録すること）:
new_points == 0 が2ラウンド連続 → 終了理由: converged-early- 全論点が
resolved または dropped → 終了理由: converged-early
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 の実行:
同じファイルベースの実行パターン（references/execution_pattern.md 参照）。
- プロンプト:
$COLLAB_TMPDIR/judge.txt
- 出力:
$COLLAB_TMPDIR/judge-out.txt
- 待機: 最大180秒、3秒間隔ポーリング
- タイムアウト時: リトライ1回、失敗なら "(Judge タイムアウト)" としてユーザーに報告
Judge の出力をユーザーに表示する。
Phase 4: Cleanup（後片付け）
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 で以下から選択:
| ID | ペア名 | 用途 |
|---|
| security-vs-performance | セキュリティ vs パフォーマンス | 技術選定、API 設計 |
| security-vs-delivery | セキュリティ vs デリバリー速度 | リリース判断 |
| pragmatist-vs-purist | 実用主義 vs 理想主義 | 設計方針 |
| frontend-vs-backend | フロントエンド vs バックエンド | フルスタック設計 |
| maintainer-vs-innovator | 保守 vs 革新 | 技術刷新判断 |
| user-vs-developer | ユーザー vs 開発者 | UI/UX 設計 |
| simplicity-vs-scalability | シンプルさ vs スケーラビリティ | アーキテクチャ |
| cost-vs-reliability | コスト vs 信頼性 | インフラ設計 |
| product-vs-tech-debt | プロダクト価値 vs 技術的負債 | スプリント計画 |
詳細は 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 で議論して」
→ コスト最適化と信頼性の両面から分析
待機時間の目安
| 内容 | claude -p 待機時間 | 最大待機時間 |
|---|
| 短い議論（500文字以下） | 30秒 | 60秒 |
| 標準的な議論（1000文字） | 60秒 | 120秒 |
| Judge（全ラウンド要約） | 90秒 | 180秒 |
エラーハンドリング
| エラー | 対応 |
|---|
| tmux 未起動 | 中断。「tmux セッション内で実行してください」と案内 |
| claude CLI 未認証 | 中断。「claude auth を実行してください」と案内 |
| claude -p タイムアウト（Role: 120秒 / Judge: 180秒） | リトライ1回。失敗なら該当ラウンドをスキップ |
| CLAUDECODE 環境変数エラー | env -u CLAUDECODE が適用されているか確認 |
| ペイン消失 | ペイン再作成して続行 |
| 応答が空 | リトライ1回。失敗なら「応答なし」として記録し次ラウンドへ |
| exit ファイル未生成（タイムアウト） | claude -p がハングした場合。ポーリング上限到達後にリトライ1回 |
| exit コードが非ゼロ | claude -p のエラー。出力先頭5行をユーザーに表示しリトライ1回 |
リトライ制限
| 項目 | 上限 |
|---|
| 同一ステップの再試行 | 最大 1 回 |
| 総タイムアウト | 15 分（全ラウンド + Judge 合計） |
リカバリー手順
- エラー内容をユーザーに表示
- tmux ペインの状態を確認:
tmux list-panes
- ペインが存在すれば、一時ファイルの状態を確認
- 可能なら次のステップから再開、不可能なら Phase 4（Cleanup）へ
ツール使用ルール
| ツール | 用途 | 注意 |
|---|
| AskUserQuestion | Phase 0 の設定確認 | ロールモード・ラウンド数・テーマ |
| Write | プロンプトファイルの書き出し | $COLLAB_TMPDIR/ に出力（セッション固有） |
| Bash | tmux 操作、claude -p 実行 | tmux send-keys と Enter は別々の Bash 呼び出しで実行 |
| Read | コンテキストファイルの読み込み | ユーザー指定のファイルのみ |
重要: tmux send-keys と Enter 送信は && で連結しないこと。
各コマンドは別々の Bash 呼び出しで実行する（codex-collab と同じ制約）。
参照ファイル
references/role_presets.md - 10種のプリセットロール定義references/discussion_summary_template.md - Judge 用サマリーテンプレートreferences/execution_pattern.md - claude -p のファイルベース実行パターン
