# Debug Workflow

> バグ調査、エラー解析、パフォーマンス問題の調査時に使用。過去の類似問題の検索やデバッグセッションの記録にも活用する。

- Skill: `shioki/debug-workflow` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add shioki/debug-workflow`
- Raw SKILL.md: https://api.skillmd.com/api/skills/shioki/debug-workflow/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- License: MIT
- Author: shioki (https://skillmd.com/u/shioki)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/shioki/debug-workflow

---


# デバッグワークフロー

問題の特定から解決、記録までのデバッグプロセス全体を支援するスキルです。

## When to Use

- バグやエラーが発生したとき
- パフォーマンス問題を調査するとき
- 過去の類似問題を検索したいとき
- デバッグセッションを記録したいとき
- 緊急時の対応フローを確認したいとき

## Instructions

### 1. 過去事例の確認

まず `references/DEBUG_TEMPLATE.md` を読み込み、過去の問題解決記録を確認してください。

### 2. デバッグプロセス

#### Step 1: 問題の特定・記録

以下の情報を整理してください:

- **発生日時**
- **環境**（開発/ステージング/本番）
- **影響範囲**
- **緊急度**（高/中/低）
- **エラーメッセージ**
- **再現手順**
- **期待動作 vs 実際の動作**

#### Step 2: 調査・分析

- 過去の類似事例を `scripts/search-sessions.sh` で検索
- ログ・スタックトレースの分析
- 関連コンポーネントの影響調査

#### Step 3: 解決策の実装

- 原因の仮説を複数立てる
- 最小限の変更で検証する
- 影響範囲を考慮したテストを実施する

#### Step 4: 記録・共有

- デバッグセッションを記録
- 根本原因と解決策を文書化
- 再発防止策を検討

### 3. セッション管理

デバッグセッションの作成（保存先: `.agents/debug-sessions/` / `.claude/debug-sessions/` / `.cursor/debug-sessions/` のいずれか検出されたもの）:

```bash
bash .agents/skills/debug-workflow/scripts/create-session.sh "問題の概要"
# （.claude/skills / .cursor/skills も検出対象）
```

過去セッションの検索:

```bash
bash .agents/skills/debug-workflow/scripts/search-sessions.sh "キーワード"
# （.claude/skills / .cursor/skills も検出対象）
```

### 4. 緊急時対応

- **1時間以内に解決できない**: チームに相談を推奨
- **システム全体に影響**: 即座にエスカレーション
- **データ損失の可能性**: 最優先で対応

### 5. アクションスキルとの連携

デバッグセッションの開始には `/start-debug` の利用を案内してください。
解決後の改善記録には `/log-improvement` を案内してください。