关于 root-cause-analysis
用于追查故障根因并制定持久解决方案的技能,适合处理事故与反复出现的问题。附有 5 Whys、系统化 RCA、报告和预防措施指南。
主要功能
- 015 Whys 技术
- 02系统化 RCA 流程
- 03RCA 报告模板
- 04后续跟进与预防指南
适用场景
- 01调查生产事故
- 02分析反复发生的故障
- 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.mdrca-report-template.mdroot-cause-analysis-techniques.mdsystematic-rca-process.mdthe-5-whys-technique.mdscripts/validate-schema.shtemplates/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