pi-subagentsでPiの作業を子セッションへ分ける
nicobailon/pi-subagentsは実運用向けに使える実用的なオープンソース実装で、再利用可能な導入ルートを持つプロジェクトです。
ひと目でわかる
- これは何？
- Piから専門化した子エージェントへ非同期委譲する拡張。レビュー、調査、実装、成果物、権限、ライフサイクルをREADMEから読む。
- 誰に向いている？
- pi-subagentsは、Piの親セッションからレビューや調査を分割し、複数の子Piセッションを使いたい開発者向けです。最初は`pi install npm:pi-subagents`後にレビュー依頼を一件だけ実行し、子セッションの入力範囲、出力、保存された成果物、権限要求を確認してください。
- 商用利用できる？
- できます。MIT は寛容なライセンスで、著作権表示とライセンス表示を残せば、使用・改変・販売が可能です。
- 今もメンテナンスされている？
- されています。最後のコミットは 1 日前です。
- 何の言語で書かれている？
- 主に TypeScript です（GitHub の言語統計による）。
回答はプロジェクトの GitHub データ（最終同期：2026年9月14日）と当サイトの分析に基づくもので、法的助言ではありません。
オープンソース詳細解説
親Piと子Piの役割
READMEではPiが親セッション、subagentが固有の仕事を持つ子Piセッションです。コードレビュー、探索、実装、並列監査、保存済みワークフロー、バックグラウンドジョブなど、別の視点を必要とする作業を委譲できます。親が依頼を出すと子が作業し、結果が親へ戻ります。
前景実行は会話へ進捗が流れ、背景実行は後から確認できます。ただし拡張を入れただけで自動レビュアーが起動するわけではありません。毎回レビューさせるならプロンプトやプロジェクト指示で明示します。この境界を理解しないと、インストール後に無反応なことを不具合と誤認します。
インストール後の最初の依頼
必須の導入手順は`pi install npm:pi-subagents`だけです。設定ファイルやスラッシュコマンドを先に作らなくても、自然文で`Use reviewer to review this diff.`のように依頼できます。`oracle`へ計画の反対意見を求めたり、`scout`へコード調査と確認質問を頼んだりする例もREADMEにあります。
検証では小さな差分を用い、親の会話に委譲が発生したか、選択されたエージェント名、入力された差分の範囲、返された指摘を記録します。レビュー結果を自動的に正しいと扱わず、元のコードと照合します。日本語で依頼した場合の応答言語や、リポジトリの機密情報が子へ渡る範囲は、対象環境で確認してください。
組み込みエージェントの使い分け
拡張にはすぐ使える組み込みエージェントがあり、READMEはレビュー担当、計画への別意見、コード探索などの利用例を示しています。複数レビュアーを並列に走らせ、正しさ、テスト、不要な複雑さを個別に見る依頼も可能です。名称や役割はプロジェクトの文書で確認し、名前だけから能力を増やして解釈しません。
一つの子へ曖昧な万能依頼を渡すより、入力、観点、期待する成果物を分けた方が結果を比較しやすくなります。例えばレビューには対象コミットとテスト結果、探索には対象ディレクトリと知りたい依存関係を含めます。子の返答が短い場合は、未調査なのか問題なしなのかを親側で確認します。
モデルルーティングと上書き
READMEの機能説明には、エージェントのモデルルーティング、オーバーライド、ファジーマッチングが含まれています。これにより依頼先の名前やモデル選択を運用に合わせられますが、具体的な設定キーや利用可能なモデルは環境と文書の版に依存します。記憶で設定を書かず、リポジトリのDocumentationを参照します。
モデルを変える評価では、同じ入力、同じコミット、同じ指示を使い、出力の差だけを比較します。コスト、待ち時間、コンテキスト長、コードを外部モデルへ渡す可否を記録し、品質の印象だけで切り替えません。ファジーマッチングを使う場合は似た名前のエージェントへ誤送信されないかも確認対象です。
非同期実行とフリートの観察
背景実行は親の会話を止めずに子が処理を続け、後から結果を確認できます。READMEは実行中の作業が見える場所やフリートビュー、ライフサイクルに関わる成果物を案内しています。長い監査や複数の調査を扱う場合は、実行中、完了、失敗、停止の状態を区別して把握します。
運用テストでは同じ作業を前景と背景で一度ずつ走らせ、ログ、成果物、セッションの識別子、親への結果通知を確認します。途中で親の指示を変更したとき、子が古い前提のまま続けるのか、停止できるのかを見ます。成果物が作業ディレクトリへ書かれる場合は、意図しない変更をgit diffで検査してから採用します。
権限ゲートとワークフロー
拡張はウォッチドッグや権限ゲート、スーパーバイザー連携、`workflowScript`を扱います。便利な自動化ほど、子がファイル変更やコマンド実行を求めた際の承認境界が大切です。READMEは委譲ツールを提供するもので、導入だけで全作業が自動実行されるとは説明していません。
実運用では読み取り専用の調査から始め、書き込みや外部接続を含むワークフローを分けます。許可されたディレクトリ、実行可能なコマンド、成果物の保存場所を明示し、監査ログと変更差分を残します。MITライセンスはLICENSEで確認できますが、モデル提供者、対象リポジトリ、実行環境の機密保持条件まで決めるものではありません。
pi-subagents固有の確認として、変更のない小さな差分を`reviewer`へ渡し、親セッション、子セッション、成果物の対応を記録します。次に同じ依頼を背景実行し、完了通知と停止操作を確認します。ファイルを書き換える依頼は複製リポジトリだけで行い、`git diff`、実行コマンド、権限要求を照合してから結果を採用します。
pi-subagentsでPiの作業を子セッションへ分けるの採用判断では、対象版のREADMEにある入力と出力を固定し、担当者が同じ手順を再実行できる状態で結果を残します。動いたという記録だけでなく、失敗条件、戻し方、ライセンス確認の結果も対象プロジェクトに結び付けて管理します。
編集部の結論
pi-subagentsは、Piの親セッションからレビューや調査を分割し、複数の子Piセッションを使いたい開発者向けです。最初は`pi install npm:pi-subagents`後にレビュー依頼を一件だけ実行し、子セッションの入力範囲、出力、保存された成果物、権限要求を確認してください。自動で常時レビューが走る機能ではない点も運用手順に明記します。
コミュニティノート