hoangnb24/repository-harness

解決的問題

程式碼代理經常因缺乏明確意圖、缺少權威文件，以及在面對模糊情況時傾向於自行發明產品政策而陷入困境。repository-harness 透過將軟體倉儲轉化為結構化、代理就緒的工作區，強調基於證據的變更與明確的決策邊界，解決此問題。

工作原理

該工具將倉儲協定與安全更新器安裝至目標專案中。它建立一組核心檔案——包括一個緊湊的 AGENTS.md 入口點、文件地圖，以及產品決策與執行計畫的結構——以引導代理。它定義特定的請求工作流程：只讀請求以證據作答，有限變更需附帶證明實施，複雜變更則要求在 docs/plans/active/ 中提供持久的計畫。

適用對象

使用 AI 程式碼代理，並希望確保代理遵循倉儲的權威文件、避免推測性政策的創造，並保持決策與進展的持久記錄的開發者。

特色亮點

• 代理就緒結構： 提供緊湊的入口點與可導航的地圖，幫助代理理解倉儲。
• 安全維護： 包含版本化的二進位更新器，使用三向合併保留本地修改，並以事務方式處理衝突。
• 明確的決策邊界： 當存在模糊性時，強制代理在進行重大產品變更前停止。
• 不變性強制： 提供可選技能，用於編碼不變性，並支援對既有倉儲（brownfield repositories）進行顯式接入。