File contents use-context-root-cause-analysis
原則
症状ではなく根本原因を修正する。対症療法は複雑性を増やし、根本原因の修正は再発を防ぐ。
手法
${CLAUDE_SKILL_DIR}/../../rules/core/OPERATION.md § Debug Investigation Protocol が正。fork 実行では常時ロードの rules が届かないので、手順をここに写す。
動く類似コードと壊れたコードを差分比較し、違いを列挙する
原因の仮説を 3 つ以上立てる。候補の出どころは ${CLAUDE_SKILL_DIR}/references/symptom-patterns.md
各仮説を検証で潰す。1 つに絞れないうちは結論を出さない
残った仮説が根本原因。「これを直せば症状が消えるか」で確かめる
落とし穴
扱い
最初の仮説で止まる
3 つ揃うまで検証を始めない
仮説を検証せず消す
消す根拠は実行結果か証拠。もっともらしさでは消さない
抽象へ流れる
アクションが取れる高さで止める。設計論まで遡らない
仮説が全部残る
差分比較の粒度を上げ、違いを 1 つずつ切り分けて再度潰す
Pattern の判定
Pattern は原因の深さでなく再発経路の有無で決まる。root cause と同じ形のコードが他にあるかを走査して分類する。
値
判定
Isolated
同じ形が他に無い
Recurring
近くに同じ形がある
Systematic
設計から生じ、同じ形が層をまたいで現れる
出力フォーマット
利用側は Pattern で分岐する。/fix は defense-in-depth を適用するか /research へ委譲するかを決める。
フィールド
説明
Symptom
ユーザーから見た失敗
Root cause
検証で残った仮説
Pattern
Isolated / Recurring / Systematic
参照ファイル
迷うこと
ファイル
仮説をどう立てるか
${CLAUDE_SKILL_DIR}/references/symptom-patterns.md
消去がどう進むか
${CLAUDE_SKILL_DIR}/references/hypothesis-examples.md
1 --- 2 name: use-context-root-cause-analysis-2 3 description: 仮説の消去による根本原因分析。 4 --- 5 6 # use-context-root-cause-analysis 7 8 ## 原則 9 10 症状ではなく根本原因を修正する。対症療法は複雑性を増やし、根本原因の修正は再発を防ぐ。 11 12 ## 手法 13 14 ${CLAUDE_SKILL_DIR}/../../rules/core/OPERATION.md § Debug Investigation Protocol が正。fork 実行では常時ロードの rules が届かないので、手順をここに写す。 15 16 1. 動く類似コードと壊れたコードを差分比較し、違いを列挙する 17 2. 原因の仮説を 3 つ以上立てる。候補の出どころは ${CLAUDE_SKILL_DIR}/references/symptom-patterns.md 18 3. 各仮説を検証で潰す。1 つに絞れないうちは結論を出さない 19 4. 残った仮説が根本原因。「これを直せば症状が消えるか」で確かめる 20 21 | 落とし穴 | 扱い | 22 | ------------------ | ------------------------------------------------------- | 23 | 最初の仮説で止まる | 3 つ揃うまで検証を始めない | 24 | 仮説を検証せず消す | 消す根拠は実行結果か証拠。もっともらしさでは消さない | 25 | 抽象へ流れる | アクションが取れる高さで止める。設計論まで遡らない | 26 | 仮説が全部残る | 差分比較の粒度を上げ、違いを 1 つずつ切り分けて再度潰す | 27 28 ## Pattern の判定 29 30 Pattern は原因の深さでなく再発経路の有無で決まる。root cause と同じ形のコードが他にあるかを走査して分類する。 31 32 | 値 | 判定 | 33 | ---------- | ---------------------------------------- | 34 | Isolated | 同じ形が他に無い | 35 | Recurring | 近くに同じ形がある | 36 | Systematic | 設計から生じ、同じ形が層をまたいで現れる | 37 38 ## 出力フォーマット 39 40 利用側は Pattern で分岐する。`/fix` は defense-in-depth を適用するか `/research` へ委譲するかを決める。 41 42 | フィールド | 説明 | 43 | ---------- | --------------------------------- | 44 | Symptom | ユーザーから見た失敗 | 45 | Root cause | 検証で残った仮説 | 46 | Pattern | Isolated / Recurring / Systematic | 47 48 ## 参照ファイル 49 50 | 迷うこと | ファイル | 51 | ------------------ | ----------------------------------------------------- | 52 | 仮説をどう立てるか | ${CLAUDE_SKILL_DIR}/references/symptom-patterns.md | 53 | 消去がどう進むか | ${CLAUDE_SKILL_DIR}/references/hypothesis-examples.md |
thkt/claude-config/tree/main/.ja/skills/use-context-root-cause-analysis commit 63f91285eb
Frequently asked questions How do I install the Use Context Root Cause Analysis skill? Run npx skillmds@latest add thkt/use-context-root-cause-analysis-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
What does the Use Context Root Cause Analysis skill do? 仮説の消去による根本原因分析。 It is listed under Coding & Dev Tools on SkillMD.
Is Use Context Root Cause Analysis safe to use? This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
Which AI agents work with Use Context Root Cause Analysis? This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Is Use Context Root Cause Analysis free to use? Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
Who published Use Context Root Cause Analysis? thkt (@thkt) published this skill. Their other Agent Skills are listed on their SkillMD profile.