---
title: "EvidenceFirstReasoning"
type: concept
tags: []
last_updated: 2026-05-02
---

## Definition

Evidence-First Reasoning（证据优先推理）是一种推理原则：只陈述代码中实际可见、可验证的事实，绝不进行推理、假设或猜测。

## Core Rule

> "Never state that a module owns behavior unless you can point to the file(s) that implement or route it."

如果某件事在检查的代码中不可见，就不能陈述它。

## Contrast with Other Approaches

| Evidence-First Reasoning | Speculative Reasoning |
|---|---|
| 基于代码中可验证的事实 | 基于推测和假设 |
| 明确告知检查范围边界 | 不声明检查边界 |
| 引用具体文件/函数名 | 使用泛化描述 |
| 诚实回答"不知道" | 试图覆盖不确定区域 |

## Application in AI Coding Agents

AI Coding Agent 在执行代码库分析时：
- 必须引用具体源文件路径
- 必须区分"检查过的代码"和"未检查的代码"
- 不得推断意图、质量或未来工作
- 当答案是部分的，只能说明检查了哪些文件

## Related Concepts

- [[CodebaseOnboarding]] — 代码库 onboarding 方法论
- [[ExecutionTracing]] — 执行路径追踪
- [[MinimalChangePrinciple]] — 最小变更原则（[[EngineeringMinimalChangeEngineer]] 使用的原则）