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。