claude-code-harness：为AI编程代理建立纪律化交付闭环的开源工具

你是否曾经被AI编程代理“越写越偏”所困扰？计划消失在聊天记录里，截止日期前测试变得可选，审查往往发生在代码合并之后，发布证据只能靠记忆拼凑。claude-code-harness 的出现，正是为了彻底解决这一问题。它是一个用 Shell 和 Go 引擎构建的专用开发框架，面向 Claude Code、Codex CLI、Cursor 和 Grok 等AI编程工具，帮助开发者将“让代理写代码”变为一条可重复、有边界的路径：写规格说明 → 只实现已批准的部分 → 验证 → 独立审查 → 打包证据。本文将带你全面了解这个潜力新星。

截至收录：
claude-code-harness stars数：3058
claude-code-harness forks数：302

claude-code-harness项目目录截图

claude-code-harness核心亮点

🌟 亮点一（纪律化交付循环）：通过 plan、work、review、sync、release 五个核心命令，将AI编码纳入可控流程。每个阶段都有明确的产出物和门禁（Gate），例如 plan 产出 spec.md 和 Plans.md，需人工批准后才继续；work 按任务实现并强制测试；review 独立审查并拦截重大问题。整个过程环环相扣，杜绝“边做边飘移”。

🎯 亮点二（安全裁决层）：所有工具调用在运行前都经过一个独立的 Go 引擎裁决，而不是事后看 diff。这个安全层分为两层：不可覆盖的“运行时底线”（涵盖计费、网络出口、密钥读取、生产部署、任务目录外的销毁操作）和可配置的“护栏”（R01–R15）。即使AI自主运行，也无法绕过底线，危险操作会提前在计划阶段一次性获批，且带有过期时间、任务范围和次数限制，避免一次授权变成永久后门。

🔒 亮点三（机器验证的声明）：README 中的所有功能声明均由 CI 门禁自动验证——组件是否真正接线、任务台账是否一致、发布的二进制能否从源码重建。只有验证通过的功能才会被写入文档。“写了”不等于“能用”，这一特性让项目的可信度大幅提升，也方便社区审计。

🧩 亮点四（多工具与多决策界面）：不绑定单一AI工具，现已支持 Claude Code、Codex CLI、Cursor、Grok，并持续评估更多候选工具。同时为“非工程师”赞助者提供了三个单页 HTML 界面：Plan Brief（计划简报）、Progress（进度）、Acceptance（验收），让不懂代码的业务方也能直观判断项目状态和风险。

claude-code-harness快速开始

只需几步，你就能在本地运行起 claude-code-harness：

  1. 安装（以 Claude Code 为例）：
    在 Claude Code 中执行以下插件命令：
    bash
    /plugin marketplace add Chachamaru127/claude-code-harness
    /plugin install claude-code-harness@claude-code-harness-marketplace
    /harness-setup
    harness-setup 会完成一次性的环境初始化。
  2. 运行你的第一个计划：
    bash
    /harness-plan Improve the README onboarding flow
    Harness 会自动为你生成 spec.md 和 Plans.md，你只需批准或纠正其中的范围、验收标准、依赖、未知项和停止条件。
  3. 查看项目状态：
    bash
    /harness-sync
    这条命令会对比计划与实际实现，输出漂移报告，帮助你随时掌握代理的真实进展。

claude-code-harness应用场景

场景一：AI辅助开发流程规范化：开发团队可以使用 Harness 将AI编程纳入企业级流程，从需求定义到代码合并再到发布，每一步都有据可查。由于工具调用在运行前被审查，团队不必担心代理在后台执行危险操作（如推送主分支、强制推送或读取密钥）。计划阶段的批量确认机制也能避免运行中途反复打断，适合敏捷团队快速迭代。

场景二：高质量交付与独立审查：项目要求“代码合并前必须独立验证”时，/harness-review 会从实现之外的角度审查结果，重大问题会阻止完成。/harness-release 仅将经过验证的证据打包到 CHANGELOG、标签和发布产物中，确保证明材料可追溯。对于审计要求严格的金融、医疗或基础软件项目，这一套机制能显著降低交付风险。

用户案例：目前，Harness 已为 Claude Code、Codex CLI、Cursor、Grok 等主流AI编程工具提供成熟的集成方案，并已在实际开源项目中用于改善 AI 编码工作流。其分层安全模型和“先批准后执行”的设计，尤其适合那些需要同时兼顾效率和合规的新兴AI原生团队。

claude-code-harness链接

Chachamaru127 / claude-code-harness项目地址：https://github.com/Chachamaru127/claude-code-harness

本文地址：https://www.tgoos.com/46141

声明：本站资源均整理自互联网，版权归原作者所有，仅供学习交流使用，请勿直接商用，若需商用请购买正版授权。因违规使用产生的版权及法律责任由使用者自负。部分资源可能包含水印或引流信息，请自行甄别。若链接失效可联系站长尝试补链。若侵犯您的权益，请邮件（将 # 替换为 @）至 feedback#tgoos.com，我们将及时处理删除。转载请保留原文链接，感谢支持原创。