---
name: bug-analysis
description: 不具合発生時の体系的な解析・報告を行うスキル。現象の整理、原因分析、改善案の提示、アクションプランの策定を構造化されたフォーマットで出力する。「バグを調査して」「不具合が発生した」「エラーを分析」「問題を解析」「デバッグして」「原因を調べて」「障害報告」「バグレポート」「動かない」「おかしい」「壊れた」「落ちる」「クラッシュ」「表示が変」「エラーが出る」「bug」「error」「debug」「fix」「issue」「troubleshoot」などで発火。
---

# Bug Analysis Skill

## スキル読み込み通知

このスキルが読み込まれたら、必ず以下の通知をユーザーに表示してください：

> 💡 **Bug Analysis スキルを読み込みました**  
> 不具合の体系的な解析と報告を行います。

## When to Use

- アプリケーションで不具合が発生したとき
- エラーの原因を特定・分析したいとき
- 不具合の報告書を作成したいとき
- 複数の問題が同時に発生していて整理が必要なとき
- 修正方針とアクションプランを立てたいとき
- 「なんか動かない」「おかしな挙動をしている」とき
- 過去の修正実績を参考に類似の問題を解決したいとき

## 解析手順

不具合の報告と解析を以下の手順で行います。

### Step 1: 現象の確認

まず、以下の情報を収集します：

1. **ユーザーの報告内容**: 何が起こっているか
2. **再現手順**: どの操作で発生するか
3. **エラーメッセージ**: コンソールやUIに表示されるエラー
4. **影響範囲**: どの機能に影響があるか
5. **発生環境**: ブラウザ、OS、デバイス情報

> 💡 ユーザーが「動かない」「おかしい」など曖昧な報告の場合、まず再現手順の特定を優先する。ログ（設定モーダル → ログタブ）も確認する。

### Step 2: 概要レポートの作成

収集した情報をもとに、構造化されたレポートを作成します。概要レポート、詳細解析、アクションプランのテンプレートは以下を参照してください：

📄 **[assets/report-template.md](assets/report-template.md)**

テンプレートには以下のセクションが含まれています：
- 概要レポート（日時・深刻度・問題一覧）
- 個別不具合の詳細解析（現象・原因・改善案）
- アクションプラン（優先順序・対応手順・再発防止策）

### Step 3: 各不具合の詳細解析

テンプレートの「個別不具合の詳細」セクションに従い、各不具合について現象・原因・改善案を記述します。

### Step 4: アクションプランの策定

テンプレートの「アクションプラン」セクションに従い、優先順序を決定し、対応手順と再発防止策をまとめます。

## 本プロジェクト固有の調査リファレンス

よくある不具合の原因パターン、深刻度の判断基準、ログの活用方法、過去の修正実例は以下を参照してください：

📄 **[references/investigation-guide.md](references/investigation-guide.md)**

## 出力例

過去の不具合修正の実例は以下のドキュメントを参照してください：

- [preview-blackout-fix-v1.4.0.md](../../../Docs/preview-blackout-fix-v1.4.0.md): プレビュー黒画面修正
- [preview-pause-fix-v1.4.1.md](../../../Docs/preview-pause-fix-v1.4.1.md): プレビュー一時停止修正