systematic-debugging

システマティックなデバッグ

出典：obra/superpowers

概要

このスキルでは、無作為な推測を防ぎ、問題を解決する前に適切に把握するための、構造化されたデバッグ手法を紹介します。

4 段階のデバッグプロセス

フェーズ 1：再現する

修正する前に、問題を確実に再現します。

## Reproduction Steps
1. [Exact step to reproduce]
2. [Next step]
3. [Expected vs actual result]

## Reproduction Rate
- [ ] Always (100%)
- [ ] Often (50-90%)
- [ ] Sometimes (10-50%)
- [ ] Rare (<10%)

フェーズ 2：切り分ける

原因を絞り込みます。

## Isolation Questions
- When did this start happening?
- What changed recently?
- Does it happen in all environments?
- Can we reproduce with minimal code?
- What's the smallest change that triggers it?

フェーズ 3：理解する

症状だけでなく、根本原因を見つけます。

## Root Cause Analysis
### The 5 Whys
1. Why: [First observation]
2. Why: [Deeper reason]
3. Why: [Still deeper]
4. Why: [Getting closer]
5. Why: [Root cause]

フェーズ 4：修正して検証する

修正し、本当に解決したことを検証します。

## Fix Verification
- [ ] Bug no longer reproduces
- [ ] Related functionality still works
- [ ] No new issues introduced
- [ ] Test added to prevent regression

デバッグチェックリスト

## Before Starting
- [ ] Can reproduce consistently
- [ ] Have minimal reproduction case
- [ ] Understand expected behavior

## During Investigation
- [ ] Check recent changes (git log)
- [ ] Check logs for errors
- [ ] Add logging if needed
- [ ] Use debugger/breakpoints

## After Fix
- [ ] Root cause documented
- [ ] Fix verified
- [ ] Regression test added
- [ ] Similar code checked

よく使うデバッグコマンド

# Recent changes
git log --oneline -20
git diff HEAD~5

# Search for pattern
grep -r "errorPattern" --include="*.ts"

# Check logs
pm2 logs app-name --err --lines 100

アンチパターン

❌ 無作為な変更 - 「ここを変えたら直るかも……」 ❌ 証拠を無視する - 「それが原因のはずがない」 ❌ 決めつける - 証拠もなく「原因は X に違いない」と考える ❌ 最初に再現しない - やみくもに修正する ❌ 症状だけで対処を終える - 根本原因を見つけない