tintinweb/pi-subagents

解決的問題

pi-subagents 是 pi 平台的擴展，支援建立與編排自主子代理。它允許使用者啟動具備獨立工具、系統提示與模型的專用代理，於背景或平行處理複雜任務，從而減輕單一主代理的認知負荷。

工作原理

此擴展引入了一個 Agent 工具，主模型可使用它來啟動子代理。這些代理可在隔離的會話中執行——預設於背景執行，或阻塞主會話。使用者可透過 Markdown 檔案中的 YAML 前置元資料定義自訂代理類型，指定系統提示、模型選擇與工具限制。

關鍵編排機制包括：

• 腳本化工作流：SubagentWorkflow 工具可執行決定性的 JavaScript 腳本，透過 parallel()、pipeline() 與 phase() 等模式管理代理。
• 代理提及：於提示中使用 @handle 語法，可與代理通訊、恢復或啟動代理，而無需消耗主對話的回合數。
• FleetView：編輯器下方的可導航 UI 清單，用於監控與跳轉至即時代理對話。
• Git 隔離：支援於隔離的倉儲副本中執行代理，完成後自動將變更提交至分支。

適用對象

需要在 pi 平台上管理多個專用 AI 代理以處理複雜軟體工程任務的開發者，特別是希望獲得 Claude Code 風格的自主子代理編排體驗的使用者。

特色亮點

• 並行執行：可設定併發限制地啟動多個背景代理。
• 自訂代理類型：透過專案或全域設定檔定義具備自訂提示與工具集的專用代理。
• 決定性工作流：執行與 Claude Code 的 Workflow 工具相容的 JavaScript 編排腳本。
• 即時監控：提供持續性小工具與 FleetView，可即時追蹤 token 數量、工具活動與代理狀態。
• 執行中調控：可向正在執行的代理注入訊息，以重新導向其工作，而無需重新啟動。
• 會話恢復：透過保存完整對話上下文，可從代理中斷處繼續執行。
• 排程支援：支援 cron、間隔與一次性排程代理任務。