Claude Code Harness：把代理编码变成有门禁的交付循環
Claude Code 專用開發工具 - 透過自主計畫工作審查週期實現高品質開發。
秒懂
- 它是什麼？
- Claude Code Harness 用 spec、计划、任務账本、独立审查和發布前檢查约束代理编码過程。
- 適合誰用？
- 它适合需要审计代理改動、并愿意先批准计划的工程团队，不适合把代理当作无确認自動部署器的场景。先运行 `/harness-setup`，再用 `/harness-plan Improve the README onboarding flow` 檢查生成的 spec.md、Plans.md、未知项和停止条件是否符合你的倉庫。
- 可以商用嗎？
- 可以。MIT 是寬鬆授權：你可以使用、修改並販售以它為基礎的軟體，只需保留著作權與授權聲明。
- 還在維護嗎？
- 有在維護。儲存庫最近一次提交在 2 天前。
- 用什麼語言寫的？
- 主要是 Shell（依據 GitHub 的語言統計）。
以上回答依據專案的 GitHub 資料（最近同步於 2026年9月14日）與我們的分析，不構成法律意見。
開源專案深度解析
它解决的问題 · chachamaru127-claude-code-harness-deep-analysis
代理编码容易偏离轨道：计划消失在聊天中，截止日期下测試变得可选，审查發生在合并之後，發布證據從记忆中重構。此工具用一条可重復的路径取代這种做法：编寫规格，仅實現已批准的切片，驗證，独立审查，打包證據。它不会讓模型更聪明，而是修復模型周围的流程和边界，使其在模型变化時仍能工作。README 声称其中的每条声明都经過 CI 门禁机器核驗，檢查组件是否接通、任務账本是否一致，以及發布的二進制文件能否從源码重建。只有门禁證明某功能可达，它才会出現。
五個動词技能 · chachamaru127-claude-code-harness-deep-analysis
表面很小：计划、工作、审查、同步、發布，外加一次性的設置。/harness-plan 將意图轉化為 spec.md 和 Plans.md，包含范围、驗收標准、依赖、未知项和停止条件。/harness-work 實現一個已批准的任務或整個计划，并在任務需要時添加测試。/harness-review 與實現分開檢查结果，重大發現会阻止完成。/harness-sync 比较计划與實際實現并报告偏差。/harness-release 只將已驗證的證據打包到变更日志、標签和發布中。每個阶段為下一阶段留下所需材料。
安全層 · chachamaru127-claude-code-harness-deep-analysis
每次工具調用都由 Go 引擎在运行前裁决，而不是事後审查。两層强度不同：运行時地板包含五個类别，直接拒绝，无法通過配置、環境变量或權限模式覆盖；它覆盖计费、網络出口、秘密讀取、生產部署和任務工作树之外的破坏。護欄 R01-R15 具有明确的裁决，部分可按项目配置。确認移到计划時間：风险操作被收集并一次性询问，批准带有過期時間、任務范围和使用限制。每次停止都记錄在 JSONL 日志中；命令文本從不寫入，只寫哈希和长度，對于秘密讀取和计费連這些也不寫。
面向非工程师的决策界面 · chachamaru127-claude-code-harness-deep-analysis
三個单屏 HTML 视图讓非工程师赞助者无需阅讀代码即可判断。计划简报在计划定稿時显示理解、选项、风险和驗收標准。進度视图在工作期間显示進行中、待办和已完成的數量以及漂移警报，自動重新生成。驗收视图在發布前显示每個標准的通過/失败，以及發布、等待或拒绝。這些被记錄為判断進度的界面，而非正确性的保證。
以 claude-code-harness 為對象，請從 main 分支的 README 與專案配置開始，實際執行文件列出的命令，記錄輸入、輸出和錯誤位置。素材未說明的效能、相容性與維運承諾不在本文推論範圍內。
安装路線和工具層級 · chachamaru127-claude-code-harness-deep-analysis
四条安装路線受支持：Claude Code 通過插件市场，Codex CLI 通過 scripts/setup-codex.sh --user，Cursor 通過 scripts/setup-cursor.sh，Grok 通過 scripts/setup-grok.sh。其他工具列在较低層級：Codex 應用為候选，OpenCode 為內部兼容，Hermes Agent 和 GitHub Copilot CLI 為候选，Antigravity CLI 為未來/不支持。README 明确這些層級是严格的：一個宿主只有在通過自己的 H1-H8 檢查後才会升級。對于現有用户，bin/harness doctor --migration-report 会盘点過期的缓存和状态，而不删除任何內容。
高級能力和要求 · chachamaru127-claude-code-harness-deep-analysis
在基本路径之外，README 列出了 Breezing（规划者/批评者/工人团队執行）、通過脚本的 Codex 伴随审查、用于项目范围记忆的 harness-mem、OpenCode 引导以及默認關閉的實驗性自動批准標志。受支持的 Claude 路径要求 Claude Code v2.1+ 和具有寫访问權限的倉庫。Go 原生護欄引擎不需要 Node.js。项目采用 MIT 許可，授予使用、復制、修改、合并、發布、分發、再許可和销售的權利，但除許可所述外不提供任何保證或責任。README 未建立生產结果或独立安全审计。
針對 Chachamaru127/claude-code-harness，還要核對 README 中的安裝入口、必要依賴、設定檔名稱與命令列參數，並把一次成功流程和一次預期失敗流程分開保存。若 claude-code-harness 會產生建置目錄、資料庫、終端介面或網路服務，觀察其實際檔案與日誌，而不是只依標題判斷功能完整度。這個核對只適用於 claude-code-harness 的文件和程式流程。
Claude Code Harness：把代理编码变成有门禁的交付循環 的專案核對記錄。這裡只談 chachamaru127-claude-code-harness-deep-analysis 自身的文件、目錄、命令與輸出。採用前先閱讀 README，確認安裝方式、啟動入口、設定檔、依賴與資料位置，再依文件建立最小測試。測試 Claude Code Harness：把代理编码变成有门禁的交付循環 時，應保存實際輸入、終端輸出、產生檔案、服務埠號與錯誤訊息，並逐項對照 README 的描述。若命令需要環境變數或外部服務，記下變數名稱與服務狀態；若功能涉及網路、權限、資料庫、終端介面或編譯器，也要分開記錄成功和失敗結果。素材沒有說明的效能、相容版本、支援期限與安全保證，不應由標題或宣傳語推導。授權條款只說明 chachamaru127-claude-code-harness-deep-analysis 的程式碼如何使用、修改與分發，實際部署仍須檢查依賴和配置。升級時對照 chachamaru127-claude-code-harness-deep-analysis 的版本標籤、README 變更與測試輸出，確認既有輸入仍得到預期結果。這些觀察點都指向 chachamaru127-claude-code-harness-deep-analysis，不是泛用的選型清單。
Claude Code Harness：把代理编码变成有门禁的交付循環 的專案核對記錄。這裡只談 chachamaru127-claude-code-harness-deep-analysis 自身的文件、目錄、命令與輸出。採用前先閱讀 README，確認安裝方式、啟動入口、設定檔、依賴與資料位置，再依文件建立最小測試。測試 Claude Code Harness：把代理编码变成有门禁的交付循環 時，應保存實際輸入、終端輸出、產生檔案、服務埠號與錯誤訊息，並逐項對照 README 的描述。若命令需要環境變數或外部服務，記下變數名稱與服務狀態；若功能涉及網路、權限、資料庫、終端介面或編譯器，也要分開記錄成功和失敗結果。素材沒有說明的效能、相容版本、支援期限與安全保證，不應由標題或宣傳語推導。授權條款只說明 chachamaru127-claude-code-harness-deep-analysis 的程式碼如何使用、修改與分發，實際部署仍須檢查依賴和配置。升級時對照 chachamaru127-claude-code-harness-deep-analysis 的版本標籤、README 變更與測試輸出，確認既有輸入仍得到預期結果。這些觀察點都指向 chachamaru127-claude-code-harness-deep-analysis，不是泛用的選型清單。 Claude Code Harness：把代理编码变成有门禁的交付循環 的下一次核對仍應使用同一個命令與同一個配置鍵，避免把不同流程混在一起。
編輯結論
它适合需要审计代理改動、并愿意先批准计划的工程团队，不适合把代理当作无确認自動部署器的场景。先运行 `/harness-setup`，再用 `/harness-plan Improve the README onboarding flow` 檢查生成的 spec.md、Plans.md、未知项和停止条件是否符合你的倉庫。
社群筆記