claude-code-harness
SHA-256一个为 Claude Code 设计的结构化开发流程编排工具，通过“计划—实施—审查—发布”循环防止 AI 代理失控，确保代码质量和可审计性。
给 Claude Code 套上缰绳，让 AI 编码从随意聊天变成可重复的交付流水线。
核心功能
- 强制 Plan→Work→Review→Release 四阶段循环，避免 AI 代理随意发挥
- 自动生成 spec.md 和 Plans.md 作为事实来源，所有工作都基于审批后的计划
- 实施阶段强制 TDD（测试驱动开发），审查与实施分离，确保质量
- 发布前自动检查变更日志、标签边界和证据完整性
- 原生 Go 实现，无需 Node.js，轻量且跨平台
避坑指南
- •该项目仅适用于 Claude Code v2.1+，其他主机（如 Codex CLI、OpenCode）支持级别为内部兼容或候选，不要在生产环境期望完全相同的体验
- •/harness-work all 只能在计划明确且仓库基线已知时使用，否则可能造成混乱
- •harness-mem 是可选的跨会话记忆组件，需要单独配置并检查健康状态；未配置时不会丢失功能
- •不要直接使用 raw（如 raw codex exec）替代 Harness 提供的命令，否则无法获得结构化审查和证据打包
适用场景
- 需要高代码质量的 AI 辅助开发项目，希望避免 AI 随意编造代码或遗漏测试
- 团队协作时，需要对 AI 生成的代码进行结构化审批和审计
详细介绍
Claude Code Harness 是一个轻量级、基于 Go 原生的开发流程编排工具，专为 Claude Code 及兼容的 AI 编码助手设计。它强制实施“计划→实施→审查→发布”的可重复循环，避免原始 AI 代理常见的“计划遗失、测试可选、审查滞后”等问题。核心机制是将 spec.md 和 Plans.md 作为事实来源，要求对批准的任务执行 TDD（测试驱动开发），将审查与实施分离，并只打包经过验证的证据用于 PR 或发布。支持多主机部署（Claude Code、Codex CLI、OpenCode 等）通过插件或脚本。与 Superpowers、Hermes Agent 等更重的工具相比，Harness 更轻量（仅 5 个核心动词命令）、不依赖 Node.js，并遵循“未观察到不等于不存在”的严谨原则，避免 AI 凭空捏造数据。适合追求可预测性和可审计性的个人或团队使用。
标签
快速上手
安装软件
双击下载的安装程序，按提示完成安装
在 Claude Code 中运行 /plugin marketplace add Chachamaru127/claude-code-harness
运行 /plugin install claude-code-harness@claude-code-harness-marketplace
运行 /harness-setup 完成初始化
- 在 Claude Code 中运行 /plugin marketplace add Chachamaru127/claude-code-harness
- 运行 /plugin install claude-code-harness@claude-code-harness-marketplace
- 运行 /harness-setup 完成初始化
最新更新
## 🎯 What's Changed for You
**Breezing benchmark dependency alerts are closed, and the same lockfile is now guarded in CI.**
### Before → After
| Before | After |
|--------|-------|
| GitHub showed 10 open Dependabot alerts for the tracked Breezing benchmark `agent-eval` lockfile. | Open Dependabot alerts are now `0`, with patched dependency ranges locked and verified. |
| Benchmark dry-run scripts referenced stale `task-01`-`task-10` fixtures. | Dry-run scripts now target the tracked `task-11`-`task-20` eval fixtures and pass locally/CI. |
| The benchmark lockfile was not covered by scoped Dependabot npm updates or the main validation audit gate. | Dependabot and `validate-plugin` now check the benchmark lockfile path explicitly. |
## Fixed
- Closed the remaining Breezing benchmark `agent-eval` lockfile alerts by updating `@vercel/agent-eval`, using scoped npm overrides for patched `undici`, `minimatch`, and `uuid` ranges, and aligning benchmark dry-run task references.
## Security
- Added a scoped Dependabot npm update entry and CI audit gate for `benchmarks/breezing-bench/agent-eval`.
---
🤖 Generated with [Claude Code](https://claude.com/claude-code)
已提供 SHA-256 校验码，下载后可自行核对文件完整性
该校验码提取自 GitHub 官方 Release 页面
SHA256 校验码
f938a7f58cb7b10ff902d2969b9d8b198811e8e5f87ead178e39d758adef810e该校验码提取自 GitHub Release 页面，下载后请自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
在 Claude Code 中运行 /plugin remove claude-code-harness 删除插件，然后手动删除项目目录下由 harness 生成的 .harness、spec.md、Plans.md 等文件（可选）。如果使用了 harness-mem，请运行 bin/harness doctor --migration-report 检查残留后再清理。
无额外依赖
下载后即可直接使用，无需安装其他运行环境