@hummer98/cmux-team 3.0.0

package/commands/team-impl.md

@@ -0,0 +1,201 @@
+---
+allowed-tools: Bash, Read, Write, Edit, Glob, Grep
+description: "実装エージェントを起動しコーディングタスクを並列実行する"
+---
+
+# /team-impl
+
+実装エージェントを起動し、コーディングタスクを並列に実行してください。
+
+## 手順
+
+### 1. 前提チェック
+
+- `.team/team.json` が存在すること
+- `CMUX_SOCKET_PATH` が設定されていること
+- `cmux` コマンドが利用可能であること
+- `.team/specs/design.md` が存在すること
+  - 存在しない場合: 「設計がありません。`/team-design` を先に実行してください」
+
+### 2. タスク一覧の準備
+
+#### tasks.md が存在する場合:
+- `.team/specs/tasks.md` を読み込む
+- タスクを解析（各 `## Task N:` セクションを抽出）
+- ステータスを確認（完了済み、進行中、未着手）
+
+#### tasks.md が存在しない場合:
+- `.team/specs/design.md` を読み込む
+- 設計からタスクを自動生成:
+  - コンポーネントごとにタスクを分割
+  - 依存関係を分析
+  - 並列実行可能なタスクに `(P)` フラグを付与
+- `.team/specs/tasks.md` に書き出す
+- ユーザーに確認: 「タスク一覧を生成しました。確認してください。」
+
+### 3. タスク選択
+
+`$ARGUMENTS` に基づいてタスクを選択:
+
+- `"all"` → 全未着手タスクを対象
+- `"1,2,3"` → 指定された番号のタスクのみ
+- 空 → 並列実行可能 `(P)` な未着手タスクをすべて対象
+
+依存関係チェック:
+- 依存先が未完了のタスクは除外する
+- 除外されたタスクがあればユーザーに報告
+
+### 4. エージェント数の決定
+
+- 選択されたタスク数に基づいてエージェント数を決定
+- 最大数: Tier に応じて制限
+  - Small (1+3): 最大 3 エージェント
+  - Medium (1+5): 最大 5 エージェント
+  - Large (1+7): 最大 7 エージェント
+- デフォルト: Small (1+3)
+- タスク数がエージェント数を超える場合は、最初のバッチを実行し、完了後に次のバッチを開始
+
+### 5. プロンプト生成
+
+各実装エージェントに対して:
+
+1. `~/.claude/skills/cmux-team/templates/common-header.md` を読み込み
+2. `~/.claude/skills/cmux-team/templates/implementer.md` を読み込み
+3. テンプレート変数を置換:
+   - `{{ROLE_ID}}` → `implementer-N`
+   - `{{TASK_DESCRIPTION}}` → 割り当てタスクの説明
+   - `{{OUTPUT_FILE}}` → `.team/output/implementer-N.md`
+   - `{{PROJECT_ROOT}}` → カレントディレクトリ
+   - `{{TASKS_CONTENT}}` → 割り当てタスクの詳細
+   - `{{DESIGN_CONTENT}}` → design.md の内容
+   - `{{COMMON_HEADER}}` → 展開済み共通ヘッダー
+4. `.team/prompts/implementer-N.md` に書き出す
+
+### 6. エージェント起動
+
+サブエージェントの配置は cmux-team SKILL.md §5 参照。
+
+```bash
+# Conductor と同じワークスペース内で分割（デフォルト）
+cmux new-split right  # → surface:S1
+cmux new-split right  # → surface:S2
+# ...必要に応じて追加
+```
+
+各エージェントに対して（**1体ずつ確実に起動、cmux-team SKILL.md §2.1 の手順に従う**）:
+
+```bash
+# a. ステータス設定
+cmux set-status implementer-N "spawning" --icon sparkle --color "#ffcc00"
+
+# c. Claude 起動（シェルコマンドは \n で送信可能）
+cmux send --surface surface:SN --workspace workspace:W "claude --dangerously-skip-permissions\n"
+
+# d. 起動完了を待つ（Trust確認 or ❯ プロンプトをポーリング、SKILL.md §2.1 Step 5 参照）
+for i in $(seq 1 10); do
+  SCREEN=$(cmux read-screen --surface surface:SN --workspace workspace:W 2>&1)
+  if echo "$SCREEN" | grep -q "Yes, I trust"; then
+    cmux send-key --surface surface:SN --workspace workspace:W "return"
+    sleep 5; break
+  elif echo "$SCREEN" | grep -q '❯'; then
+    break
+  fi
+  sleep 3
+done
+
+# e. プロンプト送信（単一行指示 → \n で送信可能）
+cmux send --surface surface:SN --workspace workspace:W ".team/prompts/implementer-N.md を読んで指示に従ってください。\n"
+
+# f. 送信確認 + ステータス更新
+sleep 3
+SCREEN=$(cmux read-screen --surface surface:SN --workspace workspace:W 2>&1)
+if ! echo "$SCREEN" | grep -qE '(Stewing|Thinking|Reading|Searching|Ideating)'; then
+  cmux send-key --surface surface:SN --workspace workspace:W "return"
+  sleep 3
+fi
+cmux set-status implementer-N "running" --icon hammer --color "#0099ff"
+```
+
+### 7. 進捗モニタリング
+
+```bash
+cmux set-progress 0.0 --label "Implementation: 0/N tasks done"
+```
+
+30 秒間隔で各エージェントをモニタリング:
+
+```bash
+# 画面確認
+cmux read-screen --surface surface:X --lines 20
+
+# 出力ファイルの存在チェック
+ls -la .team/output/implementer-N.md 2>/dev/null
+```
+
+モニタリング中に表示する情報:
+- 各エージェントの最新ステータス（cmux のサイドバーから取得）
+- 完了したエージェントの数
+- エラーが発生したエージェント
+
+### 8. 完了待機と次バッチ
+
+```bash
+# 各エージェントの完了を待つ
+cmux wait-for "implementer-N-done" --timeout 600
+```
+
+エージェントが完了したら:
+1. 出力を収集（`.team/output/implementer-N.md`）
+2. tasks.md の対応タスクを完了マークに更新
+3. プログレスバーを更新
+
+**次バッチの処理**（タスクがエージェント数を超えている場合）:
+1. 完了したエージェントのペインを再利用
+2. 次の未着手タスクのプロンプトを生成
+3. 同じ surface に新しいプロンプトを送信
+4. 全タスク完了まで繰り返す
+
+### 9. 結果統合
+
+全エージェントの完了後:
+
+1. 全出力ファイルを読み込み
+2. 統合サマリーを作成:
+   - **完了タスク**: 各タスクの完了状況
+   - **変更ファイル一覧**: 全エージェントが変更したファイルの統合リスト
+   - **テスト結果**: 各エージェントが実行したテスト結果
+   - **タスク**: エージェントが作成したタスク
+3. ユーザーに提示
+
+### 10. クリーンアップと状態更新
+
+- エージェントペインの処理をユーザーに確認
+- （team.json は daemon が自動更新する）
+- プログレスバーをクリア
+
+### 11. 次のステップ案内
+
+```
+実装フェーズが完了しました。
+
+完了タスク: N/M
+変更ファイル: X 個
+タスク: Y 件
+
+次のステップ:
+  /team-review  → 実装のレビュー
+  /team-test    → テストの作成・実行
+  /team-impl    → 残りのタスクを実装（未完了がある場合）
+```
+
+## 引数
+
+`$ARGUMENTS` = 実装するタスク番号（例: "1,2,3" または "all"）。オプション。
+
+## エラーハンドリング
+
+- エージェントがクラッシュした場合: 検出後リスポーンを提案
+- コンフリクトが発生した場合（複数エージェントが同じファイルを変更）:
+  - 検出: `git status` で確認
+  - ユーザーに報告し、手動解決を案内
+- タスクが長時間完了しない場合: 画面を確認し、ユーザーに判断を委ねる

package/commands/team-research.md

@@ -0,0 +1,182 @@
+---
+allowed-tools: Bash, Read, Write, Edit, Glob, Grep
+description: "リサーチエージェントを起動しトピックを並列調査する"
+---
+
+# /team-research
+
+リサーチャーエージェントを起動し、指定トピックを並列に調査してください。
+
+## 手順
+
+### 1. 前提チェック
+
+- `.team/team.json` が存在すること（なければ `/team-init` を案内）
+- `CMUX_SOCKET_PATH` が設定されていること（なければエラー）
+- `cmux` コマンドが利用可能であること
+
+### 2. トピック解析
+
+`$ARGUMENTS` を解析する:
+
+- **カンマ区切りの場合** (例: "認証方式, セッション管理, トークン設計"):
+  各項目をそのままサブ質問として使用
+- **単一トピックの場合** (例: "認証パターンの調査"):
+  トピックを 3 つのサブ質問に分解する。分解の観点:
+  - 現状分析（What）: 既存コードベースでの実装状況
+  - 比較調査（How）: 一般的なパターンやベストプラクティス
+  - 適用性評価（Why）: このプロジェクトにおける推奨アプローチ
+- **空の場合**: ユーザーにトピックを尋ねる
+
+### 3. プロンプト生成
+
+各リサーチャー（最大 3 名）のプロンプトを生成する:
+
+1. `~/.claude/skills/cmux-team/templates/common-header.md` を読み込み
+2. `~/.claude/skills/cmux-team/templates/researcher.md` を読み込み
+3. テンプレート変数を置換:
+   - `{{ROLE_ID}}` → `researcher-1`, `researcher-2`, `researcher-3`
+   - `{{TASK_DESCRIPTION}}` → 各サブ質問
+   - `{{OUTPUT_FILE}}` → `.team/output/researcher-{N}.md`
+   - `{{PROJECT_ROOT}}` → カレントディレクトリの絶対パス
+   - `{{TOPIC}}` → 元のトピック
+   - `{{SUB_QUESTIONS}}` → 割り当てられたサブ質問
+   - `{{COMMON_HEADER}}` → 展開済み共通ヘッダー
+4. `.team/prompts/researcher-{1,2,3}.md` に書き出す
+
+### 4. エージェント起動
+
+サブエージェントの配置は cmux-team SKILL.md §5 参照。
+
+#### 4a. エージェント用ペインを作成
+
+```bash
+# Conductor と同じワークスペース内で分割（デフォルト）
+cmux new-split right  # → surface:S1
+cmux new-split right  # → surface:S2
+cmux new-split right  # → surface:S3
+```
+
+#### 4b. 各リサーチャーを1体ずつ起動
+
+**1体ずつ確実に起動すること。全員同時にやらない。**
+
+各リサーチャー（N=1,2,3）に対して:
+
+```bash
+# サイドバーステータス設定
+cmux set-status researcher-N "spawning" --icon sparkle --color "#ffcc00"
+
+# Claude を起動（シェルコマンドは \n で送信可能）
+cmux send --surface surface:SN --workspace workspace:W "claude --dangerously-skip-permissions\n"
+
+# Claude の起動完了を待つ（最大30秒ポーリング）
+# "Yes, I trust" → send-key return で承認
+# "❯" → プロンプト送信可能
+for i in $(seq 1 10); do
+  SCREEN=$(cmux read-screen --surface surface:SN --workspace workspace:W 2>&1)
+  if echo "$SCREEN" | grep -q "Yes, I trust"; then
+    cmux send-key --surface surface:SN --workspace workspace:W "return"
+    sleep 5; break
+  elif echo "$SCREEN" | grep -q '❯'; then
+    break
+  fi
+  sleep 3
+done
+
+# プロンプトを送信（単一行指示 → \n で送信可能）
+cmux send --surface surface:SN --workspace workspace:W ".team/prompts/researcher-N.md を読んで、その指示に従って作業してください。\n"
+
+# 送信確認（3秒後に処理開始を検出）
+sleep 3
+SCREEN=$(cmux read-screen --surface surface:SN --workspace workspace:W 2>&1)
+if echo "$SCREEN" | grep -qE '(Stewing|Thinking|Reading|Searching|Ideating)'; then
+  cmux set-status researcher-N "running" --icon hammer --color "#0099ff"
+else
+  # 入力欄に残っている場合は再度 Enter
+  cmux send-key --surface surface:SN --workspace workspace:W "return"
+  sleep 3
+  cmux set-status researcher-N "running" --icon hammer --color "#0099ff"
+fi
+```
+
+**ポイント**:
+- プロンプト送信は「ファイルパスを読んで実行して」の単一行指示を推奨
+- 複数行テキストを直接送る場合は `cmux send` + `cmux send-key return` の2段階が必要
+
+### 5. 進捗トラッキング
+
+```bash
+cmux set-progress 0.0 --label "Research: 0/3 agents done"
+```
+
+### 6. 完了待機
+
+各リサーチャーの完了を待つ:
+
+```bash
+# 並列で待機（各エージェントに対して）
+cmux wait-for "researcher-1-done" --timeout 300
+cmux wait-for "researcher-2-done" --timeout 300
+cmux wait-for "researcher-3-done" --timeout 300
+```
+
+待機中、定期的に（30 秒ごとに）:
+- 各エージェントの画面を `cmux read-screen` で確認
+- エラーがあれば報告
+- 進捗バーを更新
+
+タイムアウトした場合:
+- `cmux read-screen` で状態を確認
+- ユーザーに報告し、待機を続けるか判断を委ねる
+
+### 7. 結果収集
+
+完了したエージェントの出力を収集:
+
+```bash
+# 各出力ファイルを読み込み
+cat .team/output/researcher-1.md
+cat .team/output/researcher-2.md
+cat .team/output/researcher-3.md
+```
+
+- 出力ファイルが存在しない場合はスクリーンスクレイピングにフォールバック:
+  ```bash
+  cmux read-screen --surface surface:X --scrollback --lines 200
+  ```
+
+### 8. 結果統合
+
+3 つのリサーチ結果を統合して:
+
+1. **統合サマリー**: 主要な発見事項を 5-7 bullet points で
+2. **サブ質問ごとの回答**: 各リサーチャーの結果を構造化
+3. **共通する発見**: 複数のリサーチャーが指摘した事項
+4. **相違点**: リサーチャー間で見解が異なる部分
+5. **推奨事項**: 統合した推奨アクション
+6. **オープン質問**: 未解決の事項
+
+### 9. 結果保存
+
+ユーザーに確認後:
+- 統合結果を `.team/specs/research.md` に保存
+- （team.json は daemon が自動更新する）
+
+### 10. クリーンアップ
+
+ユーザーに確認:
+- リサーチャーペインを閉じるか？
+  - YES: 各ペインを `/exit` → `cmux close-surface` → ステータスクリア
+  - NO: ペインは残しておく（後で `/team-disband` で閉じられる）
+- プログレスバーをクリア: `cmux clear-progress`
+
+## 引数
+
+`$ARGUMENTS` = リサーチトピック、またはカンマ区切りのサブトピック
+
+## エラーハンドリング
+
+- cmux コマンドが失敗した場合: エラーメッセージを表示し、手動での対応方法を案内
+- エージェントが起動しない場合: surface を閉じて再試行を提案
+- 部分的な結果の場合: 完了したエージェントの結果のみで統合を実施

package/commands/team-review.md

@@ -0,0 +1,222 @@
+---
+allowed-tools: Bash, Read, Write, Edit, Glob, Grep
+description: "レビューエージェントを起動し実装をレビューする"
+---
+
+# /team-review
+
+レビューエージェントを起動し、実装をレビューしてください。
+
+## 手順
+
+### 1. 前提チェック
+
+- `.team/team.json` が存在すること
+- `CMUX_SOCKET_PATH` が設定されていること
+- `cmux` コマンドが利用可能であること
+
+### 2. レビュー対象の収集
+
+#### git diff の収集
+
+```bash
+# team-init 以降の変更（.team/ 内を除く）
+git diff HEAD~10 --stat -- . ':!.team'
+# または、最新の実装以降の diff
+git diff --stat -- . ':!.team'
+```
+
+変更がない場合: 「レビュー対象の変更がありません」と表示して終了
+
+#### diff の詳細取得
+
+```bash
+git diff HEAD~10 -- . ':!.team'
+```
+
+差分が大きい場合（500 行超）:
+- ファイルごとに分割してレビューエージェントに割り当てる
+- 最大 3 名のレビュアーに分担
+
+#### コンテキスト収集
+
+- `.team/specs/requirements.md` — 要件定義
+- `.team/specs/design.md` — 設計ドキュメント
+- `.team/output/implementer-*.md` — 実装エージェントの出力（あれば）
+- `.team/tasks/` — オープンタスク（`task-state.json` で状態確認）
+
+### 3. レビュアー数の決定
+
+- 差分が小さい（200 行以下）: 1 名
+- 差分が中程度（200-500 行）: 2 名（ファイルを分担）
+- 差分が大きい（500 行超）: 3 名（モジュール・機能ごとに分担）
+
+### 4. プロンプト生成
+
+各レビュアーに対して:
+
+1. `~/.claude/skills/cmux-team/templates/common-header.md` を読み込み
+2. `~/.claude/skills/cmux-team/templates/reviewer.md` を読み込み
+3. テンプレート変数を置換:
+   - `{{ROLE_ID}}` → `reviewer-impl` (1 名の場合) または `reviewer-impl-N`
+   - `{{TASK_DESCRIPTION}}` → "実装レビュー: <担当範囲>"
+   - `{{OUTPUT_FILE}}` → `.team/output/reviewer-impl.md` (または `-N`)
+   - `{{ARTIFACT_CONTENT}}` → 担当する git diff の内容
+   - `{{REQUIREMENTS_CONTENT}}` → requirements.md の内容
+   - `{{DESIGN_CONTENT}}` → design.md の内容
+   - `{{COMMON_HEADER}}` → 展開済み共通ヘッダー
+4. `.team/prompts/reviewer-impl.md` (または `-N`) に書き出す
+
+### 5. レビューエージェント起動
+
+サブエージェントの配置は cmux-team SKILL.md §5 参照。
+
+```bash
+# Conductor と同じワークスペース内で分割（デフォルト）
+cmux new-split right  # → surface:S
+# 複数レビュアーの場合は追加分割
+# cmux new-split right  # → surface:S2
+```
+
+各レビュアーに対して（**1体ずつ、cmux-team SKILL.md §2.1 の手順に従う**）:
+
+```bash
+# a. ステータス設定
+cmux set-status reviewer-impl "spawning" --icon sparkle --color "#ffcc00"
+
+# c. Claude 起動（シェルコマンドは \n で送信可能）
+cmux send --surface surface:S --workspace workspace:W "claude --dangerously-skip-permissions\n"
+
+# d. 起動完了を待つ（Trust確認 or ❯ プロンプトをポーリング、SKILL.md §2.1 Step 5 参照）
+for i in $(seq 1 10); do
+  SCREEN=$(cmux read-screen --surface surface:S --workspace workspace:W 2>&1)
+  if echo "$SCREEN" | grep -q "Yes, I trust"; then
+    cmux send-key --surface surface:S --workspace workspace:W "return"
+    sleep 5; break
+  elif echo "$SCREEN" | grep -q '❯'; then
+    break
+  fi
+  sleep 3
+done
+
+# e. プロンプト送信（単一行指示 → \n で送信可能）
+cmux send --surface surface:S --workspace workspace:W ".team/prompts/reviewer-impl.md を読んで指示に従ってください。\n"
+
+# f. 送信確認 + ステータス更新
+sleep 3
+SCREEN=$(cmux read-screen --surface surface:S --workspace workspace:W 2>&1)
+if ! echo "$SCREEN" | grep -qE '(Stewing|Thinking|Reading|Searching|Ideating)'; then
+  cmux send-key --surface surface:S --workspace workspace:W "return"
+  sleep 3
+fi
+cmux set-status reviewer-impl "running" --icon hammer --color "#0099ff"
+```
+
+### 6. 完了待機
+
+```bash
+cmux set-progress 0.0 --label "Review: in progress..."
+cmux wait-for "reviewer-impl-done" --timeout 300
+# 複数の場合:
+# cmux wait-for "reviewer-impl-1-done" --timeout 300
+# cmux wait-for "reviewer-impl-2-done" --timeout 300
+```
+
+### 7. レビュー結果の収集と統合
+
+1. `.team/output/reviewer-impl*.md` を読み込む
+2. 結果を統合:
+
+```markdown
+## レビュー結果サマリー
+
+### Verdict: <Approved / Changes Requested>
+
+### 指摘事項
+
+#### Critical
+- [C-1] <指摘内容> (ファイル: path/to/file.ext)
+
+#### Major
+- [M-1] <指摘内容> (ファイル: path/to/file.ext)
+
+#### Minor
+- [m-1] <指摘内容> (ファイル: path/to/file.ext)
+
+#### Suggestion
+- [S-1] <提案内容>
+
+### 要件カバレッジ
+- REQ-001: ✅ / ❌
+- REQ-002: ✅ / ❌
+```
+
+### 8. タスク作成
+
+Critical/Major の指摘に対して自動的にタスクを作成:
+
+各指摘に対して `.team/tasks/NNN-<slug>.md` を作成:
+```markdown
+---
+id: NNN
+title: "[Review] <指摘タイトル>"
+type: finding
+raised_by: reviewer-impl
+created_at: <ISO 8601>
+severity: critical|major
+---
+
+## Context
+レビューで検出された指摘事項。
+
+## Details
+<指摘の詳細>
+
+## Affected Files
+- <ファイルパス>
+
+## Recommendation
+<修正方法の提案>
+```
+
+### 9. 結果提示とアクション
+
+ユーザーに統合結果を提示し:
+
+- **Approved**: 「レビュー合格です。次のステップに進めます。」
+- **Changes Requested**:
+  - Critical/Major 指摘の一覧を強調表示
+  - 「指摘事項を修正しますか？」
+    - **手動で修正**: ユーザーが自分で対応
+    - **実装エージェントで修正**: `/team-impl` で修正タスクとして実行
+    - **再レビュー**: 修正後に `/team-review` を再実行
+
+### 10. クリーンアップと状態更新
+
+- レビュアーペインを閉じる
+- （team.json は daemon が自動更新する）
+- プログレスバーをクリア
+
+### 11. 次のステップ案内
+
+```
+レビューが完了しました。
+
+指摘: Critical X件 / Major Y件 / Minor Z件 / Suggestion W件
+タスク作成: N件
+
+次のステップ:
+  /team-impl    → 指摘事項を修正（Changes Requested の場合）
+  /team-test    → テストフェーズに進む（Approved の場合）
+  /team-task    → タスクの確認・管理
+```
+
+## 引数
+
+なし
+
+## エラーハンドリング
+
+- git diff が取得できない場合: git リポジトリでない、またはコミットがない場合のエラーメッセージ
+- レビュアーがタイムアウトした場合: 画面を確認し対処を提案
+- 差分が非常に大きい場合（2000 行超）: 警告を表示し、範囲を絞るか確認