tintinweb/pi-subagents

解決する課題

pi-subagents は、自律型サブエージェントの作成とオーケストレーションを可能にする pi プラットフォーム用の拡張機能です。単一モデルの会話を超えて、バックグラウンドで実行したり、並列で動作したり、決定論的なスクリプトワークフローに従ったりする専用エージェントを生成することで、メインエージェントの認知的負荷を軽減し、複雑なタスクの効率を向上させます。

仕組み

このプロジェクトは、親エージェントが Agent ツールを使用して子エージェントを生成できるシステムを実装しています。これらのサブエージェントには、独自のシステムプロンプト、モデル、ツール制限を設定できます。この拡張機能は、いくつかのオーケストレーション手法を提供します。

• 自律的生成: エージェントはバックグラウンド（非同期）またはフォアグラウンド（ブロッキング）で実行できます。
• スクリプトワークフロー: SubagentWorkflow ツールを使用すると、parallel()、pipeline()、phase() などのパターンを使用して、決定論的な JavaScript スクリプトで複数のエージェントをオーケストレーションできます。
• エージェントメンション: ユーザーはプロンプトで @handle 構文を使用してエージェントと直接やり取りでき、メインの会話にターンを追加することなく、エージェントの誘導、再開、開始が可能です。
• 分離: エージェントは分離された Git worktrees 内で実行でき、完了時に変更がブランチにコミットされることを保証します。

対象ユーザー

複雑で多段階の AI エージェントワークフローを管理する必要がある pi プラットフォームの開発者。特に、自律型サブエージェントとバックグラウンドタスク管理を備えた「Claude Code スタイル」の体験を求める方に最適です。

ハイライト

• Claude Code スタイル UI: アクティブなエージェント用の永続ウィジェット、実行中のサブエージェントをナビゲートする「FleetView」、ライブ会話ビューアが含まれています。
• 並列実行: 設定可能な並列制限とスマートグループ通知を備えたバックグラウンドエージェントをサポートします。
• ネストされたサブエージェント: エージェントが（オプトインで）独自の子エージェントを生成することを許可し、深さ制限付きの委任が可能です。
• 決定論的ワークフロー: Claude Code の Workflow ツールと互換性のある JavaScript ベースのオーケストレーションスクリプトをサポートします。
• スケジューリング: cron 式、間隔、または単発のタイムスタンプに基づいてエージェントを実行するように登録できます。
• 拡張機能間 RPC: 他の pi 拡張機能がサブエージェントを生成、停止、参加させることを可能にするイベントバス。