SH

Soloharness

概念 · 故事 · Agent

← 返回概念解读

Concept Fable精修版

根因分析

Root Cause Analysis, RCA · Operations

先读故事。这里不急着给定义,先让问题自己长出来。

寓言故事

井水总是浑,村长却一直换水桶

白鹿村的井水忽然变浑了。第一个发现的是卖豆腐的老人。他把水打上来,桶底全是细沙。村长让人把那桶水倒掉,换一只新桶,再打一桶。新桶里的水还是浑。

有人说,是打水的人手太重,把井底搅起来了。于是换了一个手轻的年轻人。水依然浑。又有人说,是桶太旧,木屑掉进水里。于是买了新桶。水还是浑。

接下来几天,村里不断处理表面问题:换桶、换绳、换打水时间、让人慢一点。每个办法都有一点道理,也都能让人忙起来。但豆腐老人说,水不是在桶里变浑的,是从井里出来时就浑了。

村长这才请来老井匠。井匠没有先看桶,而是沿着井壁往下查。他发现井壁第三层有一条细裂缝,雨后的泥水正从那里渗进来。桶、绳、打水人都不是根本原因,只是问题出现后最容易被看见的地方。

井匠补了裂缝,又在井口修了排水沟。第二天,水慢慢清了。村长问,为什么我们之前做了那么多事都没用?井匠说,因为你们一直在处理水浑之后最靠近眼睛的东西。真正的问题,藏在水变浑之前。

后来村里定了规矩:遇到问题,先问五遍为什么。为什么水浑?因为泥沙进井。为什么泥沙进井?因为井壁裂了。为什么井壁裂了?因为雨水长期冲刷。为什么雨水冲刷?因为井口排水沟堵了。为什么没人发现?因为巡查只看桶和绳,不看井壁。

从那以后,白鹿村不再把忙碌当成解决。换桶可以快,补井才有用。

揭示

这个故事讲的是:根因分析

根因分析 Root Cause Analysis(RCA)是找出问题背后真正原因的分析方法,而不是只处理表面症状。它常用于事故、质量问题、系统故障和业务异常复盘中。对 Agent 系统来说,RCA 能帮助团队判断问题到底来自模型、提示词、检索、工具、数据、权限、流程设计,还是监控和治理缺失。

它重要的地方在于:它不只是一个术语,而是在真实 AI / Agent 系统里会反复出现的结构性问题。理解它,才能判断什么时候该加模型,什么时候该改流程,什么时候该补治理。

隐喻映射

  • 浑水:用户看到的错误输出、故障或异常结果
  • 换水桶、换绳、换人:只处理表面症状或最容易看见的环节
  • 水从井里出来就浑:问题源头发生在更上游或更底层
  • 井壁裂缝:真正根因,例如数据污染、权限缺陷、工具参数错误或流程漏洞
  • 修排水沟:不仅修复当前问题,还消除导致根因反复出现的条件
  • 五遍为什么:RCA 常用的追问方法,用来逐层接近根因
  • 巡查只看桶和绳:监控和检查范围错误,也可能是根因的一部分
  • 换桶可以快,补井才有用:临时修补和根因修复的区别

Soloharness 判断

这个概念的实战价值,是帮你把“看起来聪明的 AI 功能”拆成可交付、可验收、可治理的工作单元。

incidentobservability