Claude Code 太飘？这款 Harness 给它上纪律

你是不是也这样——跟 Claude Code 说”帮我做个 XX 功能”，它哗哗哗给你吐一大段代码，看着挺爽，但跑起来全是红？spec 漂在聊天里、review 全凭感觉、想发版了才发现少了测试？

苏棠最近挖到一个真正把 AI 编程从”开盲盒”变成”流水线”的项目 —— claude-code-harness，GitHub 已经 3k+ star，今天还在更新。它的核心思想就一句话：写代码前先把规格和计划钉死，然后让 AI 严格按这条流水线走。

一句话讲清楚它干啥

harness 不是给 Claude Code 加技能，是给它”上纪律”。它把 AI 编程这件事压成 5 个动词 / 5 条命令：

• /harness-plan：把你的需求翻译成 spec.md + Plans.md，列清楚 scope、验收标准、未知项、止损条件
• /harness-work：只执行你已经批准的那一段切片，TDD 优先，验收一条做一条
• /harness-review：独立审阅，major 问题直接 blocker，不放行
• /harness-sync + /harness-release：打 tag 之前先做 release preflight，证据齐全才放行

更狠的是它自带 CI 闸门：README 里吹的功能必须在 CI 跑通才算存在。”写了”≠”能用”，这句话直接焊死。

为什么说它是混搭玩法 + 效率黑科技

1. 多工具兼容——不是 Claude Code 专属，Codex CLI / Cursor / OpenCode / Grok / Hermes / GitHub Copilot CLI 都接得上，同一套 Plan→Work→Review 流程
2. 三层可视化面板——harness-plan-brief（计划摘要）、harness-progress（实时进度+漂移告警）、harness-accept（逐条验收+ship/wait/reject），非技术 PM 都能直接看
3. migration report 安全网——bin/harness doctor --migration-report 把你现有 setup 的旧插件缓存、软链、记忆文件全部清点一遍，只读不删，避免手贱搞炸
4. fail-closed 闸门——发布前检查没通过就硬卡，不允许你”差不多就行”
5. CLAUDE.md 兼容性——装好之后直接读你项目已有的指引，不会覆盖

上手 30 秒

# 1. 加市场源
claude plugin marketplace add Chachamaru127/claude-code-harness

# 2. 装插件
/plugin install claude-code-harness@claude-code-harness-marketplace

# 3. 初始化
/harness-setup

# 4. 拿个小活试水
/harness-plan 改进 README 的新手引导流程

你会看到它自动给你生成 spec.md 和 Plans.md 草稿，你点头或改一句话，然后 /harness-work 1.1.1 开始执行第一条任务。

适用场景

• 3 天以上的活：1-2 行的改动犯不上，但凡涉及多文件 / 多接口 / 跨模块，先 plan 再 work 真的能省你来回推倒的成本
• 团队协作：PM/设计能直接看 plan-brief 和 acceptance，不需要再问你”这玩意儿到底做完没”
• 追求稳的人：你受够”AI 一跑就跑偏”，又不想自己写 TDD 框架——harness 把这条纪律焊死在流程里

苏棠的小提醒

这个项目不是 vibe coding 加速器。它假设你愿意花 10 分钟把 spec 写清楚，再用 30 分钟跟 AI 一起 review。如果你只是想”一句话扔过去就要结果”，你会觉得它很烦。但凡你被”AI 给我跑偏 + 不知道哪步出问题 + release 全靠我手动验”折磨过——这就是你的解药。

GitHub 地址在这 → Chachamaru127/claude-code-harness

3k+ star，今天还在更新，黑松编程党的下一个必装件，建议先 mark 一下 🛠️

GitHub: https://github.com/Chachamaru127/claude-code-harness