mcpField
C
claude-runner

claude-runner

github.com/robsonrungエージェントワークフロー275 回インストール3 日前に更新
リポジトリ

claude-runner について

claude-runnerは、ローカルの認証済みClaude CLIで範囲を限定したプロンプトを実行するスキルです。モデルやツールなどの制約を指定でき、応答モデルの証拠やフォールバック状態も確認します。

主な機能

  1. 01ローカルClaude CLIでプロンプトを実行
  2. 02承認済みモデルスナップショットを選択
  3. 03ツール設定と実行制限を適用
  4. 04モデルの証跡と結果状態を確認

活用シーン

  1. 01制約付きClaude分析タスクの実行
  2. 02CLIリクエストを処理したモデルの確認
  3. 03保存済みオプションで呼び出しを継続

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/robsonrung/rar-skills --skill claude-runner

インストール後、Claude Code で/claude-runnerを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
references/
command-reference.md
continuation.md
runtime-reference.md
scripts/
run_claude.py
tests/
test_run_claude.py

詳細

Claude Runner

最初に shared/references/model-preview.md を使って分岐を選択します。決定論的なチェックではモデルの選択は不要です。実際のディスパッチでは、承認済みの具体的なスナップショットを1つ使用します。ネストされた呼び出しは、そのスナップショットをそのまま使い、再解決や追加のワーカーを行いません。

ローカル CLI を通じて、呼び出し元が指定した範囲のプロンプトを実行します。共通のロール、エンベロープキー、結果の処理については shared/references/runner-common.md を参照してください。シートの忠実性を維持してください。実際に応答したプロバイダーを明示し、利用できないシートや確認できていないシートは正直に報告してください。

ネイティブルーティング

外部ルートを選ぶ前に shared/references/host-model-execution.md を読んでください。現在のホストが、必要なエフォート、分離、レシートポリシーを満たす形で、選択した Claude モデルそのものをネイティブのサブエージェントまたはタスクスレッドでディスパッチできる場合は、そのルートを使用してください。agents/openai.yaml はホスト UI のメタデータであり、ネイティブモデルをディスパッチするものではありません。

呼び出し

同じシェル呼び出し内で、読み込まれたこのスキルのディレクトリを SKILL_DIR に設定します。

SKILL_DIR="<absolute path of this skill directory>";
python3 "$SKILL_DIR/scripts/run_claude.py" "<scoped prompt>" \
  --model <approved-model-id> --effort <approved-effort> --disable-fallback --json

選択したスナップショットから、モデルとエフォートを正確にコピーします。ロール、ツールモード、レシートポリシー、制限を追加します。選択したルートがランタイム制御の場合に限り、エフォートフラグを省略します。ネストされた呼び出しでは、デフォルトを再解決せず、保存済みのオプションを使用します。この例は、ソース共有やツール権限を付与するものではありません。

ランタイムの境界

  • ローカルの認証済み claude CLI をプリントモードで使用します。権限チェックは有効なままです。
  • 分析ロールのデフォルトは repo_read_only です。このモードで使用できるのは Read、Glob、Grep のみで、カスタマイズは無効、MCP 設定は空です。--restrict-tools はこのプロファイルを強制し、--tool-profile no_tools はすべてのツールを削除します。--allow-write または --tool-profile write を指定すると、呼び出し元の権限の範囲内で通常の書き込み権限が維持されます。
  • プロンプトとファイルのコンテキストは、設定済みのプロバイダーに送信される場合があります。ベアモードは認証動作を変更するため、使用前にランタイムリファレンスを読んでください。
  • ラッパーはモデルとエフォートを転送します。プライマリアシスタントイベントは、実際に処理したモデルの証拠になります。要求されたラベル、初期化時のラベル、合成イベント、使用状況のラベルは証拠になりません。証拠がない場合は未確認のまま扱い、プライマリ ID が競合する場合や、モデルが指定したモデルと完全一致しない場合は、結果を失敗とします。
  • 直接呼び出しでは、CLI が見つからず、かつフォールバックでも制約を維持できる場合に限り、1回だけフォールバックできます。ツールプロファイルとネイティブの予算制限がある場合は、フォールバックできません。承認済みルートではフォールバックが無効になります。ネイティブセッションを継続する場合は、選択したランナーを維持する必要があります。

ネイティブのターン数、報告コスト、経過時間の制限には --max-turns、--max-budget-usd、--timeout を使用します。いずれも正の有限値でなければなりません。要求された応答の長さは目安です。

必要に応じて読み込む

  • references/command-reference.md：基本的な呼び出し以外を組み立てる場合のフラグ、例、ネイティブマッピング、戻りコード。
  • references/runtime-reference.md：ルートを設定する場合や結果を解釈する場合の、認証、フォールバック条件、設定、拡張エンベロープフィールド。
  • references/continuation.md：セッションの再開またはバックグラウンドジョブの管理時のみ参照してください。

結果

agent_message とラッパーのエンベロープを読みます。成功したか、実際に処理したモデルのレシート、実効ランナー／プロバイダー、フォールバックや不正な出力のステータスを確認してください。プロセスが完了しただけでは、要求したタスクが実行されたことや、指定したモデルが使われたことの証明にはなりません。呼び出し元が編集を許可した場合は、変更したファイルを報告してください。

コメント

Markdown 対応