---
id: findings-and-evidence
title: 发现与证据
sidebar_position: 2
---

# 发现与证据

Better Harness 刻意保持诚实：报告中的每条论断都以实际观察到的内容为边界。
本页解释让报告可信的那些边界。

## 证据边界

三个证据域在统一分析之前保持相互独立：

- **会话证据** —— 在支持真实本地会话源的宿主上，智能体在相关 Task Episode
  中实际做了什么。
- **项目证据** —— 仓库机制：指令、验证、hooks、交付关卡和可复用知识路径。
- **智能体资产** —— 已配置的 Skills、命令、规则、MCP 工具和指令文件。

三者共享同一条边界：**已配置的资产只能证明某个机制存在，只有关联的任务证据
才能证明它被使用过或改善了结果。**

## 一条发现包含什么

每条发现把一个有据可依的差距转化为可执行的条目：

- **影响** —— 这个差距为什么对工作循环重要；
- **证据** —— 该发现所绑定的可见来源；
- **期望产出** —— "修好了"是什么样子；
- **限定范围的修复** —— 一份供评审的有边界修复方案草稿；
- **验收检查** —— 如何验证修复已落地。

缺失或不完整的证据在报告中保持显式标注，而不会变成没有依据的分数或论断。

## 项目视角：五个软件能力

在以任务为中心的 Agent Work Loop 之外，独立的项目证据评审使用一个静态视角：

| 能力 | 回答的问题 |
| --- | --- |
| Context Map | 智能体能否找到正确的上下文、边界、风险区域和下一步？ |
| Environment Readiness | 项目能否在不靠猜测的情况下完成搭建、运行、重置和诊断？ |
| Fast Feedback | 改动后相关检查能否快速返回有用反馈？ |
| Quality Gates | 架构、安全、schema、迁移和漂移规则是否被强制执行？ |
| Change Safety | 高风险操作、验收和恢复是否受控？ |

未被观察到的任务行为永远不会被当成仓库能力缺失。

## 置信度

报告的置信度分为低/中/高，绑定实际执行了多少（而非只是阅读）。纯静态的首次
评审保持低/中；通过当前检查只能证明干预被执行过，只有可比的后续结果才能
证明循环改善了。

## 深入阅读

- 一页概览：
  [`docs/concepts.md`](https://github.com/QoderAI/better-harness/blob/main/docs/concepts.md)
- 模型路由与高级视角：
  [`models/routing.md`](https://github.com/QoderAI/better-harness/blob/main/models/routing.md)