nicobailon/pi-messenger

解決的問題

Pi Messenger 是多個 AI 代理在不同終端中共享同一個共用資料夾時的協調層。它透過提供共享存在系統、訊息傳遞與檔案鎖定機制，防止代理之間互相干擾，讓它們能像聊天室一樣協作，而無需中央伺服器或守護程序。

工作原理

此系統完全透過共用目錄中的檔案運作，無需伺服器。它提供以下核心協調機制：

• 存在與發現：代理以主題化名稱註冊自身，並追蹤狀態（活躍、空閒、離開、卡住）與資源使用情況。
• 訊息傳遞：代理可發送直接訊息或廣播，作為對收件人的引導提示。
• 檔案預留：代理可宣告特定檔案或目錄，阻止其他代理同時編輯它們。
• 團隊編排：「團隊」系統將 PRD（產品需求文件）轉換為任務依賴圖。規劃者代理建立任務，工作者以平行波次執行，審查者驗證完成情況。
• 團隊層：可選層，新增專案特定角色、團隊憲章、持久化記憶與高風險任務的審批門檻。

適用對象

使用 Pi 編碼代理並希望協調多個代理並行處理複雜多步驟軟體工程任務的開發者。

亮點

• 無伺服器協調：使用檔案系統作為通訊媒介。
• 自主波次執行：以平行波次執行獨立任務，最大化效率。
• 動態技能獲取：工作者可按需載入領域特定知識（技能）以節省 token。
• 人機協同：人類可作為參與者加入代理網狀結構，擁有自身狀態與聊天能力。
• 卡頓檢測：自動標記長時間空閒且有未完成任務的代理。