القائمة
cmux-team のヘルプ・リファレンス（読み取り専用）。使い方の説明、概念の解説、 CLI コマンドリファレンス、トラブルシューティングを提供する。 Triggers: 「cmux-team の使い方」「〜とは」「ヘルプ」「help」「how to」等の 質問・解説リクエスト。操作の実行自体は cmux-team スキルが担当。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Use when orchestrating multi-agent development via cmux. Triggers: .team/ directory exists, user says "team", "spawn agents", "parallel", "sub-agent", or any /team-* command is invoked. Provides: agent spawning, monitoring, result collection, synchronization protocols.
Use when investigating another cmux-team project (e.g. ~/git/mado, ~/git/Dear) from this repository. Triggers: ユーザーが「mado で〜」「Dear で〜」「~/git/<別プロジェクト> で〜」のように 別リポジトリの不具合・挙動を質問した場合、もしくは manager.log / trace DB の相関分析、 特定 surface の挙動調査を求められた場合。 Provides: 対象リポジトリ特定 → ログ収集 → trace DB 検索 → surface 直接参照 → 時系列相関 の 5 ステップ手順。 hook_signals テーブル（T216）と cmux-team trace-hooks サブコマンド（T217）による hook 受信の事後追跡もカバーする。 対象プロジェクトの .team/ は読み取り専用で扱い、書き込みは行わない。
cmux-team のメトリクス解析・cohort 比較・介入評価・複数 task 横断トレンド・ trace DB 探索を DuckDB SQL で行うスキル。Triggers: 「メトリクス解析」 「cohort 比較」「介入評価」「baseline 比較」「複数 task の傾向」「時系列 trend」 「trace DB から〜」「DuckDB で〜」「§11 spec の SQL を実行」等の発言。 per-task 履歴の分析は trace-task skill を使う（per-task 履歴 = trace-task / 複数 task・時系列・cohort = 本 skill）。
Use when reading GitHub issues / PRs (github.com or GitHub Enterprise) from the current project. Triggers: mention of an issue/PR number (e.g. "#272", "issue 272", "PR #42"), user asks to run `gh issue`, `gh pr`, `ghe issue`, `ghe pr`, wants to see review / comment status, or asks "show me open issues / review requests / recent closed PRs". Use `cmux-team issue` / `cmux-team pr` / `cmux-team gh` instead of invoking `gh` directly for READ operations — the local SQLite cache avoids rate limit exhaustion. Writing (create / comment / close / merge / review) still goes through `gh`.
タスクのセッション履歴を分析するスキル。 Triggers: 「T141 を分析」「タスクの履歴を見せて」「セッション履歴」 「trace task」「タスクのログ」「何が起きたか確認」等の発言。
Use when synchronizing docs/ and README with the current implementation state. Triggers: user says "docs を同期", "ドキュメント更新", "仕様書更新", "README 更新", "sync docs", or /docs-sync command is invoked. Provides: git log analysis, task-based diff detection, docs/spec/ + README.md / README.ja.md update.
| name | cmux-team-guide |
| description | cmux-team のヘルプ・リファレンス（読み取り専用）。使い方の説明、概念の解説、 CLI コマンドリファレンス、トラブルシューティングを提供する。 Triggers: 「cmux-team の使い方」「〜とは」「ヘルプ」「help」「how to」等の 質問・解説リクエスト。操作の実行自体は cmux-team スキルが担当。 |
cmux のターミナルマルチプレクサ機能を活用し、Claude Code の複数セッションを協調させて開発タスクを自律的に遂行するマルチエージェントオーケストレーションツール。
4層アーキテクチャ:
[ユーザー] ↔ [Master] → [Manager (daemon)] → [Conductor (常駐)] → [Agent (実作業)]
| 層 | 責務 |
|---|---|
| Master | ユーザー対話。タスク作成・進捗報告。作業はしない |
| Manager | TypeScript daemon。タスク検出 → Conductor に割り当て → 完了検出 → ログ記録 |
| Conductor | 常駐 Claude セッション。タスクを自律実行。git worktree で隔離。Agent を起動・監視 |
| Agent | 実作業（実装・テスト・リサーチ等）。完了したら停止 |
設計原則: 上位が下位を pull 型で監視（push 報告に依存しない）。各層は自分の仕事だけをする。全作業は git worktree で隔離され main は常に安全。
全てのタスクは .worktrees/<taskRunId>/ 内で実行される。main ブランチは常に安全。
git worktree list で確認、git worktree remove <path> --force で削除前提: cmux がインストール済み、Claude Code が利用可能（Claude Max 推奨）。
# インストール
npm install -g @hummer98/cmux-team
# 起動（cmux 内で実行）
cmux-team start
# → daemon 起動 + Master spawn + 3 Conductor 配置
# → 固定2x2レイアウトが構築される
# 停止は不要（cmux 終了で daemon も自動停止。手動停止は `kill <pid>` で）
レイアウト（固定2x2）:
[Manager|Master] | [Conductor-1]
[Conductor-2 ] | [Conductor-3]
ライフサイクル: draft → ready → assigned → closed/aborted
deleted: draft/ready から delete-task で遷移archived: closed から /team-archive で遷移# タスク作成（draft で作成、ready にすると Conductor に自動割り当て）
cmux-team create-task --title "機能Xを追加" --status draft --body "説明文"
# タスクを実行可能にする
cmux-team update-task --task-id 42 --status ready
# タスククローズ（Conductor が自動実行、手動も可）
cmux-team close-task --task-id 42 --journal "完了サマリー"
# タスク中止
cmux-team abort-task --task-id 42 --journal "理由"
# 実行中タスクの再実行（assigned を ready に戻す）
cmux-team restart-task --task-id 42
# タスク削除（draft/ready のみ）
cmux-team delete-task --task-id 42 --journal "理由"
オプション:
--depends-on 40,41 で指定。依存タスクが全て closed になるまで実行されない--base-branch develop で指定可能（デフォルトは main）重要: タスクファイル（.team/tasks/）への直接編集は禁止。必ず CLI を使うこと。
| コマンド | 説明 |
|---|---|
cmux-team start | daemon 起動 + Master spawn + レイアウト構築（レイアウト消失時は自己修復。T286） |
cmux-team status | ステータス表示 |
cmux-team create-task | タスク作成（--title, --status, --body, --priority, --depends-on, --base-branch, --run-after-all） |
cmux-team update-task | タスク更新（--task-id, --status, --title, --body, --depends-on） |
cmux-team close-task | タスククローズ（--task-id, --journal, --force） |
cmux-team abort-task | タスク中止（--task-id, --journal） |
cmux-team restart-task | assigned / aborted タスクの Conductor セッションを再起動（status を ready に戻し worktree / sessionId 等の割り当て情報をクリア、T204 で aborted からの再開にも対応）（--task-id, --journal） |
cmux-team delete-task | タスク削除（--task-id, --journal） |
cmux-team spawn-agent | Agent 起動（--conductor-surface, --role, --prompt or --prompt-file） |
cmux-team agents | 稼働中エージェント一覧 |
cmux-team kill-agent | Agent 終了（--surface） |
cmux-team trace | API トレース検索（--task, --search, --show, --conductor, --role, --limit） |
cmux-team trace-hooks | hook シグナル履歴検索（--type, --surface, --task-run, --limit（デフォルト 50）, --json）。T217 |
cmux-team artifacts | アーティファクト管理（サブコマンド: add, show, open, search。オプション: --validate） |
cmux-team metrics | タスク lifecycle / tool call / token の集計サマリ（--since <range>, --group-by day, --format csv）。サブコマンド: snapshot / compare / health / query（DuckDB ad-hoc）。詳細は docs/spec/11-metrics.md |
cmux-team events | events stream（.team/logs/events.jsonl）を tail / filter（--follow, --types <names>, --format json|tsv）。詳細は docs/spec/10-events-stream.md |
cmux-team spawn-conductor [--resume <session-id>] [--task-prompt <path>] [--model <model>] | Conductor 用 Claude Code を起動・登録（内部用）。--resume で既存セッション復元、--task-prompt で起動時にプロンプトを CLI 引数として atomic 注入（T421/D7） |
各コマンドの詳細は cmux-team <command> --help で確認可能。
他プロジェクトを覗く（T440）: 全コマンドに --project-root <path> フラグを追加可能。読み系（status / agents / events / metrics / trace-task 等）は無条件で受理される。書き込み系（start / create-task / update-task / close-task / spawn-* / send 等）は cwd と異なる root への書き込みを confirmation gate で防ぐ。bypass は --project-root-confirm フラグまたは CMUX_TEAM_PROJECT_ROOT_CONFIRM=1 env で可能（CI / 自動化向け）。詳細は docs/spec/05-install-and-infrastructure.md の「Project root 解決」を参照。
| コマンド | 説明 |
|---|---|
/master | Master ロール再読み込み（/clear 後の復帰用） |
/team-spec | 要件を対話的にブレストし仕様を策定 |
/team-task | タスクの作成・一覧・クローズ・表示を管理 |
/team-archive | 完了タスクをアーカイブ（closed → archived） |
/artifact | 知見をアーティファクトとして構造化・保存 |
/docs-sync | docs/spec/ を実装と同期 |
cmux-team start で自動起動するフルスクリーン TUI。
表示内容:
Ctrl+R で gh sync）O でブラウザ起動。詳細は docs/spec/12-web-dashboard.md）キーボードショートカット (T435 で Vim ベースに統一):
| キー | 動作 |
|---|---|
? | ヘルプ overlay 表示（全キー一覧） |
1〜6 / Tab / gt / gp | タブ切替（Journal/Artifacts/Log/Settings/Issues/Metrics） |
↑/↓ / j/k | カーソル移動 |
gg / ge | リスト先頭 / 末尾へジャンプ（Vim chord） |
Ctrl+d / Ctrl+u | 半画面スクロール |
Enter / o | 選択アイテムを開く（Artifacts は mado or cat） |
c c | Artifacts タブ: 選択中 artifact の絶対パスを pbcopy でクリップボードコピー（500ms 以内に 2 回目の c、別キーでキャンセル、成功/失敗 toast 表示。T439） |
Ctrl+o | ブラウザで開く（Issues / Metrics） |
Ctrl+s | Issues タブで gh から再同期 |
Ctrl+r | リロード |
q | TUI 終了（daemon は続行） |
Ctrl+q | Full quit（全 surface を閉じてシャットダウン） |
Esc | キャンセル / グローバル focus に戻る |
旧キー (
T J L A I M B O/r/Q/Ctrl+R) は v.next で削除予定の deprecated alias として残置。単発gとCtrl+Gは alias なしで完全廃止（chord prefix conflict のため）。詳細は?で表示される overlay を参照。
進捗確認の真のソース:
| 情報 | 確認方法 |
|---|---|
| Manager 状態 | TUI ダッシュボードのヘッダー |
| Conductor 状態 | TUI の Conductor セクション or cmux tree |
| タスク進捗 | TUI の Tasks パネル or .team/task-state.json |
| 完了履歴 | TUI の Journal タブ or .team/logs/manager.log |
会話中の調査結果・設計判断・セッション要約を構造化して保存する機能。
cmux-team artifacts # 一覧
cmux-team artifacts show A001 # 表示
cmux-team artifacts open A001 # Markdown ビューアで開く
cmux-team artifacts search "認証" # 全文検索
cmux-team artifacts add file.md # ファイルを追加
タイプ: research, decision, session, spec, report
保存先: .team/artifacts/Axxx-<slug>.md
Markdown viewer の解決順 (T439): CMUX_TEAM_MD_VIEWER env → mado（yamamoto/mado、Electrobun ベース GUI viewer。検出時は detached 起動して即 return）→ cat（TUI を一時停止）。dashboard の Artifacts タブから Enter でも同じ経路。pbcopy で絶対パスをクリップボードにコピーしたい場合は c c chord を使う。
スラッシュコマンド /artifact でも作成・表示可能。
| 問題 | 対処 |
|---|---|
| Trust 確認が表示される | 初回起動時に自動承認されるが、タイミングにより手動 Enter が必要な場合あり |
| API レート制限 | Claude Max 推奨。TUI にレート制限使用率が表示される。90% 超で新規割り当て一時停止 |
| Conductor がクラッシュ | Manager が検出し abort。cmux-team restart-task で再実行 |
| Agent がクラッシュ | Conductor が検出し再 spawn |
| Manager がクラッシュ | cmux-team start で再起動。assigned タスクは自動 resume |
| TUI が固まる | q で TUI 終了後に cmux-team start で再起動 |
| タスクが assigned のまま | cmux-team abort-task で中止、cmux-team restart-task で再実行 |