clawteam

clawteam — ClawTeam ランタイムオペレータールーター

「今、どの ClawTeam オペレーターパケットが必要か」が実際の質問である場合に、このスキルを使います。

clawteam は、ClawTeam 固有のランタイム領域を担当します。

• チーム／タスク／受信トレイの状態
• tmux または subprocess によるワーカーの起動
• ワークスペースまたは Git ワークツリーの分離
• ボードの可視化と復旧フロー
• テンプレートの起動
• 起動動作に関連するプロバイダー／プリセット／プロファイルの設定

汎用的なマルチエージェントオーケストレーション、ボードガバナンス、軽量なサブタスクの振り分けは担当しません。

担当範囲を広げる前に、次のサポートドキュメントを読んでください。

• references/intake-packets-and-route-outs.md
• references/operator-modes-and-route-outs.md
• references/architecture.md
• references/agent-types.md
• references/use-cases.md

このスキルを使う場合

• ユーザーが明示的に clawteam と指定するか、ClawTeam のチーム／タスク／受信トレイ／ワークツリーのランタイムを明確に求めている場合
• リーダーが、明示的なタスクの所有権とメッセージの受け渡しを伴って、名前付きワーカーを調整する必要がある場合
• ユーザーが board attach、board live、board serve などの ClawTeam ボードコマンドを求めている場合
• ユーザーが ClawTeam 組み込みテンプレートの起動を求めている場合
• 起動前の ClawTeam 内でのプロバイダー／モデル／プロファイル設定が、実際の阻害要因である場合
• ワークフローが開発者向けのデリバリー、製品／運用調査、コンテンツ運用、またはゲーム制作にまたがり、かつ選択されているランタイムが ClawTeam である場合

このスキルを使わない場合

• 計画と QA を含む汎用的なマルチエージェント実装ループ → jeo、oh-my-claudecode、oh-my-codex、または oh-my-agent
• ClawTeam ランタイム外でのボード／作業キュー制御 → task-planning
• チーム／タスク／受信トレイ／ワークツリーの状態を伴わない軽量な並列サブタスク → 組み込みの委任／サブエージェント
• 計画または分解 → task-planning
• ツールの比較またはプラットフォームの調査 → survey

手順

ステップ 1：すでに手元にあるパケットから始める

references/intake-packets-and-route-outs.md を使います。

まず、リクエストを 1 つのパケットに正規化します。

clawteam_packet:
  primary_packet: manual-team | template-launch | monitor-recover | profile-setup | route-out
  backend: tmux | subprocess | unknown
  audience: developer-workflow | product-ops | marketing-content | game-production | mixed
  current_pain: ownership-split | quick-start | stuck-runtime | provider-setup | wrong-tool
  confidence: high | medium | low

主パケットは 1 つだけ選びます。

• manual-team — 明示的なチームのライフサイクル、ワーカーの役割、タスク、受信トレイ、依存関係
• template-launch — 事前構築済みの ClawTeam チームを起動して監視する
• monitor-recover — 実行中または停止中のチーム、ボード、受信トレイ、タスク、ワークスペース、またはライフサイクルの状態を調べる
• profile-setup — 起動前のプリセット／プロファイル／プロバイダー／モデル／ランタイムの設定
• route-out — リクエストが実際には ClawTeam のランタイムに関するものではない

ルール：ユーザーが本当に意味しているのが「ClawTeam」ではなく「複数のエージェント」である場合は、ただちに別の方法へ案内します。

ステップ 2：より詳しいコマンドを提示する前に、最小限のランタイムを確認する

ClawTeam が問題を解決すると決めつける前に、すでに動作しているものを確認します。

python3 --version
clawteam --help

tmux -V

# Replace with the agent CLI the user actually wants to run:
claude --version
codex --version

ルール：

1. 基盤となるエージェント CLI が単独で動作しない場合、clawteam spawn で修正できるかのように説明してはいけません。
2. 対話型ワーカーを可視化し、オペレーターがリアルタイムで制御する場合は、tmux を優先します。
3. ヘッドレス／バックグラウンド実行が実際に必要な場合に限り、subprocess を優先します。
4. プロバイダー／モデルのカスタマイズが阻害要因である場合は、大規模な起動例を示す前に profile-setup を選びます。

ステップ 3：必要最小限で役に立つコマンドパケットを返す

パケット A — manual-team

所有権と依存関係を明示したままにする必要がある場合に使います。

clawteam team spawn-team my-team -d "Build the auth module" -n leader
clawteam spawn tmux claude --team my-team --agent-name architect --task "Design the API schema"
clawteam spawn tmux codex --team my-team --agent-name tester --task "Write integration tests"
clawteam task create my-team "Design the API schema" -o architect
clawteam inbox send my-team tester "Wait for API handoff before final checks"
clawteam board attach my-team

フルスタック、調査、コンテンツ、またはゲーム制作の分担について、より詳しい例が必要な場合は、references/use-cases.md を使います。

パケット B — template-launch

組み込みテンプレートがすでに作業内容に合っている場合に使います。

clawteam template list
clawteam launch hedge-fund --team fund1 --goal "Analyze AAPL, MSFT, NVDA for Q2 2026"
clawteam board attach fund1

テンプレートが明らかに適合しない場合を除き、完全な manual-team の手順の中に埋もれさせないでください。

パケット C — monitor-recover

すでにチームが存在する場合、またはランタイムの実態を知ることが本題である場合に使います。

clawteam team discover
clawteam team status my-team
clawteam board show my-team
clawteam task list my-team --status blocked
clawteam inbox peek my-team
clawteam workspace list my-team

このパケットを使って、停止中のワーカー、ブロックされたタスク、受信トレイのアクティビティ不足、またはワークスペースのずれを調べます。

パケット D — profile-setup

ランタイム／プロバイダーの設定が実際のボトルネックである場合に使用します。

clawteam preset list
clawteam preset show moonshot-cn
clawteam preset generate-profile moonshot-cn claude --name claude-kimi
clawteam profile doctor claude
MOONSHOT_API_KEY=*** clawteam profile test claude-kimi
clawteam spawn tmux --profile claude-kimi --team my-team --agent-name researcher --task "Compare onboarding flows"

質問が本当にプロバイダー／モデル／ランタイムの設定に関するものである場合は、大規模なチームの例を示す前にこのパケットを使用します。

ステップ 4：ランタイムの実情を正直に伝える

ClawTeam 形式のワークフローでは、依然としてオペレーターによる作業が多く必要です。

該当する場合は、次の実情を伝えてください。

• tmux とワークツリー／セッションの確認は、実装の詳細ではなく、実際のワークフローの一部であることがよくあります
• 長時間実行されるワーカーの永続性は、一部のフローでは不安定な場合があります。過度に期待させないでください
• 信頼確認のプロンプト、権限設定のフロー、バックエンド固有の癖が、抽象化を介して表面化することがあります
• 実行後も手動でのクリーンアップ、マージ、ワークスペースの整理が必要な場合があります

重要な上流の注意事項：

• issue #148 では、実行中ジョブのサブプロセスパターンにおけるワーカーのキープアライブ問題が記録されています
• issue #146 では、解析されたエージェント定義／設定と、実際に適用されるランタイム動作との間にある隔たりが記録されています

汎用的なオーケストレーションポリシー、ボードのガバナンス、または軽量な組み込みの委任を求めている場合は、このスキルを拡張せず、別の選択肢を案内してください。

ステップ 5：簡潔なオペレーター向けブリーフを 1 つ返す

推奨形式：

# ClawTeam Operator Brief

## Packet
- Packet:
- Why it fits:
- Backend:

## Preconditions
- Verified:
- Missing / risky:

## Commands
1. ...
2. ...
3. ...

## Monitoring / recovery
- ...

## Caveats
- ...

## Route-outs kept out of scope
- ...

長大なコマンド一覧よりも、短く正確なパケットのほうが適しています。

例

例 1：フルスタック機能の分割

入力

ClawTeam を使って、リーダー 1 人とワーカー 2 人でフルスタック機能を分担してください。

望ましい出力の方向性

• manual-team を選ぶ
• 最初にランタイムとワーカーの CLI を確認する
• チームを作成し、ワーカーを起動し、明確なタスクを作成して、最後にボードコマンドを実行する
• 計画／レビューのポリシーはこのスキルの対象外とする

例 2：まずテンプレートを使う

入力

組み込みの ClawTeam チームを起動して、その様子を見せてください。

望ましい出力の方向性

• template-launch を選ぶ
• 必要に応じて template list を使う
• launch ... --team ... --goal ... を使う
• board attach または board serve で監視する

例 3：ランタイムの復旧

入力

ClawTeam のワーカーが最初のターンの後、いつも終了してしまいます。何を確認すればよいですか？

望ましい出力の方向性

• monitor-recover を選ぶ
• チーム、ボード、タスク、受信トレイ、ワークスペースの状態を確認する
• すべてのフローで長時間実行されるワーカーの永続性が保証されるわけではないことを伝える
• 汎用的なオーケストレーションスキルが問題を解決できるかのように装わない

例 4：適切な別の選択肢を案内する

入力

計画と QA を含む、汎用的なマルチエージェント実装ループが必要です。

望ましい出力の方向性

• route-out を選ぶ
• jeo、oh-my-claudecode、oh-my-codex、または oh-my-agent を推奨する
• clawteam は ClawTeam のランタイム／オペレーター向けのインターフェースであり、あらゆるマルチエージェントの依頼に対する汎用的な答えではないと説明する

ベストプラクティス

1. ClawTeam のコマンド群をすべて列挙するのではなく、まずパケットを 1 つ選びます。
2. ワーカーを起動する前に、基盤となるエージェント CLI とバックエンドを確認します。
3. オペレーターが状況を把握して制御できるよう、目に見える形で操作できる tmux を優先します。ヘッドレス実行が本当に必要な場合に限り、subprocess を使用します。
4. 組み込みのアーキタイプが実際に適合する場合に限り、テンプレート起動を使用します。
5. プロバイダー／プロファイルの設定は、独立した経路として扱います。
6. ワーカーの永続性と、設定が適用される際の注意事項を明示します。
7. clawteam を、オーケストレーションのルーター、計画スキル、ボードガバナンスツールと明確に区別します。
8. トリガーとなる表現が大きく変わった場合は、簡潔な説明と検索用の説明も更新します。

参考資料

• ClawTeam README
• PyPI：clawteam
• references/intake-packets-and-route-outs.md
• references/operator-modes-and-route-outs.md
• references/architecture.md
• references/agent-types.md
• references/use-cases.md