investigation-first
Installation
SKILL.md
调查研究
"没有调查,没有发言权。" —— 毛泽东《反对本本主义》(1930年)
核心原则
一切正确的决策都来源于对实际情况的调查研究。没有调查就没有发言权,没有正确的调查同样没有发言权。
在本项目的方法体系中,调查研究 是落实 实事求是 的主要入口。调查不是为既定结论搜集材料,而是让事实来规定判断,让现实来修正理论。
详细原著依据见 original-texts.md
不适用场景
以下情况不需要调用此 skill:
- 当前任务是已充分调查后的执行阶段 —— 不要重复调查
- 用户已经提供了完整的上下文和决策依据
- 问题是技术实现细节,答案可以直接验证(运行代码看结果)
- 紧急的修复任务且问题现象已经明确 —— 直接定位和修复,调查会浪费时间
何时使用
你应该在以下情况调用此 skill:
- 要做一个决策,但对实际情况了解不够
- 进入一个陌生的领域或面对一个新问题
- 发现自己在凭"直觉"或"经验"做判断,缺乏事实依据
- 别人的方案/建议听起来合理,但你不了解其适用条件
- 需要全面了解一个系统/项目/问题的现状
- 感觉自己在"本本主义"——套用理论而不了解实际
方法流程
第一步:明确调查目的
"调查就像'十月怀胎',解决问题就像'一朝分娩'。"——《反对本本主义》
调查不是漫无目的地搜集信息。在开始之前明确:
- 我要解决什么问题?
- 我需要了解哪些方面的情况?
- 调查的结果将如何指导我的行动?
第二步:制定调查提纲
毛泽东强调调查必须有"准备"——要有详细的提纲
列出需要调查的具体问题清单:
- 当前状况是什么?(现状调查)
- 历史上是怎样的?(历史调查)
- 有哪些相关的因素?(关联调查)
- 有哪些不同的观点?(多方调查)
第三步:深入一线获取第一手资料
"你对于某个问题没有调查,就停止你对于某个问题的发言权。"——《反对本本主义》
必须亲自接触第一手资料,不能只看二手总结:
- 直接阅读源代码,而非只看文档
- 直接运行和测试,而非只看报告
- 直接与相关人员交流,而非只看转述
- 深入了解细节,不要满足于"大概了解"
警惕:
不能搞"走马看花"式的调查——"像站在高山上远观一座繁华的都市"那样浮光掠影。
第四步:详细记录,系统整理
"要自己做记录"——《反对本本主义》
调查过程中要:
- 详细记录发现的事实
- 区分事实与观点
- 整理归类,找出规律
- 标注存疑的地方
第五步:实事求是,得出结论
"'实事'就是客观存在着的一切事物,'是'就是客观事物的内部联系,即规律性,'求'就是我们去研究。"——《改造我们的学习》
从调查得到的事实出发,分析其内在联系,得出结论:
- 事实先于判断,材料先于观点
- 结论必须有事实支撑
- 不能先有结论再找证据
- 如果事实与预期不符,修改的应该是结论而非事实
- 承认"不知道"也是一种诚实的调查结论
第六步:调查完成后再做决策
调查结束后,基于调查结果做出决策或提出方案。此时再与理论原则结合——但理论必须服从事实,不是事实服从理论。如果后续进入验证和迭代,继续调用 practice-cognition,让 实事求是 贯穿从调查到实践检验的全过程。
调查的七项注意
根据毛泽东在《反对本本主义》中提出的调查方法,整理为七项注意:
- 要有目的 —— 带着问题去调查
- 要有提纲 —— 调查有计划、有条理
- 要亲自做 —— 不能只靠别人汇报
- 要深入 —— 不能浮皮潦草
- 要做记录 —— 系统整理调查结果
- 要多方面 —— 听取不同角度的意见
- 要实事求是 —— 从事实出发,不预设结论
常见错误
| 错误 | 毛泽东的批评 | 正确做法 |
|---|---|---|
| 不调查就给出答案 | "没有调查,没有发言权" | 先调查,后发言 |
| 只看文档不看实际 | "不注重研究现状" | 深入一线获取第一手资料 |
| 调查走马观花 | 不能"站在高山上远观" | 深入细致,不浮于表面 |
| 先有结论再找证据 | "不是从客观存在着的实际事物出发" | 从事实出发得出结论 |
| 只调查现状不看历史 | "不注重研究历史" | 历史与现状并重 |
| 只看一方面 | 需要多角度多方面的调查 | 兼听则明 |
操作规程
当本 skill 被触发时,在开始任何实质性工作之前,先输出调查提纲:
- 声明调查目的:一句话写出"我要弄清楚的是:[具体问题]"
- 列调查清单:用 checkbox 列出需要调查的具体项目,例如:
- [ ]读取 [具体文件/模块] 了解现状- [ ]检查 [具体接口/配置] 了解约束条件- [ ]确认 [具体数据/状态] 的实际情况
- 执行调查:逐项完成,完成后标记
- [x] - 输出调查结论,用固定格式收尾:
调查结论: - 现状是:…… - 关键约束是:…… - 我之前不知道但现在知道的是:…… - 基于以上,我的判断是:……
调查结论必须先于任何行动方案出现,不得边调查边给方案。
与其他 skill 的关系
- 矛盾分析法:调查研究为矛盾分析提供事实基础
- 实践认识论:调查研究是"实践"的重要形式,调查得出的认识还要回到实践中接受检验
- 群众路线:调查研究的重要方法就是"从群众中来"
- 批评与自我批评:调查自己的工作也是自我批评的一部分
Weekly Installs
27
Repository
hughyau/qiushi-skillGitHub Stars
242
First Seen
12 days ago
Security Audits
Installed on
kimi-cli26
gemini-cli26
deepagents26
antigravity26
amp26
cline26