hoangnb24/repository-harness

解決的問題

編碼代理經常由於缺乏明確的約束、模糊的權威文件以及長期任務中的進度遺失而失敗。repository-harness 透過將軟體儲存庫轉換為結構化的、代理就緒的工作區來解決這些問題，其中儲存庫本身作為記錄系統（system of record）而非外部資料庫發揮作用。

工作原理

它在專案中安裝一套標準化的文件檔案和腳本。這為代理建立了一個小型且穩定的進入點（透過 AGENTS.md），以及一個位於 docs/ 目錄下的權威知識圖譜（例如架構、工作流和產品行為）。對於複雜任務，它實現了一個持久的執行計畫系統，其中進度與決策記錄在 Git 追蹤的 Markdown 檔案中。它還強調透過儲存庫原生的測試進行機械驗證。

適用對象

使用 AI 編碼代理來維護和演進程式碼庫的軟體工程師和團隊，他們希望確保代理擁有正確的上下文並遵循架構規則，而無需依賴繁重的強制性工作流。

亮點

• 代理就緒的進入點：使用精簡的 AGENTS.md 來減少指令載入與漂移。
• 持久的執行計畫：提供一個在 docs/plans/ 中追蹤多工作階段或重度協作變更的系統。
• 儲存庫即真理：將所有產品行為、決策和計畫保留在儲存庫中，實現完全的可審核性。
• 機械驗證：專注於透過行為和測試來證明完成情況，而不是進行帳目記錄。
• 入職工具：包含 $onboard-repository 技能，幫助代理映射現有（brownfield）儲存庫。