Update nexus wiki content
This commit is contained in:
39
wiki/concepts/EvidenceFirstReasoning.md
Normal file
39
wiki/concepts/EvidenceFirstReasoning.md
Normal 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]] 使用的原则)
|
||||
Reference in New Issue
Block a user