clawteam-dev

ClawTeam のローカル開発

このスキルは、ClawTeam リポジトリ内で ClawTeam を開発および検証するためのものです。 ClawTeam 自体の変更、ローカルでの動作テスト、または現在のチェックアウトを使ったマルチエージェントのワークフローの検証を行う場合に使用してください。

開発環境のセットアップ

ブートストラップスクリプトを使って、ローカル開発環境を統一してください。

bash scripts/bootstrap_clawteam_dev.sh

このスクリプトは、このスキルフォルダー内の scripts/bootstrap_clawteam_dev.sh にあります。

このスクリプトでは、以下の処理が行われます。

• ~/.clawteam-venv に固定の uv 環境を作成します
• 現在のリポジトリを開発用依存関係とともに、その環境にインストールします
• ~/.local/bin/clawteam が固定環境を指すように設定します
• ~/.bashrc に clawteam() シェル関数のブロックを追加します

完了後は、以下を実行してください。

source ~/.bashrc
clawteam --version

マシン上の異なる Python 環境で同じ clawteam コマンドを使いたい場合は、このブートストラップを使用してください。

プロジェクトスキルの接続

別のローカルプロジェクトの ./.agents および ./.claude ディレクトリから、このリポジトリのローカル ClawTeam スキルを直接使えるようにするには、以下を実行してください。

bash scripts/link_local_clawteam_skills.sh /path/to/project

このスクリプトは、このスキルフォルダー内の scripts/link_local_clawteam_skills.sh にあります。

これにより、対象プロジェクト内に次のシンボリックリンクが作成されます。

• ./.agents/skills/clawteam
• ./.claude/skills/clawteam

これらのリンクを更新または再作成する場合は、同じスクリプトを再度実行してください。

一般的な用途

• コード変更後に、対象を絞ったローカル検証を実行する
• spawn／board／task／inbox／harness のバグを再現する
• tmux またはサブプロセスモードで実際の CLI をスモークテストする
• 現在のリポジトリのチェックアウトから、ClawTeam のワークフローをエンドツーエンドで確認する

高速な検証

変更を検証できる、最小限のテストを優先してください。

ruff check clawteam/ tests/
pytest tests/<target_file>.py -q

変更が複数のモジュールにまたがる場合に限り、より広範囲なテストを実行してください。

pytest tests/test_cli_commands.py -q
pytest tests/test_spawn_backends.py -q
pytest tests/test_harness.py tests/test_event_bus.py -q

前提条件

• clawteam コマンドが利用可能であること
• tmux が利用可能であること
• 実際のワーカーを起動する場合は、claude や codex など、サポート対象の CLI エージェントが利用可能であること
• worktree の分離やローカルソースの変更をテストする場合は、カレントディレクトリが ClawTeam の git リポジトリであること

ローカルスモークテスト

ユニットテストではなく、実際のマルチエージェントワークフローを確認する必要がある場合に使用してください。

clawteam team spawn-team dev-smoke -d "Local ClawTeam smoke test" -n leader
clawteam task create dev-smoke "Smoke test worker" -o worker1 -p high
clawteam spawn --team dev-smoke --agent-name worker1 --task "Report your status to leader and mark the task completed when done."
clawteam board show dev-smoke
clawteam task wait dev-smoke --timeout 300 --poll-interval 5

harness の動作を特に検証する場合は、以下を実行してください。

clawteam harness conduct dev-harness \
  --goal "Create a small implementation plan and execute it with one worker" \
  --cli codex \
  --agents 1

クリーンアップ

可能な限り、場当たり的にディレクトリを想定するのではなく、実際の ClawTeam コマンドを使用してください。

clawteam team cleanup dev-smoke
clawteam team cleanup dev-harness

クラッシュした tmux セッションや worktree が残っている場合は、状態を確認してから明示的にクリーンアップしてください。

開発ルール

• 状態ファイルを直接編集するのではなく、clawteam コマンドを優先してください。
• 変更が spawn／runtime／workflow の境界をまたぐ場合を除き、広範なエンドツーエンドテストより、対象を絞ったテストを優先してください。
• 問題が spawn レイヤーにあると決めつける前に、board、task wait、team status を使って動作を確認してください。
• エージェントの連携をテストする場合は、まずチームを小規模にし、リーダー 1 人とワーカー 1～2 人で始めてください。
• 下位レベルの task／spawn／inbox の経路がすでに動作している場合に限り、harness テストや swarm 全体のテストに進んでください。