SuperAPI AI 工具集

root-cause-analysis

部署与运维

查看项目

更新于 10-16 03:13

技能介绍

用途:在诊断系统故障、调查事故或异常行为、寻找真实根因时使用,回答“为什么会发生”。不适用于已有文档修复方案的已知问题、简单配置错误,或没有证据的猜测。

主要能力:提供分阶段方法论。发现阶段通过症状、起始时间、可复现性、近期变更、已尝试方案、约束条件等问题收集上下文,并按0-4级置信度决定是否进入假设阶段。假设阶段要求生成2-4个可测试、可证伪、具体且合理的竞争假设,按证据支持度、简洁性和可测试性排序。取证阶段收集错误表现、最小复现步骤、系统状态、环境与时间模式,并沿“最后已知正常状态→首次可观察失败→其间变更→根因触发点”回溯。测试阶段为每个假设设计预测、验证方法、预期结果与时间预算,按先快速非破坏性本地测试、再常见原因、后边缘情况的优先级执行,遵循“基线→单变量变更→观察→记录→迭代”。排除阶段使用二分查找、变量隔离、逐一排除三种技术。

使用方式:按时间盒推进——发现5-10分钟、假设10-15分钟、每个假设测试15-30分钟、修复时间不定、验证10-15分钟;超出预估2倍应暂停、换视角或上报。全程记录审计轨迹,格式如“[时间] 阶段: 动作 → 结果”。

适用场景:系统失败诊断、事故与宕机调查、区分症状与根因、通过理解原因防止复发。

限制与注意事项:避免未诊断就跳到解决方案、只信单一假设、不理解原因就修复、跳过修复验证、重复失败步骤、隐瞒不确定性。需警惕确认偏误、把相关当因果、“我已经看过了”等陷阱。深度方法见 elimination-techniques.md、pitfalls.md、documentation-templates.md。相关技能:debugging-and-diagnosis、codebase-analysis、report-findings。