Investigation First

触发：当你准备下判断、做决策或提出建议，但事实、上下文或一手信息还不充分时优先调用；常见信号包括 unknowns、信息缺口、证据不足、领域陌生、需要先摸清现状。 English: Trigger before making claims or decisions when context is incomple...

Security Scan

This is an instruction-only 'investigate first' skill whose required actions (read files, inspect code, run tests, gather facts) match its stated purpose; it requests no credentials or installs and contains no hidden endpoints.

Purpose & Capability

The skill's name and description (investigate before drawing conclusions) match the instructions and helper agent prompt: both explicitly direct systematic fact‑finding, reading sources, and running verification. There are no unrelated dependencies or credential requests.

Instruction Scope

The SKILL.md and investigation-agent prompt direct the agent to 'use all available tools', read relevant files and code, view history (git log/blame), and run code/tests. This is coherent with investigation tasks but means the agent may access local repository files, logs, and execute code to verify behavior — users should be aware the skill's operating model expects access to project/workspace artifacts.

Install Mechanism

No install spec and no code files with executable install steps — instruction-only skill. Nothing is downloaded or written to disk by the skill package itself.

Credentials

The skill declares no required environment variables, no credentials, and no config paths. There are no disproportionate secret requests.

Persistence & Privilege

always is false and disable-model-invocation is false (normal). The skill does not request elevated or persistent platform privileges and does not modify other skills or system-wide settings.

Assessment

This skill is coherent and low-risk as a bundle of instructions: it only provides guidance for performing investigations and does not ship code or request secrets. However, it explicitly instructs agents to read local files, inspect git history, and run code/tests when investigating — so only enable or invoke it in agents/environments where you are comfortable allowing those actions against your workspace or repositories. If you want to restrict execution, limit the agent's runtime permissions or review which files the agent can access before use.

调查研究

"没有调查，没有发言权。" —— 毛泽东《反对本本主义》（1930年）

核心原则

一切正确的决策都来源于对实际情况的调查研究。没有调查就没有发言权，没有正确的调查同样没有发言权。

在本项目的方法体系中，调查研究 是落实 实事求是 的主要入口。调查不是为既定结论搜集材料，而是让事实来规定判断，让现实来修正理论。

详细原著依据见 original-texts.md

何时使用

你应该在以下情况调用此 skill：

• 要做一个决策，但对实际情况了解不够
• 进入一个陌生的领域或面对一个新问题
• 发现自己在凭"直觉"或"经验"做判断，缺乏事实依据
• 别人的方案/建议听起来合理，但你不了解其适用条件
• 需要全面了解一个系统/项目/问题的现状
• 感觉自己在"本本主义"——套用理论而不了解实际

方法流程

第一步：明确调查目的

"调查就像'十月怀胎'，解决问题就像'一朝分娩'。"——《反对本本主义》

调查不是漫无目的地搜集信息。在开始之前明确：

• 我要解决什么问题？
• 我需要了解哪些方面的情况？
• 调查的结果将如何指导我的行动？

第二步：制定调查提纲

毛泽东强调调查必须有"准备"——要有详细的提纲

列出需要调查的具体问题清单：

• 当前状况是什么？（现状调查）
• 历史上是怎样的？（历史调查）
• 有哪些相关的因素？（关联调查）
• 有哪些不同的观点？（多方调查）

第三步：深入一线获取第一手资料

"你对于某个问题没有调查，就停止你对于某个问题的发言权。"——《反对本本主义》

必须亲自接触第一手资料，不能只看二手总结：

• 直接阅读源代码，而非只看文档
• 直接运行和测试，而非只看报告
• 直接与相关人员交流，而非只看转述
• 深入了解细节，不要满足于"大概了解"

警惕：

不能搞"走马看花"式的调查——"像站在高山上远观一座繁华的都市"那样浮光掠影。

第四步：详细记录，系统整理

"要自己做记录"——《反对本本主义》

调查过程中要：

• 详细记录发现的事实
• 区分事实与观点
• 整理归类，找出规律
• 标注存疑的地方

第五步：实事求是，得出结论

"'实事'就是客观存在着的一切事物，'是'就是客观事物的内部联系，即规律性，'求'就是我们去研究。"——《改造我们的学习》

从调查得到的事实出发，分析其内在联系，得出结论：

• 事实先于判断，材料先于观点
• 结论必须有事实支撑
• 不能先有结论再找证据
• 如果事实与预期不符，修改的应该是结论而非事实
• 承认"不知道"也是一种诚实的调查结论

第六步：调查完成后再做决策

调查结束后，基于调查结果做出决策或提出方案。此时再与理论原则结合——但理论必须服从事实，不是事实服从理论。如果后续进入验证和迭代，继续调用 practice-cognition，让 实事求是 贯穿从调查到实践检验的全过程。

调查的七项注意

根据毛泽东在《反对本本主义》中提出的调查方法，整理为七项注意：

1. 要有目的 —— 带着问题去调查
2. 要有提纲 —— 调查有计划、有条理
3. 要亲自做 —— 不能只靠别人汇报
4. 要深入 —— 不能浮皮潦草
5. 要做记录 —— 系统整理调查结果
6. 要多方面 —— 听取不同角度的意见
7. 要实事求是 —— 从事实出发，不预设结论

常见错误

错误	毛泽东的批评	正确做法
不调查就给出答案	"没有调查，没有发言权"	先调查，后发言
只看文档不看实际	"不注重研究现状"	深入一线获取第一手资料
调查走马观花	不能"站在高山上远观"	深入细致，不浮于表面
先有结论再找证据	"不是从客观存在着的实际事物出发"	从事实出发得出结论
只调查现状不看历史	"不注重研究历史"	历史与现状并重
只看一方面	需要多角度多方面的调查	兼听则明

与其他 skill 的关系

• 矛盾分析法：调查研究为矛盾分析提供事实基础
• 实践认识论：调查研究是"实践"的重要形式，调查得出的认识还要回到实践中接受检验
• 群众路线：调查研究的重要方法就是"从群众中来"
• 批评与自我批评：调查自己的工作也是自我批评的一部分