investigation-first

1# 调查研究
2 
3> "没有调查，没有发言权。" —— 《反对本本主义》
4 
5调查研究是落实「实事求是」的入口：不是为既定结论找材料，而是让事实规定判断。
6 
7## 用 / 不用
8 
9用：
10- 要做决策，但对实际情况了解不够
11- 面对陌生的代码库、系统或领域
12- 别人的方案听起来合理，但你不清楚其适用条件
13- 发现自己在用"应该是""一般来说"作答
14 
15不用：
16- 已经调查过，现在是执行阶段
17- 用户已提供完整上下文和决策依据
18- 答案可以直接跑一下验证，跑比查快
19 
20## 操作规程
21 
221. **一句话写出调查目的**：「我要弄清楚的是：……」。没有目的的调查是漫游。
232. **列调查提纲**（checkbox），覆盖四个面：
24   - 现状：现在是什么样（读源码、配置、数据，不只看文档）
25   - 历史：为什么变成这样（git log、blame、变更记录）
26   - 关联：牵涉哪些约束（接口、依赖、调用方、部署环境）
27   - 多方：有哪些不同说法（文档 vs 代码 vs 运行结果 vs 用户描述）
283. **亲自接触第一手材料**：直接读、直接跑、直接看日志。二手总结只能作线索，不能作证据。
294. **边查边记，分三栏**：每条发现标注来源；把"看到的"和"推出来的"分开。
305. **输出调查结论**（模板见下）。结论必须先于任何行动方案；不得边查边给方案。
316. 事实与预期不符时，改判断，不改事实。查不清的，诚实写"未知"。
32 
33## 输出模板
34 
35```
36调查目的：……
37调查范围：读了 …… / 跑了 …… / 问了 ……
38 
39已核实的事实（附来源）：
40- ……（来源：文件:行 / 命令输出 / 日志）
41合理推断（说明推理链）：
42- ……（因为 …… 所以 ……）
43未知 / 存疑：
44- ……（需要 …… 才能确认）
45 
46调查结论：
47- 现状是：……
48- 关键约束是：……
49- 我原来不知道、现在知道的是：……
50- 基于以上，我的判断是：……（置信度：高 / 中 / 低）
51```
52 
53## 纪律
54 
55- 禁止在"未知"栏非空且关系到结论时下定论：要么补查，要么把不确定性写进结论。
56- 禁止走马观花：只看目录结构和 README 就总结的，不算调查。
57- 调查有预算：先写提纲，按提纲查完即止；发现新的大问题时另开一轮，而不是无限扩张。
58 
59## 交接
60 
61- 调查揭示多头矛盾、抓不住重点 → `contradiction-analysis`
62- 结论已形成、需要验证 → `practice-cognition`
63- 范围大、可分头查 → 派遣 `investigator` 子 agent 并行调查，主线只汇总三栏
64 
65> 原著依据：[original-texts.md](original-texts.md)