Root Cause Investigator 是一款面向错误、Bug 与异常行为的系统性根因分析工具，核心方法是 5-Why（连续追问五次“为什么”），帮助使用者在排查问题时从表面症状逐层深入到根本原因。
用途
该工具用于以下场景：用户报告错误、Bug 或异常行为；构建失败或测试失败；性能问题或性能退化；集成问题；以及任何“它不工作”的情况。它强调先理解问题，再考虑修复，避免在根因尚未明确前提出解决方案。
主要能力
工具提供一套结构化的调查流程：
- 收集初始上下文：汇总问题描述、初始症状（用户经历、错误信息或日志、可观察行为）、上下文信息（环境细节、近期变更、相关组件、复现步骤）。
- 执行 5-Why 分析：以递进深度组织调查，分别记录每一层原因、证据与影响。典型层次包括：Why #1 表面原因（症状）、Why #2 更深层原因（流程/工作流问题）、Why #3 系统原因（系统级问题）、Why #4 流程/设计原因（设计或架构问题）、Why #5 根本原因。
- 识别根因：记录需要解决的根本问题，并列出建议继续调查的范围，包括需要检查的具体文件、需要测试的组件、需要验证的系统。
调查原则包括：避免解决方案偏见，先理解再修复；收集证据，不靠假设，用数据验证；考虑多重成因；记录发现以防重复问题；系统性思考更广泛影响；质疑“它应该能工作”的假设；使用版本控制确认问题引入时间。
工具还提供参考材料：references/patterns.md 按类别列出常见根因模式，包括配置、竞态条件、资源耗尽、集成失败、构建/部署问题；references/techniques.md 提供带命令示例的调查技术，覆盖错误分析、代码调查、依赖分析、环境调查。这些参考文件可在调查过程中按需加载。
使用方式
当出现上述触发场景时，工具会介入并引导调查。使用者按结构化模板记录问题摘要、初始症状与上下文，然后逐层执行 5-Why 分析，每一层都要求附上证据和影响说明。最终输出根因结论，以及建议继续检查的文件、组件或系统。整个流程强调方法性与彻底性，要求在每一层分析中记录证据，用具体数据验证假设，并从技术、环境、架构、外部依赖、流程等多个角度审视问题。
适用场景
适用于软件开发和运维过程中的排障，包括错误报告、构建与测试失败、性能退化、集成问题等。
限制
资料未提供关于收费、价格、平台支持、具体安装方式或效果保证的信息。工具本身不承诺直接修复问题，其目标是定位根本原因，而非仅修复症状。