Chachamaru127/claude-code-harness

解決的問題

Claude Code Harness 為 AI 編碼代理（例如 Claude Code、Cursor 和 Grok）提供一個有紀律的交付循環，以防止「代理漂移」——即計畫在聊天歷史中消失，且在壓力下跳過測試或審查。它以結構化、可重複的流程取代開放式請求：撰寫規格、實現已批准的工作片段、驗證，並獨立進行審查。

如何運作

此專案透過五個核心「動詞」技能實現結構化工作流程：plan、work、review、sync 和 release。

• 規劃：將意圖轉化為 spec.md 和 Plans.md，供使用者審批。
• 實現：執行已批准的任務，強制要求 TDD（測試驅動開發）。
• 審查：對結果進行獨立於實作階段的單獨審查。
• 同步：將實際實作與原始計畫進行對比，報告漂移情況。
• 發布：將驗證過的證據打包為變更日誌和發布標籤。

為確保安全，一個 Go 原生引擎在每個工具呼叫執行前進行仲裁。這包括一個「執行時底線」，拒絕高風險操作（如讀取密鑰或生產部署），以及可配置的「防護欄」，用於控制如直接推送到 main 等操作。

適用對象

希望從「讓代理寫程式碼」轉向具備嚴格邊界與驗證門檻的專業軟體交付流程的 AI 編碼代理使用者。

亮點

• 執行前安全：在操作發生前就透過 Go 原生引擎阻止或警告高風險行為，而非事後審查。
• 跨會話通訊：提供一個名單與訊息系統，允許多個代理會話在同個倉儲中通訊並共享報告。
• 非工程師視圖：提供用於計畫摘要、進度與驗收的 HTML 界面，使非技術贊助者無需閱讀程式碼即可判斷進度。
• 多工具支援：整合支援 Claude Code、Codex CLI、Cursor 和 Grok。