40 lines
1.3 KiB
Markdown
40 lines
1.3 KiB
Markdown
---
|
||
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]] 使用的原则）
|