Gentleman-Programming/gentle-pi

解決的問題

許多 AI 編碼代理的失敗並非由於模型的智慧不足，而是因為操作上的紀律缺失。常見問題包括在需求尚未明確時就直接進入程式碼、在聊天記錄中遺失架構決策、產生過大的拉取請求，以及忽視測試。gentle-pi 透過強制執行工程嚴謹性與結構化工作流程，將 Pi 編碼代理轉化為受控的開發環境。

工作原理

它在 Pi 中安裝了一個稱為 el Gentleman 的「資深架構師」操作層。此層引入規範驅動開發（SDD）與 OpenSpec，確保大型或高風險變更必須遵循初始化、設計與驗證的嚴格流程。系統根據複雜度路由工作：小規模修改保持內聯處理，上下文密集的探索任務委派給專注的子代理，而架構變更則觸發 SDD 流程。

為確保品質，它實作了嚴格的 TDD（測試驅動開發）支援，要求記錄完整的 RED → GREEN → TRIANGULATE → REFACTOR 循環證據。同時整合了經過驗證的原生執行環境，阻止破壞性 shell 命令並保護敏感檔案路徑。

適用對象

希望超越簡單的聊天式編碼，邁向具備可審查工作單元與架構防護機制的嚴謹、專業工程環境的 Pi 編碼代理使用者。

主要亮點

• 規範驅動開發（SDD）： 提供結構化的階段代理鏈（初始化、設計、任務、驗證等），用於處理複雜變更。
• 子代理編排： 透過將探索與實作任務委派給專業子代理，保持父會話輕量化。
• uma 技能發現註冊表： 維護專案與使用者技能註冊表，確保任務由合適的專業能力執行。
• 嚴格的 TDD 證據： 當專案設定要求時，強制記錄測試驅動開發週期。
• 執行時安全： 包含經過驗證的原生執行環境，可阻止破壞性命令與敏感路徑存取。