代码从失控到可控 | 阿里云Qoder开源Better Harness

你是不是也踩过这些 AI 编码大坑？

下达需求清晰，AI 自信满满写完代码，结果解决的是另一个无关问题；

每次修改路径天马行空，换个同事完全复现不了操作逻辑；

代码能跑就算完工，没有完整测试、lint 校验，上线全靠人工兜底；

赶进度跳过代码审查、CI 校验，线上 bug 层出不穷；

同类问题反复踩坑，上次踩过的坑，下一个任务继续重来。

如今 Claude Code、Cursor、Qoder、Codex 等 AI 编码智能体普及，写代码速度成倍提升，但AI 工作流失控，反而拉高团队返工成本。

一款开源解决方案：Better Harness，由阿里 Qoder 团队开源，专门用来审视、诊断、优化整套 AI 编码工作流，让 AI 开发从 “快但乱” 变成 “快且稳”。

什么是 Better Harness？

一句话概括：一套面向 AI 编码智能体的工作流审计与持续改进工具。

它不只是一段简单提示词，而是三层完整体系：

工程实践层：标准化 AI 会话、项目约束、智能体自定义、闭环治理的落地规范；

评估模型层：独创「智能体工作闭环（Agent Work Loop）」五维评估框架，所有结论必须附带可追溯证据；

可运行实现层：开箱即用插件、证据收集器、可视化报告渲染器，适配主流 AI 编程工具。

核心逻辑：不只用最终代码 diff 评判 AI 好坏，而是完整复盘从接收需求到交付上线全链路，找到流程漏洞，给出可落地、带验收标准的优化方案。

五大核心痛点，它一次性解决

AI 编码失控的根源，都藏在工作流里，Better Harness 精准覆盖 5 大维度：

任务理解：解决 AI “答非所问”

很多时候 AI 写废代码，根源是没读懂项目目标、交付标准。 工具自动校验项目AGENTS.md、需求文档、设计规范是否完整，判断智能体是否清晰知晓 “做到什么程度才算完成”。

受控执行：让 AI 操作可复现

杜绝 AI 随意修改、无边界操作。 检查项目是否配置 Skill、MCP 工具、沙箱约束，确保 AI 所有代码变更走标准化、可复现执行路径，团队任何人都能追溯操作过程。

变更验证：代码能跑≠交付合格

大量团队只看代码运行结果，缺失测试、规范校验证据。 自动采集单测、lint、自动化钩子执行记录，证明每一处代码修改都经过完整验证，有据可查。

可靠交付：杜绝为赶工跳过质量卡点

AI 改代码速度太快，极易绕过代码评审、CI/CD 流程。 审计交付链路的人工审批、自动化检查、回滚预案，防止快速迭代带来线上风险。

经验沉淀：同类问题不再重复踩坑

绝大多数团队没有 AI 任务沉淀机制，踩过的坑无法复用。 自动抓取历史任务经验，沉淀可复用技能、记忆库，让下一次 AI 开发自动规避历史问题。

一键生成完整审计报告，可视化追踪优化趋势

使用门槛极低，任意支持的编辑器内输入一行指令即可启动全流程审查：

/better-harness 审查此项目的 AI 编码工作流并生成报告

报告两大核心能力

问题分级，附带完整证据报告不会给出模糊评分，所有问题全部标注证据缺口，按影响优先级排序；每条问题包含：风险影响、预期标准、明确修复范围、验收检查清单，拿来就能落地优化。

历史趋势对比，直观看到改进效果多次执行后生成历史视图，动画回放五维指标变化，清晰看见优化动作是否真正改善 AI 编码闭环，量化团队 AI 研发效能提升。

输出格式支持：HTML 完整报告、Markdown 文档、结构化 JSON 数据，Qoder 还支持专属 Canvas 可视化面板，本地文件持久留存，方便团队复盘归档。

全主流 AI 编程工具适配，快速安装上手

覆盖市面上主流编码智能体，几分钟完成部署，无需复杂改造项目：

Qoder（Desktop/CLI）

内置无需额外安装，两种使用入口：

会话内直接执行/better-harness指令；

Qoder 1.18.0+ 侧边栏 Quest 面板，一键打开 Better Harness Beta 面板。

Claude Code

# 注册市场源
/plugin marketplace add QoderAI/better-harness
# 安装插件
/plugin install better-harness@better-harness
# 新开会话执行审查指令
/better-harness 审查此项目的 AI 编码工作流并生成报告

Codex Desktop / CLI

桌面端：设置 - 插件 - 从市场添加仓库，安装插件后重启任务；

CLI 端通过 marketplace 命令添加仓库源，完成插件安装。

Cursor

暂无官方市场包，本地源码加载即可使用：

git clone https://github.com/QoderAI/better-harness.git
cursor-agent --plugin-dir /path/to/better-harness

Cursor 会话证据来自与工作区匹配的会话记录、元数据和审计日志。 覆盖范围不完整或不可用时会被明确标注。

三层开源体系，自由参与共建

项目采用 MIT 开源协议，开放三层能力，不同开发者都能参与贡献：

工作流指南与工程实践修改skills/、references/目录，补充各语言、框架 AI 开发规范；

审查模型与分析检测器迭代models/、scripts/，新增代码风险检测、智能体行为分析逻辑；

宿主适配、报告可视化新增编辑器适配器、优化 HTML/Markdown 报告样式，完善案例库。

谁适合使用 Better Harness？

团队技术负责人：统一规范 AI 编码流程，量化 AI 研发质量，降低线上故障；

后端 / 前端开发者：排查自家 AI 工具频繁翻车根源，规范本地 AI 开发习惯；

AI 工程、平台研发同学：搭建企业级智能编码平台，完善 Agent 治理体系；

开源项目维护者：统一协作 AI 行为，避免不同贡献者 AI 代码风格混乱。

总结

大模型能力持续变强，但AI 编码的核心瓶颈从来不是模型本身，而是配套的工作流治理。

Better Harness跳出 “优化 Prompt、加大上下文” 的传统思路，用可观测、可验证、可沉淀的工程化方案。

GitHub 地址：https://github.com/QoderAI/better-harness

审核编辑 黄宇