Claude Code スキル

MCPプロトコル(Model Context Protocol)経由でClaude Codeを制御します。このスキルは、永続的なセッション、エージェントチーム、高度なツール制御を含む、openclaw エージェント向けClaude Codeの全機能を解放します。

⚡ クイックスタート

# プロジェクト用の永続的なClaudeセッションを開始
claude-code-skill session-start myproject -d ~/project \
  --permission-mode plan \
  --allowed-tools "Bash,Read,Edit,Write,Glob,Grep" \
  --max-budget 2.00

# 複雑なタスクを送信(Claudeが自動的にツールを使用)
claude-code-skill session-send myproject "Find all TODO comments and create GitHub issues" --stream

# 進捗を確認
claude-code-skill session-status myproject

🎯 このスキルをいつ使うか

永続的なセッションを使用する場合:

• ✅ 複数のツール呼び出しを必要とする多段階タスク
• ✅ 反復的な開発(コード作成 → テスト → 修正 → 繰り返し)
• ✅ 完全なコンテキストが必要な長い会話
• ✅ エージェントが自律的に動作する必要がある
• ✅ ストリーミング型リアルタイムフィードバックが必要

直接MCPツールを使用する場合:

• ✅ 単一コマンド実行
• ✅ 素早いファイル読み書き
• ✅ 1回限りの検索
• ✅ 操作間でコンテキストが不要

📚 コマンドリファレンス

基本的なMCP操作

# Claude Code MCPに接続
claude-code-skill connect
claude-code-skill status
claude-code-skill tools

# 直接ツール呼び出し(永続的なセッションなし)
claude-code-skill bash "npm test"
claude-code-skill read /path/to/file.ts
claude-code-skill glob "**/*.ts" -p ~/project
claude-code-skill grep "TODO" -p ~/project -c
claude-code-skill call Write -a '{"file_path":"/tmp/test.txt","content":"Hello"}'

# 切断
claude-code-skill disconnect

永続的なセッション(エージェントループ)

セッションの開始

# 基本的な開始
claude-code-skill session-start myproject -d ~/project

# カスタムAPIエンドポイント(Gemini/GPTプロキシ用)
claude-code-skill session-start gemini-task -d ~/project \
  --base-url http://127.0.0.1:8082 \
  --model gemini-2.0-flash

# パーミッションモード付き(plan = 変更を適用前にプレビュー)
claude-code-skill session-start review -d ~/project --permission-mode plan

# ツールホワイトリスト付き(これらのツールは自動承認)
claude-code-skill session-start safe -d ~/project \
  --allowed-tools "Bash(git:*),Read,Glob,Grep"

# 予算制限付き
claude-code-skill session-start limited -d ~/project --max-budget 1.50

# 完全な設定
claude-code-skill session-start advanced -d ~/project \
  --permission-mode acceptEdits \
  --allowed-tools "Bash,Read,Edit,Write" \
  --disallowed-tools "Task" \
  --max-budget 5.00 \
  --model claude-opus-4-5 \
  --append-system-prompt "Always write tests" \
  --add-dir "/tmp,/var/log"

パーミッションモード:

モード	説明
acceptEdits	ファイル編集を自動承認(デフォルト)
plan	適用前に変更をプレビュー
default	各操作について確認
bypassPermissions	すべてのプロンプトをスキップ(危険!)
delegate	親に決定を委任
dontAsk	決して確認しない、デフォルトで拒否

メッセージの送信

# 基本的な送信(完了までブロック)
claude-code-skill session-send myproject "Write unit tests for auth.ts"

# ストリーミング(リアルタイムで進捗を表示)
claude-code-skill session-send myproject "Refactor this module" --stream

# カスタムタイムアウト付き
claude-code-skill session-send myproject "Run all tests" -t 300000

セッションの管理

# アクティブセッションをリスト表示
claude-code-skill session-list

# 詳細なステータスを取得
claude-code-skill session-status myproject

# 会話履歴を表示
claude-code-skill session-history myproject -n 50

# 一時停止と再開
claude-code-skill session-pause myproject
claude-code-skill session-resume-paused myproject

# セッションをフォーク(実験用ブランチを作成)
claude-code-skill session-fork myproject myproject-experiment

# 停止
claude-code-skill session-stop myproject

# 失敗したセッションを再開
claude-code-skill session-restart myproject

セッション履歴と検索

# すべてのClaude Codeセッションを参照
claude-code-skill sessions -n 20

# プロジェクトでセッションを検索
claude-code-skill session-search --project ~/myapp

# 時間で検索
claude-code-skill session-search --since "2h"
claude-code-skill session-search --since "2024-02-01"

# クエリで検索
claude-code-skill session-search "bug fix"

# 過去のセッションを再開
claude-code-skill resume <session-id> "Continue where we left off" -d ~/project

バッチ操作

# 複数ファイルを一度に読み込む
claude-code-skill batch-read "src/**/*.ts" "tests/**/*.test.ts" -p ~/project

🤝 エージェントチーム機能

複雑なタスクに協力する複数のClaudeエージェントをデプロイします。

基本的なエージェントチーム

# エージェントのチームを定義
claude-code-skill session-start team-project -d ~/project \
  --agents '{
    "architect": {
      "description": "Designs system architecture",
      "prompt": "You are a senior software architect. Design scalable, maintainable systems."
    },
    "developer": {
      "description": "Implements features",
      "prompt": "You are a full-stack developer. Write clean, tested code."
    },
    "reviewer": {
      "description": "Reviews code quality",
      "prompt": "You are a code reviewer. Check for bugs, style issues, and improvements."
    }
  }' \
  --agent architect

# 会話の途中でエージェントを切り替え
claude-code-skill session-send team-project "Design the authentication system"
# (architect が応答)

claude-code-skill session-send team-project "@developer implement the design"
# (developer エージェントが引き継ぎ)

claude-code-skill session-send team-project "@reviewer review the implementation"
# (reviewer エージェントが引き継ぎ)

事前設定されたチームテンプレート

# コードレビューチーム
claude-code-skill session-start review -d ~/project \
  --agents '{
    "security": {"prompt": "Focus on security vulnerabilities"},
    "performance": {"prompt": "Focus on performance issues"},
    "quality": {"prompt": "Focus on code quality and maintainability"}
  }' \
  --agent security

# フルスタックチーム
claude-code-skill session-start fullstack -d ~/project \
  --agents '{
    "frontend": {"prompt": "React/TypeScript frontend specialist"},
    "backend": {"prompt": "Node.js/Express backend specialist"},
    "database": {"prompt": "PostgreSQL/Redis database specialist"}
  }' \
  --agent frontend

🔧 高度な機能

ツール制御

# パターン付きで特定のツールを許可
--allowed-tools "Bash(git:*,npm:*),Read,Edit"

# 危険な操作を拒否
--disallowed-tools "Bash(rm:*,sudo:*),Write(/etc/*)"

# 特定のツールセットに制限
--tools "Read,Glob,Grep"

# すべてのツールを無効化
--tools ""

システムプロンプト

# システムプロンプトを完全に置き換え
--system-prompt "You are a Python expert. Always use type hints."

# 既存のプロンプトに追加
--append-system-prompt "Always run tests after changes."

セッション管理

# フォーク付きで再開(ブランチを作成)
--resume <session-id> --fork-session

# セッション用カスタムUUIDを使用
--session-id "550e8400-e29b-41d4-a716-446655440000"

# 追加の作業ディレクトリを追加
--add-dir "/var/log,/tmp/workspace"

マルチモデルサポート(プロキシ)

--base-url を使用してリクエストをプロキシ経由でルーティングし、他のモデル(Gemini、GPT)でClaude Codeを実行できます:

# Gemini経由でclaude-code-proxyを使用
claude-code-skill session-start gemini-task -d ~/project \
  --base-url http://127.0.0.1:8082 \
  --model claude-3-5-sonnet-20241022  # プロキシがGeminiにマップ

# プロキシ経由でGPTを使用
claude-code-skill session-start gpt-task -d ~/project \
  --base-url http://127.0.0.1:8082 \
  --model claude-3-haiku-20240307  # プロキシがGPTにマップ

注: ポート8082で実行中の claude-code-proxy と適切に設定されたAPIキーが必要です。

# プロキシを開始
cd ~/clawd/claude-code-proxy && source .venv/bin/activate
uvicorn server:app --host 127.0.0.1 --port 8082

🎓 ベストプラクティス

OpenClawエージェント向け

1. 複数段階のタスクには常に永続的なセッションを使用

   # ❌ 悪い例: 複数の切断/再接続サイクル
   claude-code-skill bash "step1"
   claude-code-skill bash "step2"
   
   # ✅ 良い例: 単一の永続的なセッション
   claude-code-skill session-start task -d ~/project
   claude-code-skill session-send task "Do step1 then step2"
   

2. 長時間実行されるタスクには --stream を使用

   claude-code-skill session-send task "Run full test suite" --stream
   

3. 安全性のため予算制限を設定

   --max-budget 2.00  # API使用料$2後に停止
   

4. 重大な変更にはプランモードを使用

   --permission-mode plan  # 適用前にプレビュー
   

5. 実験の前にフォーク

   claude-code-skill session-fork main experimental
   claude-code-skill session-send experimental "Try risky refactor"
   

エラー回復

# セッションが失敗した場合:
claude-code-skill session-status myproject  # 何が起きたか確認
claude-code-skill session-history myproject -n 20  # 最近のイベントを表示
claude-code-skill session-restart myproject  # 最後の良好な状態から再開

# ゼロから開始する必要がある場合:
claude-code-skill session-stop myproject
claude-code-skill session-start myproject -d ~/project --resume <old-session-id>

🏗️ アーキテクチャ

openclaw agent
    ↓
claude-code-skill CLI (このツール)
    ↓ HTTP
sasha-doctor API (:18795)
    ↓ MCP
claude mcp serve (Claude Code)
    ↓
Your files & tools

🔌 利用可能なツール(MCP経由)

すべてのClaude Codeツールにアクセス可能:

ツール	説明
Bash	シェルコマンドを実行
Read	ファイル内容を読み込む
Write	ファイルを作成/上書き
Edit	文字列置換でファイルを編集
Glob	パターンでファイルを検索
Grep	ファイル内容を検索
Task	サブエージェントを起動
WebFetch	Webコンテンツをフェッチ
WebSearch	Webを検索
Git*	Git操作
AskUserQuestion	インタラクティブなプロンプト
...	その他10以上

📊 例

例1: コードレビュー

claude-code-skill session-start review -d ~/myapp \
  --permission-mode plan \
  --agents '{"security":{"prompt":"Focus on security"},"quality":{"prompt":"Focus on quality"}}' \
  --agent security

claude-code-skill session-send review \
  "Review all TypeScript files in src/, check for security issues and code quality problems" \
  --stream

例2: 自動テスト

claude-code-skill session-start test -d ~/myapp \
  --allowed-tools "Bash(npm:*,git:*),Read,Write" \
  --max-budget 1.00

claude-code-skill session-send test \
  "Find all untested functions, write unit tests, run tests, fix failures"

例3: マルチエージェントデバッグ

claude-code-skill session-start debug -d ~/myapp \
  --agents '{
    "detective": {"prompt": "Find the root cause of bugs"},
    "fixer": {"prompt": "Implement fixes"},
    "tester": {"prompt": "Verify fixes work"}
  }' \
  --agent detective

claude-code-skill session-send debug "We have a memory leak in the API server" --stream
# detectiveが調査し、その後fixerに引き継ぎ、最後にtesterに引き継ぎ

🔗 OpenClawとの統合

openclawが複雑なコーディングタスクを実行する必要がある場合:

# openclaw エージェントコンテキスト内から:
openclaw skills run claude-code-skill -- session-start task -d ~/project
openclaw skills run claude-code-skill -- session-send task "Implement feature X" --stream
openclaw skills run claude-code-skill -- session-status task

またはsasha-doctor HTTP API経由でスキルをプログラム的に使用(TOOLS.mdセクション3を参照)。

📖 関連項目

• TOOLS.md セクション3 - 完全なHTTP APIドキュメント
• sasha-doctor エンドポイント - バックエンド統合の詳細
• Claude Codeドキュメント - 公式Claude Codeドキュメント(qmdツール経由でクエリ)