1.3 KiB
1.3 KiB
title, type, tags, last_updated
| title | type | tags | last_updated |
|---|---|---|---|
| EvidenceFirstReasoning | concept | 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 使用的原则）