SuperAPI AI 工具集

root-cause-analyze

数据与分析

查看项目

更新于 11-03 10:02

技能介绍

用途

root-cause-analyze 旨在以确定性方法确立根因:由 Pareto 对原因类别排序,再由 rca_tree 选择有证据支撑的 why 链,并应用系统性检验与操作员失误排除规则。该技能在每次 CAPA 运行中位于 ncr-intake 之后使用。

主要能力

  • 针对投诉窗口运行 Pareto 分析,对原因类别进行排名。
  • 结合原因关联库选择有证据支撑的 why 链。
  • 应用系统性检验,并执行操作员失误排除规则。
  • 明确标记引擎对“操作员失误”(capa-rules.md #3.4)的拒绝结果,提示反复出现的缺陷不能仅靠再培训关闭。

使用方式

输入包括 capa-intake.json、complaints.csv 以及参考的原因关联库(references/cause-links.json)。步骤:

  1. 按契约进行校验。
  2. 运行 scripts/pareto.py --capa capa-intake.json --complaints complaints.csv --out pareto.json。
  3. 在该技能文件夹中运行 python3 scripts/rca_tree.py --pareto pareto.json --links references/cause-links.json --out rca.json,并对 Pareto 输入与生成输出使用工作区路径。
  4. 逐字引用 why 链;如引擎拒绝了“操作员失误”,需明确说明。

输出为 rca.json,包含 {root_cause} 节点、pareto[]、why_chain 和 systemic 标记。

适用场景

适用于 CAPA 流程中在 ncr-intake 之后需要结构化、可追溯的根因分析的场景,尤其是需要对投诉原因分类排序并建立证据链的质量分析工作。

限制

方法完全由引擎执行;模型不得编造或重排 why 链,也不得用事件叙述中的原因标签取代 Pareto 结论。每条 why 必须在记录集中有证据(见 rca-methods.md),why 链需引用原因关联库与投诉窗口。引擎升级项(#3.4 拒绝、#2.2 深度、#7 置信度)需逐字传递。