Chachamaru127/claude-code-harness

Claude Code Dedicated Development Harness - Achieving High-Quality Development Through an Autonomous Plan→Work→Review Cycle

Claude Code Harness – 有纪律的 AI 驱动开发循环

是什么 – 一个 Go 原生插件，允许 Claude Code（以及兼容的代理如 Codex、Cursor、Grok）接管完整的软件开发周期：规划、实现、审查、同步和发布。您只需提供高层次意图（例如 “改进 README 入门流程”）；该工具将生成具体规格（spec.md、Plans.md），运行选定的 AI 模型编写代码，验证输出，并最终打包一个干净的发布版本。每个步骤都需经过明确的人类审批，因此该工具是安全导向的编排层，而非完全自主的编码器。

核心概念与工作流

步骤	命令	作用	人类关卡
规划	`/harness‑plan <意图>`	生成规格（`spec.md`）和任务列表（`Plans.md`），描述范围、验收标准、依赖项、未知项和停止条件。	在任何代码生成前，您必须批准或编辑生成的合同。
工作	`/harness‑work [任务	all]`	使用适当的模型（普通工作使用 Claude Sonnet 5，高吞吐量“Breezing”使用 GPT‑5.6 Luna 等）执行已批准的任务。支持单人或团队执行，运行必要测试，并在可配置的修正次数内迭代。
审查	`/harness‑review`	运行独立的审查模型（Claude Sonnet 5，xhigh 努力级别）检查变更，运行额外验证，并报告主要发现。	阻止完成的发现必须在继续前解决。
同步	`/harness‑sync`	比较当前仓库状态与原始计划，标记偏差，并更新计划状态。	您需确认是否需要重新规划。
发布	`/harness‑release`	将验证过的变更打包为变更日志，创建 git 标签，并发布。	预飞行检查清单必须通过；否则发布将中止。

循环可通过 /harness‑loop 自动重复，循环执行 work-review-sync，直到满足停止条件（如最大循环次数、无待执行任务）。

安全与防护机制

双层保护 – 轻量级 Go 引擎强制执行 运行时底线（5 个类别：计费、网络出站、密钥读取、生产部署、破坏性操作），并提供更丰富的 防护规则（R01–R16），可拒绝、警告或要求确认高风险操作。
明确审批 – 需要预审批的操作（如推送到 main、写入受保护路径）在计划阶段记录，包含有效期、范围和使用限制。
未知处理 – 模型未见过的数据标记为 unknown 而非虚构，防止无声幻觉。
会话名单 – 当多个代理在同一个仓库工作时，本地名单显示活跃会话，并支持经验证的消息传递，可选内容验证。
非工程师视图 – 三个单页 HTML 仪表板（计划概要、进度、接受度）让利益相关者无需阅读代码即可审查工作。

安装（30 秒）

# 在 Claude Code（或任何支持的宿主内）
claude /plugin marketplace add Chachamaru127/claude-code-harness
/plugin install claude-code-harness@claude-code-harness-marketplace
/harness-setup

对于其他宿主（Codex CLI、Cursor、Grok），请参阅 README 中的“按工具安装”表格——每个工具都提供一个小型 shell 脚本，用于添加插件并运行 /harness‑setup。

典型用例

定义意图 – /harness‑plan "修复重复订单；同一订单只能存储一次。"
批准规格 – 审查 spec.md/Plans.md 并确认验收标准。
运行实现 – /harness‑work all（或使用 /harness‑work 3 指定单个任务）。
自动测试与修正 – 模型运行测试，报告失败，并在配置的修正次数内迭代。
独立审查 – /harness‑review 生成独立审计；任何重大发现将阻止发布。
同步与发布 – /harness‑sync 确保计划与现实一致，然后 /harness‑release 创建带生成变更日志的带标签发布。

模型路由与努力级别

角色	默认模型	努力
困难决策 / 建议	Claude Fable 5.1	high
普通实现	Claude Sonnet 5	medium
专用审查员	Claude Sonnet 5	xhigh
Codex 工作与审查	GPT-6 astra / GPT-5.6 luna	xhigh / max

您可以手动覆盖任意角色或努力级别；工具会尊重您的明确选择。

项目状态与社区

许可证 – MIT
支持宿主 – Claude Code（v2.1+）、Codex CLI、Cursor、Grok（均标记为支持）。其他工具列为候选或未来。
文档 – 详尽文档涵盖入门、安装路径、安全对等性、模型策略及高级功能（Breezing、harness‑loop、harness‑mem 等）。
贡献 – 欢迎提交问题和 PR；请参阅 CONTRIBUTING.md。

TL;DR

Claude Code Harness 是一个以安全为先的编排插件，允许您利用基于 Claude 的代理（或兼容的 LLM）在仓库中规划、编码、验证并发布变更，每个主要步骤均需人类审查。它提供清晰、可重复的循环、强大的防护机制和多工具支持，使 AI 增强开发既强大又可控。