一、基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 正式名称 | better-harness | GitHub 独立仓库名 |
| 作者/维护者 | QoderAI（Qoder 团队） | 官方 README / GitHub 组织页 |
| 来源链接 | https://github.com/QoderAI/better-harness | — |
| 许可证 | MIT | GitHub API |
| GitHub Stars / Forks | 1,591 / 130 | GitHub API（2026-08-05） |
| 最新版本 | v0.5.0 | npm registry（@qoder-ai/better-harness） |
| 最近提交 | 2026-08-04，非 archived 状态 | GitHub API |
| 安装方式 | 按 host 分别安装，见第十章 | 官方 README |
二、功能介绍与亮点
Better Harness 复盘“编码 agent 自身的工作环路”，拆成五维体检：任务理解、受控执行、变更验证、可靠交付、学习沉淀。
运行时启动三个独立只读证据子 agent（会话/项目工程/agent 配置资产），互不可见结论，主 agent 汇总产出问题清单——每条带证据来源、影响、修复边界与验收标准，可一键派生修复任务。文档强调“证据不足就标注，不臆测评分”。
亮点：覆盖 10 个 host 的专属适配层；能力原是 Qoder Desktop v1.18.0 内置功能，现开源为独立包（MIT）；两周内获 1,591 star、130 fork；README 中英双语。
三、适用场景
固定分类：元技能与 Agent 增强（复盘对象是 agent 自身的行为环路与配置资产，而非业务领域产出物）
适合已用 Claude Code、Codex 等 agent 做日常开发、有一定规则/技能/hook 配置但不确定是否真正生效的中高阶用户；也适合想找证据证明“改动真的验证过”的团队。
四、跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | ✅ 原生支持 | 官方 Marketplace 插件安装 |
| Codex | ✅ 原生支持 | Desktop 与 CLI 均有官方 Marketplace 安装路径 |
| OpenClaw | ❌ 不支持 | 官方 Host Adapter Matrix 未列出该 host |
| Hermes Agent | ❌ 不支持 | 同上，未出现在官方支持列表中 |
另原生支持 Qoder、Cursor、Qwen Code、GitHub Copilot、Pi、Kimi Code、WorkBuddy、Grok 共 10 个 host。
五、推荐理由
少见的把“agent 工作环路本身”当作审查对象的技能——不是编码规范，也不是多智能体编排框架，而是拿证据检验现有配置有没有生效，证据不足就标注而非下结论。两周内 1,591 star、130 fork，说明这个痛点被广泛认可。
六、评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | 创建约两周即获 1,591 star / 130 fork，星标增速在同类项目里少见；由 Qoder（有官方文档站与产品线的编程工具厂商）开源发布 |
| 可用性 | 8 | 分 host 提供各自的安装/验证/触发步骤，文档完整；单条命令即可安装，但要用透证据窗口、授权范围等概念仍需一点学习曲线，仓库近乎每日维护 |
| 安全性 | 8 | 见下方检查清单 |
| 综合 | 8.0 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① shell 命令与权限范围 | 读取本地项目证据（git 历史、agent 配置资产、会话记录），范围由证据窗口/深度参数限定；扩大到全局记忆等范围需显式 flag 授权 |
| ② 联网外发 | 未发现代码直接发起网络请求；设计上依托宿主 agent 自身完成分析，不额外外发数据 |
| ③ API key / 凭据 | 核心功能不需要额外凭据 |
| ④ 可疑指令 | 未见混淆代码或可疑指令，文档反复强调“证据不足就如实标注” |
| ⑤ 作者信誉 | Qoder 为具备官方文档站、博客与产品线的编程工具厂商，该功能是其自有产品的开源版本 |
| ⑥ License | MIT，明确 |
| ⑦ 最近维护 | 近日仍有提交，维护活跃 |
七、跟同类 Skills 相比的优势
| 技能 | 定位 | 与 better-harness 的差异 |
|---|---|---|
| superpowers | 把标准工作流固化为可组合技能链（需求澄清→计划→TDD→排障→评审） | 侧重“照着流程做”；better-harness 侧重“做完了没有、证据在哪”，事后验证 |
| oh-my-claudecode | 团队优先的多智能体编排层，并行拉多个专精 worker 加速复杂任务 | 侧重“多个 agent 一起干活更快”；better-harness 侧重“这一个 agent 本身有没有短板” |
定位是“诊断”而非“编排”或“方法论”——不替 agent 做决定，只告诉你薄弱环节与证据。
八、用户评价
该技能目前尚未见到经核实的独立第三方用户评价。
九、其他补充
README 提供中英双语版本（README.md / README.zh-CN.md）。
十、安装使用方式
Claude Code
/plugin marketplace add QoderAI/better-harness
/plugin install better-harness@better-harness安装后需开启一个新会话，在目标仓库内运行：
/better-harness analyze this project's AI coding workflow and generate an evidence-backed report默认生成 report.html（含 Markdown 与 JSON 版本）。
Codex CLI
codex plugin marketplace add 'https://github.com/QoderAI/better-harness.git' --ref main
codex plugin add better-harness@better-harness安装后同样需开启新任务再触发分析：
$better-harness:better-harness analyze this project's AI coding workflow and generate an evidence-backed report其余 host 安装步骤见官方 README；Qoder 内置无需额外安装。
十一、注意事项
- 版本号 v0.5.0，仍处 1.0 前早期演进阶段，命令与参数可能变动
- 不能独立运行，须依托已连接的 coding agent host（Claude Code / Codex 等）
- 跨会话记忆等扩展访问需显式 flag 授权，首次使用建议从默认范围开始
- 官方支持列表未包含 OpenClaw 与 Hermes Agent