# 体系的デバッグ (systematic-debugging)

> 根本原因の調査、パターン分析、仮説検証、実装の4段階でバグに取り組み、症状ではなく原因を直します。

- カテゴリ: [テスト・デバッグ](https://www.myskills.tools/ja/categories/testing-debugging/)
- 提供元: コミュニティ · Jesse Vincent
- リポジトリ: https://github.com/obra/superpowers/tree/main/skills/systematic-debugging (commit bb92a77)
- SKILL.md: https://github.com/obra/superpowers/blob/main/skills/systematic-debugging/SKILL.md
- インストールコマンド: `npx skills add obra/superpowers --skill systematic-debugging`
- ライセンス: MIT
- 対応ツール: Claude Code, Codex, Cursor, Gemini CLI, OpenCode
- 権限: read-repo ✓, write-files ✓, shell ✓, network ✗
- 状態: スキャン済み
- ルールスキャンですべてのリスクを検出できるわけではありません。インストール前にこのスキルの SKILL.md を読み、権限を確認してください。

## 基本ルール

根本原因の調査を終えるまで、いかなる修正も行わないこと。

## 実行フェーズ

1. **根本原因を調査** — エラーを最後まで読み、確実に再現し、最近の変更を確認します。複数コンポーネントでは境界ごとに診断ログを入れ、不正な値の出どころを遡ります。
2. **パターン分析** — コードベース内で動いている類似コードを探し、参照実装を全部読み、壊れたコードとの違いをすべて挙げます。
3. **仮説と検証** — 仮説を1つ明確に書き、最小の変更で1変数ずつ検証します。外れたら新しい仮説を立て、修正を重ねません。
4. **根本原因を修正** — 再現する失敗テストを先に書き、1つだけ修正して検証します。3回失敗したら止まり、アーキテクチャを人と議論します。

## 権限の説明（SKILL.md より）

| 機能 | 必要か | 説明 |
|---|---|---|
| ファイル書き込み | 必要 | 診断ログの追加、失敗テストの作成、単一の修正ができます。 |
| コマンド実行 | 必要 | 問題の再現、テストの実行、git diff や最近のコミットの確認を行います。 |
| 外部通信 | 不要 | 手順にネットワークアクセスはありません。 |

## SKILL.md のフロントマター（YAML）

```yaml
---
name: systematic-debugging
description: Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes
---
```

ホーム: https://www.myskills.tools/ja/ · URL: https://www.myskills.tools/ja/skills/systematic-debugging/