【claude-code-harness】给AI编码套上流程缰绳，告别无序漂移

作者提米哥

项目概览

Claude Code Harness 是一个为 AI 编码助手（如 Claude Code、Codex、OpenCode）提供结构化交付循环的工具。它把“告诉 AI 写代码”这种随意行为，转变为“制定规范→批准计划→实现→审查→打包证据”的重复可执行路径，解决了原始 AI agent 工作容易漂移（计划留在聊天里、测试变成可选、审查滞后、发布靠记忆重建）的问题。

核心功能与特性

  • 5 个核心命令构成完整工作流：/harness-setup 初始化项目引导和钩子；/harness-plan 将需求转化为 spec.md 和 Plans.md（含范围、验收标准、未知项、停止条件）；/harness-work 执行已批准的单个任务或范围（TDD 和验证）；/harness-review 独立审查，重大发现视为阻塞；/harness-release 打包已验证的证据，检查发布就绪。
  • 非平凡计划验证：当计划较复杂时，会通过团队/sub-agent 或人工视角对 spec/Plans 进行对齐、记忆复用、产品适应性、安全性和可实践性检查。
  • 以文件为事实源：计划、代码、测试、证据均写入文件，agent 未观察到的数据标记为 unknown，防止无中生有。
  • 多工具兼容与支持层级：明确标注 Claude Code 为 supported，Codex CLI 和 OpenCode 为 internal-compatible，Cursor、GitHub Copilot CLI 等为 candidate，Antigravity CLI 为 future/unsupported。
  • 迁移报告：现有用户可通过 bin/harness doctor --migration-report 检查旧插件缓存、重复 skill、符号链接和记忆状态，不删除任何数据。
  • 高级扩展：支持 Breezing（团队模式）、Codex companion review、OpenCode 引导、以及可选的跨会话记忆模块 harness-mem。

快速上手

在 Claude Code 中执行以下命令即可在 30 秒内完成安装：

claude
/plugin marketplace add Chachamaru127/claude-code-harness
/plugin install claude-code-harness@claude-code-harness-marketplace
/harness-setup

安装后，运行一个简单请求：

/harness-plan Improve the README onboarding flow

系统会生成 spec.md 和 Plans.md 草稿供你审批。之后可执行 /harness-work 1.1.1 进行最小任务实现，再通过 /harness-review 完成审查。

适用场景与目标用户

  • 场景：使用 AI 编码助手进行项目开发，需要确保代码质量、可追溯性和发布规范性的团队或个人。特别适合希望将 AI 生成代码纳入正式开发流程（计划→实现→测试→审查→发布）的场景。
  • 目标用户：已使用 Claude Code v2.1+ 的开发者，拥有项目仓库写权限。也适用于尝试 Codex CLI、OpenCode 等工具并希望获得类似结构化流程的进阶用户。新手可从工具导向的入门文档开始。

总结

Claude Code Harness 并非一个简单的插件，而是一套为 AI 编码引入开发纪律的方法论。它通过强制分阶段执行和独立审查，将 AI 从“随意助手”转变为“可管可控的协作者”。安装简便，命令直观，非常适合需要严格流程保障的开发环境。需要注意的是，它目前对某些工具的兼容性仍处于候选阶段，建议访问其主页获取更详细信息。

微信联系：timidamen

类似文章