QuintinShaw/pi-dynamic-workflows

解決的問題

解決在執行廣泛且複雜的任務（如程式碼庫全面審計、大規模重構或深度研究）時，單一代理上下文視窗的限制——這些任務過於龐大，無法透過一個提示與一次會話有效處理。

工作原理

Pi 產生一個決定性的 JavaScript 編排腳本，將高階請求分解為更小、可管理的任務。該腳本使用一組執行時全域變數來管理執行過程：

• 分發：產生多個相互隔離的子代理，可並行執行（最多同時 16 個）。
• 路由：根據任務複雜度，將任務路由至不同模型層級（small、medium、big）或特定提供者。
• 驗證：系統使用內建的 verify() 和 judgePanel() 等模式，交叉驗證多個代理的結果，再合成最終答案。
• 隔離：代理可在獨立的 git worktree 上執行，防止並行編輯時發生衝突。
• 可恢復性：工作內容被記錄在日誌中，允許使用者在中斷後恢復執行，或僅重播腳本中修改的部分，而無需為未變更的步驟浪費 token。

適用對象

使用 Pi 生態系統，需要自動化多步驟、多代理工作流程，以審計、審查或研究大量資料與程式碼的開發者與研究人員。

主要亮點

• 並行編排：支援最多 1,000 個子代理並行執行，具備高併發能力。
• 模型分層：根據成本與效能需求，在不同模型大小間動態路由。
• 日誌化恢復：支援快取感知的重播，中斷或腳本修改後避免重複 token 消耗。
• Git Worktree 隔離：透過暫時分支實現安全的並行檔案編輯。
• 內建模式：提供深度研究、對抗性審查和程式碼庫審計的預設工作流程。
• 即時監控：提供進度面板，可即時追蹤階段、token 使用量與成本。