pi-delegate

実装とテストをローカルの pi エージェントに委譲し、ディスパッチの規律を強制するフックを備えています。

Claude はテックリードとして、プローブ、タスクブック、受け入れスクリプト、判定 を生成します。ソースコードを書くのは pi です。

Claude は RPC プロトコルを直接話すことはありません。MCP サーバーがパイプを握っているからこそ、実行途中の pi_steer や pi_abort が可能になります。

インストール

/plugin marketplace add LarryStanley/pi-delegate
/plugin install pi-delegate@pi-delegate

両方とも Claude Code 内で実行します。最初のコマンドはこのリポジトリをプラグインマーケットプレイスとして登録し、次のコマンドはそこからプラグインをインストールします。インストールの要約に Run /reload-plugins to activate. と表示された場合は、それも実行してください。

Node ≥ 22 と、セットアップ済みの pi インストールが必要です。依存関係はコミット済みロックファイルから自動的にインストールされるため、自分で npm install する必要はありません。

後で更新するには:

/plugin marketplace update pi-delegate

公開 版の代わりに作業コピーを試すには:

claude --plugin-dir /path/to/pi-delegate

--plugin-dir コピーは、そのセッション中はインストール済みのものより優先されるため、アンインストールせずに変更をテストできます。

そのうえで /pi-delegate:setup を実行すると、初回向けガイドウォークスルーが始まります。pi とそのプロバイダを確認し、規律モードを説明してどれを選ぶかを尋ね、修正できるものは修正し、実際にツールを使い始める前に検証用のディスパッチを提案します。

Related MCP server: Claude Code Manager WAN

設定: デフォルトでは何も必要ありません

pi_dispatch はプロバイダもモデルも指定しません。pi は自身のデフォルト（~/.pi/agent/settings.json の defaultProvider / defaultModel）を使用します。つまり、あなたが pi に設定している モデルがそのままディスパッチ先になります。anthropic、openai、litellm、ollama、LM Studio、ローカル実行の OpenAI 互換サーバー（例: omlx）はいずれも同じように動作し、このプラグイン専用の設定は必要ありません。

長期的に別のモデルを固定したい場合（たとえば、対話モードの pi は別のモデルを使用し、ディスパッチ専用に安価なローカルモデルを利用するなど）は、~/.claude/pi-delegate/config.json に記述します:

{
  "provider": "ollama",
  "model": "qwen3:8b",
  "timeout_s": 1500,
  "thinking": "off",
  "tools": "read,write,edit",
  "no_context_files": true,
  "drafter_patterns": ["-draft", "_assistant", "-assistant"]
}

すべてのフィールドはオプションです。解決順序は pi_dispatch 呼び出しの引数 → このファイル → pi 自身のデフォルト の順です。

/pi-delegate:doctor は、ディスパッチが実際にどのモデルに届くかを通知し、実際に該当する 条件でのみ問題を表示します。

以下のデフォルト値は、推測ではなく計測に基づいています

オーバー、pi_dispatch 呼び出し内で直接指定します（thinking、tools、no_context_files、append_system_prompt、provider、model、timeout_s）。

--mode rpc、--session-id、--no-skills、--no-extensions は構造的なものなのでオーバーライドできません。また、--no-session は意図的に決して渡されません（渡さないことでセッションがディスク上に保存され、pi_transcript が読み取る対象になります）。

モード

モードの切替は /pi-delegate:mode <mode> で行います。状態は ~/.claude/pi-delegate/modes.json に保存され、プロジェクトごとに保持されます。「既存のプロダクトコード」とは、プロジェクトルートの src/ 配下にすでに存在するソースファイルがそれに当たります。tasks/、scripts/、docs/、markdown、設定ファイル、そして新規作成ファイルはすべて通過できます。

strict は規律のガードレールであり、強制ではありません。フックは Write|Edit にのみ配線されているため、同じファイルを Bash で編集する経路（sed -i、ヒアドキュメント、python - <<EOF など）は一切検知されません。回避手段は常に存在します。すなわち、故意のワークアラウンドではなく、あなたが自分でそのファイルを触ってしまう習慣を防ぐためのものです。

手動で1回だけ編集（プローブ）を入れたい場合は、先に /pi-delegate:probe を実行して一回限りのバイパスを取得してください。

MCP ツール

ディスパッチの仕組み

MCP サーバーのアクティベーションはセッション全体にわたるため、実行途中でも pi 子プロセスの stdin に steer を送り届けることができます。また、実行が終わったと判断するのは（子プロセスではなく）MCP サーバーだからです。

既知のギャップ

pi_stats は、判定にすでに含まれている tokens と duration_s のみを返します。仕様 §5 の get_session_stats パススルー（cost / context の使用量を含む）はまだ実装されていません。

ドキュメント

開発

npm test                    # node --test, no external dependencies
claude plugin validate .

fixtures/fake-pi.mjs は pi --mode rpc の代役をします。注意してください。このファイルは意図的に test/ の外に置かれています。node --test は **/test/**/*.{cjs,mjs,js} の配下にあるファイルすべてをテスト ファイルとして扱うため、test/ 内に置くと、常に成功する偽テストが 1 つ紛れ込むことになります。