nicobailon/pi-subagents

Pi extension for async subagent delegation with truncation, artifacts, and session sharing

pi‑subagents とは？

pi‑subagents は Pi AI アシスタントプラットフォームの拡張機能で、単一の Pi セッションがフォーカスされた子エージェント（サブエージェントと呼ばれる）を生成して、特定の作業を処理できるようにします。AI「アシスタント」に専門家チームを与えると考えてください。フォアグラウンドまたはバックグラウンドで実行し、結果を報告し、自然言語コマンドでオーケストレーションできます。

コアアイデア

親セッション（Pi） が会話の制御を維持します。
サブエージェントを依頼すると（例：「reviewer を使ってこの diff をレビューして」）、Pi は専用の役割を持つ子 Pi セッションを起動します。
子エージェントはタスク（コードレビュー、調査、実装など）を実行し、結果を親に返します。
子エージェントはインライン（フォアグラウンド）で実行でき、出力をチャットに直接ストリーミングするか、分離（バックグラウンド）で実行でき、メインの会話に戻った後も継続します。

組み込みエージェント（すぐに使用可能）

エージェント	典型的な用途
scout	コードベースをすばやくマッピング：関連ファイル、エントリポイント、データフロー、リスクをリストアップ。
researcher	ウェブやドキュメントから情報を取得し、ソースを引用し、簡潔なブリーフを作成。
evidence‑auditor	調査の主張が実際に引用されたソースによって裏付けられているかを検証。
worker	実装を実行：ファイルを編集し、検証を実行し、推測する前に承認を求める。
reviewer	コードレビュー – 正確性、テストカバレッジ、エッジケース、シンプルさをチェックし、必要に応じて小さな修正を適用。
oracle	計画に対するセカンドオピニオンを提供し、前提に挑戦し、盲点を指摘（ファイル編集なし）。
delegate	親セッションと同様に動作する軽量な汎用ヘルパー。

操作方法

設定ファイルを書いたり、特別なスラッシュコマンドを学ぶ必要はありません。パッケージをインストールした後：

pi install npm:pi-subagents

自然言語で Pi に依頼するだけです。例：

Use reviewer to review this diff.
Ask oracle for a second opinion on my current plan.
Run parallel reviewers: one for correctness, one for tests, and one for unnecessary complexity. Pi がどのサブエージェントを起動するか、フォアグラウンドかバックグラウンドで実行するか、結果をどのように構成するかを決定します。

典型的なワークフロー

目標	自然言語プロンプト
セカンドオピニオンを得る	`Ask oracle to review this plan and challenge assumptions.`
難しいバグを解決する	`Use oracle to investigate this bug before we edit.`
プルリクエストの diff をレビューする	`Use reviewer to review this diff.`
複数のレビューアを同時に実行する	`Run reviewers for correctness, tests, and cleanup.`
複数のアドバイザー間で議論を行う	`Use /council with model‑based advisors to compare this decision.`
実装してから検証する	`Implement this, then review it.`
継続的なレビューループ	`Run a review loop on this change with a max of 3 rounds.`
バックグラウンド実行	`Run this in the background.`
実行中の作業を検査する	`Show me the current async runs.`

拡張機能には、これらのパターンを繰り返し使用するための /parallel‑review や /review‑loop などのショートカットコマンドも付属しています。

可観測性と制御

フォアグラウンド実行 はチャットでライブストリーミングされます。
バックグラウンド実行 はエディタの下の永続的な FleetView パネルに表示されます。/subagents‑fleet でライブインスペクタを開き、子エージェントを閲覧、トランスクリプトを読んだり、誘導したり、停止したりできます。
組み込みのウォッチドッグは、敵対的な変更を監視し、LSP チェックを強制し、単一の実行が生成できるサブエージェントの数を制限できます（maxSubagentSpawnsPerRun、デフォルト 64）。
ヘルパーコマンド：
- /subagents‑doctor – サブエージェントシステムのヘルスチェックを実行。
- /subagents‑guide [topic] – workflows、agents、observability などのトピックに関するドキュメントを表示。

設定

すべての設定は config.json（または環境変数）にあります。重要な設定項目は次のとおりです：

toolActivation – subagent ツールをすぐにロードするか、モデルのプロンプトキャッシュが更新された後にのみロードするかを制御。
bg_wait – 親がステータスを報告する前にバックグラウンドの子を待機する時間。
maxSubagentSpawnsPerRun – 単一のオーケストレーションが作成できる論理的な子の総数を制限。

詳細はリポジトリの docs/ フォルダにあります。

誰が恩恵を受けるか？

開発者 エディタを離れずに AI 支援のコードレビュー、自動実装、調査を希望する人。
チーム 再現可能で監査可能な AI ワークフローが必要なチーム（例：「レビューアを実行し、次にワーカーを実行し、さらに別のレビューアを実行」）。
Pi プラットフォームのパワーユーザー 複数の専門 AI エージェントを単一の一貫したパイプラインに構成したい人。

クイックスタートチェックリスト

拡張機能をインストール：pi install npm:pi-subagents。
Pi チャットで、Use reviewer to review this diff. のような自然言語リクエストを入力。
会話で結果がストリーミングされるのを見るか、バックグラウンドのフリートビューを検査。
/subagents‑guide を使用して、より高度なワークフローと設定オプションを探索。

結論： pi‑subagents は、単一の Pi AI アシスタントを、目的に特化したエージェントの小さなオーケストレーションされたチームに変え、複雑なタスク（コードレビュー、調査、実装、監査）を実行、監視、繰り返しやすくします。