Tai-ch0802 系統化除錯
來源：obra/superpowers
概覽
此技能提供結構化的除錯方法，防止隨機猜測並確保在解決問題前正確理解問題。
4 階段除錯流程
階段 1：重現
修復前，可靠地重現問題。
## 重現步驟
1. [重現的確切步驟]
2. [下一步驟]
3. [預期 vs 實際結果]
## 重現率
- [ ] 始終（100%）
- [ ] 經常（50-90%）
- [ ] 有時（10-50%）
- [ ] 罕見（<10%）
階段 2：隔離
縮小範圍。
## 隔離問題
- 這是什麼時候開始的？
- 最近有什麼改變？
- 在所有環境都會發生嗎？
- 能用最少的程式碼重現嗎？
- 觸發它的最小變更是什麼？
階段 3：理解
找到根本原因，而非僅是症狀。
## 根本原因分析
### 5 個為什麼
1. 為什麼：[第一個觀察]
2. 為什麼：[更深的原因]
3. 為什麼：[再更深]
4. 為什麼：[越來越近]
5. 為什麼：[根本原因]
階段 4：修復與驗證
修復並驗證它真的被修復了。
## 修復驗證
- [ ] Bug 不再可重現
- [ ] 相關功能仍然正常
- [ ] 沒有引入新問題
- [ ] 已新增測試防止回歸
除錯檢查清單
## 開始前
- [ ] 能一致地重現
- [ ] 有最小重現案例
- [ ] 理解預期行為
## 調查期間
- [ ] 檢查最近的變更（git log）
- [ ] 檢查日誌錯誤
- [ ] 需要時增加日誌
- [ ] 使用除錯器/中斷點
## 修復後
- [ ] 根本原因已記錄
- [ ] 修復已驗證
- [ ] 已新增回歸測試
- [ ] 已檢查類似程式碼
常用除錯指令
# 最近的變更
git log --oneline -20
git diff HEAD~5
# 搜尋模式
grep -r "errorPattern" --include="*.ts"
# 檢查日誌
pm2 logs app-name --err --lines 100
反模式
❌ 隨機修改 — 「也許改這個就好了......」 ❌ 忽略證據 — 「那不可能是原因」 ❌ 假設 — 「一定是 X」但沒有證據 ❌ 不先重現 — 盲目修復 ❌ 停在症狀 — 沒找到根本原因