mcpField
R
root-cause-analysis

root-cause-analysis

github.com/aj-geddes云与 DevOps373889 次安装34 周前更新
代码仓库

关于 root-cause-analysis

用于追查故障根因并制定持久解决方案的技能,适合处理事故与反复出现的问题。附有 5 Whys、系统化 RCA、报告和预防措施指南。

主要功能

  1. 015 Whys 技术
  2. 02系统化 RCA 流程
  3. 03RCA 报告模板
  4. 04后续跟进与预防指南

适用场景

  1. 01调查生产事故
  2. 02分析反复发生的故障
  3. 03处理性能下降

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/aj-geddes/useful-ai-prompts --skill root-cause-analysis

安装后在 Claude Code 中输入/root-cause-analysis确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
follow-up-prevention.md
rca-report-template.md
root-cause-analysis-techniques.md
systematic-rca-process.md
the-5-whys-technique.md
scripts/
validate-schema.sh
templates/
migration-template.sql

详细介绍

根因分析

目录

概述

根因分析(RCA)旨在找出故障的根本原因,从而制定永久解决方案,而非临时修复。

适用场景

  • 生产事故
  • 影响客户的问题
  • 重复出现的问题
  • 意外故障
  • 性能下降

快速入门

最小可运行示例:

Example: Website Down

Symptom: Website returned 503 Service Unavailable

Why 1: Why was website down?
  Answer: Database connection pool exhausted

Why 2: Why was connection pool exhausted?
  Answer: Queries taking too long, connections not released

Why 3: Why were queries slow?
  Answer: Missing index on frequently queried column

Why 4: Why was index missing?
  Answer: Performance testing didn't use production-like data volume

Why 5: Why wasn't production-like data used?
  Answer: Load testing environment doesn't mirror production

Root Cause: Load testing environment under-provisioned

Solution: Update load testing environment with production-like data

Prevention: Establish environment parity requirements

参考指南

references/ 目录中的详细实现:

指南内容
5 个为什么分析法5 个为什么分析法
系统化 RCA 流程系统化 RCA 流程
RCA 报告模板RCA 报告模板
根因分析技术根因分析技术
后续跟进与预防后续跟进与预防

最佳实践

✅ 应该做
  • 遵循既定模式和惯例
  • 编写整洁、易于维护的代码
  • 添加适当的文档
  • 部署前进行充分测试
❌ 不应该做
  • 跳过测试或验证
  • 忽略错误处理
  • 将配置值硬编码

评论

支持 Markdown