liu-zhengdong/pi-shadow-mind

解決的問題

Pi Shadow Mind 解決了主 AI 代理偏離架構標準、對代碼庫產生事實性錯誤，或在實作功能時未能維護文件的問題。透過引入專門且持續的「認知核心」，在主代理執行的同時並行審查與驗證工作，防止昂貴的錯誤。

工作原理

該系統與主代理並行運行專門的代理（Shadow Minds）。這些 Shadow 由 Markdown 檔案定義，並分配特定職責，例如架構審查或專案基礎設定。

它們根據觸發條件激活：「心跳」（主代理呼叫工具後以機率激活）或「最終回應」（主代理完成任務後激活）。激活後，Shadow 會與主代理軌跡的清理版本啟動暫時會話。然後判斷當前工作是否與其角色相關；若是，則可使用分配的工具檢查專案，並透過 report_to_main 函數將發現結果回傳給主代理。

適用對象

使用 Pi 代理框架的開發者，希望在不手動審查每一步的情況下，確保高品質的程式碼架構、準確的文件以及嚴格遵守專案限制。

亮點

• 持久角色：與暫時任務不同，Shadow Minds 是使用者定義的角色，可獨立決定何時介入。
• 可設定激活：支援機率性心跳觸發與保證的最終回應檢查。
• 細粒度工具存取：每個 Shadow 可被限制為唯讀存取，或分配特定工具以執行平行工作。
• 模型過濾：可根據設定，為不同模型分配不同的支援心智。