Update nexus wiki content

This commit is contained in:
2026-05-03 05:42:06 +08:00
parent 90f3811b83
commit 111bc65b7b
707 changed files with 32306 additions and 7289 deletions

View File

@@ -0,0 +1,39 @@
---
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]] 使用的原则)