jpskill.com
💬 コミュニケーション コミュニティ

bug-diagnose-and-root-cause-and-fix

プログラムのエラーや不具合、動作不良などの問題が発生した際に、原因を特定して詳細な診断報告と具体的な修正方法を提示し、問題解決を支援するSkill。

📜 元の英語説明(参考)

【Bug 诊断专用】当遇到程序错误、异常行为、性能问题、功能故障时必须使用本技能。触发关键词：报错、Bug、问题、异常、故障、不工作、诊断、排查、修复。本技能提供系统性根因分析，输出详细诊断报告和可执行修复方案，包含代码位置引用、步骤指导、注意事项。仅提供分析和方案，不直接修改代码。

🇯🇵 日本人クリエイター向け解説

一言でいうと

プログラムのエラーや不具合、動作不良などの問題が発生した際に、原因を特定して詳細な診断報告と具体的な修正方法を提示し、問題解決を支援するSkill。

※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux 
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o bug-diagnose-and-root-cause-and-fix.zip https://jpskill.com/download/16759.zip && unzip -o bug-diagnose-and-root-cause-and-fix.zip && rm bug-diagnose-and-root-cause-and-fix.zip
🪟 Windows (PowerShell) 
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/16759.zip -OutFile "$d\bug-diagnose-and-root-cause-and-fix.zip"; Expand-Archive "$d\bug-diagnose-and-root-cause-and-fix.zip" -DestinationPath $d -Force; ri "$d\bug-diagnose-and-root-cause-and-fix.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)
  1. 1. 下の青いボタンを押して bug-diagnose-and-root-cause-and-fix.zip をダウンロード
  2. 2. ZIPファイルをダブルクリックで解凍 → bug-diagnose-and-root-cause-and-fix フォルダができる
  3. 3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
  4. 4. Claude Code を再起動
⬇ .zip でダウンロード(推奨) ⬇ .skill 形式(上級者用) 元のソース ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

  1. 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
  2. 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
  3. 3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
    • · macOS / Linux: ~/.claude/skills/
    • · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →
最終更新
2026-05-18
取得日時
2026-05-18
同梱ファイル
1

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

Bug 診断と根本原因分析スキル

本スキルは、体系的な Bug 診断能力を提供し、問題の根本原因の分析と詳細な解決策の指導に焦点を当てています。

核心機能

問題の根本原因を診断し、詳細な解決策レポートを出力して、ユーザーに修正の指導を提供します。

実行フロー

1. 情報収集

  • エラーの症状、再現手順、エラーメッセージを確認します。
  • 情報が不足している場合は、重要な詳細を積極的に質問します。

2. コードレビュー（必須の第一歩）

  • Read/Grep/Glob を使用して、関連するコードを確認します。
  • 疑わしいファイルと関数を特定します。
  • Bash を使用して診断コマンド（例：git log、git blame、npm list など）を実行します。
  • 最近のコード変更をチェックします。

3. 根本原因分析

  • コードとエラーメッセージに基づいて仮説を立てます。
  • 各仮説を段階的に検証します。
  • 技術ドキュメントの参照が必要な場合は、レポートで参照する必要がある内容を説明します。

4. 解決策策定

  • 根本原因を特定します。
  • 詳細な修正計画を策定します。
  • 複数の解決策がある場合は、長所と短所を分析し、最適な解決策を推奨します。

出力形式

本スキルは、完全な診断レポートを出力します。ユーザーはこのレポートに基づいて修正を実行できます。

問題診断レポート

問題の概要： ユーザーから報告された問題を簡潔に記述します。

環境情報：

  • 関連ファイル：すべての関連ファイルパスをリストします。
  • エラー位置：ファイル名と行番号まで正確に示します。
  • 技術スタック：関連するフレームワーク、ライブラリ、バージョンなど。

根本原因分析：

  • 詳細な技術的説明
  • 重要なコードスニペットを引用します（ファイルパス:行番号 形式を使用）。
  • なぜこの問題が発生するのかを説明します。

解決策：

解決策 1：[推奨/代替]

  1. ステップ 1：具体的な操作説明

    • 修正が必要なファイル：ファイルパス
    • 修正位置：X 行目
    • 修正内容：旧コード → 新コード

  2. ステップ 2：...

  3. 検証ステップ：

    • 実行コマンド：具体的なコマンド
    • 予想される結果：...

解決策 2（もしあれば）：...

  • 良い点：...
  • 悪い点：...

注意事項：

  • 保持する必要があるコードまたはコメント
  • 起こりうる副作用
  • その他注意すべき点

実行準則

  • 分析と指導のみを提供する - 本スキルは分析と指導のみを提供し、コードの修正は実行しません。
  • 証拠に基づく - すべての結論は、コードまたはログによって裏付けられている必要があります。
  • 詳細かつ具体的 - 解決策は、ユーザーが直接実行できるほど詳細である必要があります。
  • 正確な引用 - ファイル:行番号 形式を使用して、すべての関連コード位置を注釈します。
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

Bug 诊断与根因分析技能

本技能提供系统性的 Bug 诊断能力，专注于分析问题根源并提供详细的解决方案指导。

核心功能

诊断问题根本原因，输出详细的解决方案报告，为用户提供修复指导。

执行流程

1. 信息收集

  • 确认错误症状、复现步骤、错误信息
  • 如信息不足，主动询问关键细节

2. 代码审查（强制第一步）

  • 使用 Read/Grep/Glob 查看相关代码
  • 定位可疑的文件和函数
  • 使用 Bash 运行诊断命令（如 git log、git blame、npm list 等）
  • 检查最近的代码变更

3. 根因分析

  • 基于代码和错误信息形成假设
  • 逐步验证各个假设
  • 如需查询技术文档，在报告中说明需要查询的内容

4. 方案制定

  • 确定根本原因
  • 制定详细的修复方案
  • 如有多个方案，分析优缺点并推荐最佳方案

输出格式

本技能输出完整的诊断报告，用户可根据此报告进行修复：

问题诊断报告

问题概述： 简述用户报告的问题

环境信息：

  • 相关文件：列出所有相关文件路径
  • 错误位置：精确到文件名和行号
  • 技术栈：涉及的框架、库、版本等

根本原因分析：

  • 详细的技术解释
  • 引用关键代码片段（使用 文件路径:行号 格式）
  • 解释为什么会出现这个问题

解决方案：

方案一：[推荐/备选]

  1. 步骤一：具体操作说明

    • 需要修改的文件：文件路径
    • 修改位置：第 X 行
    • 修改内容：旧代码 → 新代码

  2. 步骤二：...

  3. 验证步骤：

    • 运行命令：具体命令
    • 预期结果：...

方案二（如有）：...

  • 优点：...
  • 缺点：...

注意事项：

  • 需要保留的代码或注释
  • 可能的副作用
  • 其他需要注意的点

执行准则

  • 仅提供分析和指导 - 本技能仅提供分析和指导，不执行代码修改
  • 基于证据 - 所有结论必须有代码或日志支持
  • 详细具体 - 方案要足够详细，让用户可以直接照着执行
  • 引用准确 - 使用 文件:行号 格式标注所有相关代码位置