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 Whys 手法5 Whys 手法
体系的な RCA プロセス体系的な RCA プロセス
RCA レポートのテンプレートRCA レポートのテンプレート
根本原因分析の手法根本原因分析の手法
フォローアップと予防フォローアップと予防

ベストプラクティス

✅ 推奨事項
  • 確立されたパターンと規約に従います
  • クリーンで保守しやすいコードを書きます
  • 適切なドキュメントを追加します
  • デプロイ前に十分にテストします
❌ 避けるべきこと
  • テストや検証を省略します
  • エラー処理を無視します
  • 設定値をハードコードします

コメント

Markdown 対応