AgwaB/pi-workflow

解決的問題

pi-workflow 提供了一種執行複雜、多階段 AI 代理工作流程的方法，這些流程可重複且具結構。它不依賴單一提示，而是允許使用者定義決定性流程——例如深度研究或程式碼審查——其中多個子代理可並行或依序工作，以達成高品質結果。

工作原理

系統將工作組織為「階段圖」，將自然語言任務透過一系列定義步驟進行處理。它使用 @agwab/pi-subagent 協調工作器，並支援多種執行模式：

• Single：針對一個子代理的單一聚焦提示。
• Foreach：動態分叉，一個代理產生項目清單，然後由獨立代理處理每個項目。
• Reduce：匯聚合成，將多個上游階段的結果合併為最終報告。
• Loop：在滿足停止條件前進行有限次重複。
• DAG：用於複雜組織結構的嵌套圖。
• Dynamic：使用控制器程式碼動態建立任務的自適應編排。

適用對象

需要自動化重複性高、高風險任務（如架構審查、規格符合性檢查、專案特定團隊流程）的 Pi 生態系統開發者與團隊。

特色亮點

• 預打包工作流程：包含 deep-research、deep-review、spec-review 和 impact-review 的預定義範本。
• 視覺化監控：內建 TUI 工作流程面板（/workflow），可檢查執行進度、深入階段、檢視任務工件。
• 可自訂：使用者可使用 workflow-guide 技能建立或調整工作流程。
• 執行設定檔：支援自訂命名的設定檔（如 low、medium、high），用於控制工作流程的執行方式。
• 自適應路由：execution-router 技能可協助判斷任務是否需要單一代理、特定工作流程或目標驗證器。