debug-helper

name	debug-helper
version	1.0.0
description	除錯輔助，包裝 PAL MCP 的 debug 功能，提供系統化問題診斷
author	miles990
tags	["debugging","troubleshooting","diagnosis","error-handling"]
dependencies	{"mcp":[{"package":"pal-mcp-server","required":true,"note":"使用 pal.debug 進行診斷"}]}
interface	{"input":[{"name":"error","type":"object","description":"錯誤資訊（訊息、堆疊、上下文）","required":true},{"name":"context","type":"object","description":"相關上下文（程式碼、環境）","required":false}],"output":[{"name":"diagnosis","type":"object","description":"診斷結果"},{"name":"solution","type":"object","description":"解決方案"},{"name":"next_action","type":"string","description":"建議的下一步"}]}
triggers	[{"pattern":"執行失敗","description":"任務執行失敗時"},{"pattern":"測試失敗","description":"測試未通過時"},{"pattern":"錯誤訊息","description":"出現錯誤訊息時"}]

Debug Helper

收集錯誤 → 分析原因 → 診斷問題 → 提出解法

核心理念

┌─────────────────────────────────────────────────────────────────┐
│  不重複造輪子，直接使用 PAL MCP 的專業診斷能力                  │
│                                                                 │
│  本 Skill 職責：                                                │
│  • 收集錯誤資訊和上下文                                         │
│  • 調用 PAL debug 進行診斷                                      │
│  • 整理診斷結果                                                 │
│  • 與 smart-learning-loop 協作（失敗時學習）                    │
└─────────────────────────────────────────────────────────────────┘

使用方式

調用 PAL debug

await mcp__pal__debug({
  step: "診斷登入失敗問題",
  step_number: 1,
  total_steps: 2,
  next_step_required: true,
  findings: "初始診斷",
  hypothesis: "可能是 token 過期",
  relevant_files: [
    "/path/to/auth.js"
  ],
  model: "gemini-2.5-pro"
})

失敗類型分類

┌─────────────────────────────────────────────────────────────────┐
│  失敗類型                處理方式                                │
├─────────────────────────────────────────────────────────────────┤
│  類型 A: 知識缺口        → smart-learning-loop                  │
│  ├─ 症狀：不知道怎麼做                                          │
│  └─ 處方：搜尋技能 → 安裝 → 學習                                │
│                                                                 │
│  類型 B: 執行錯誤        → 重新檢查程式碼                        │
│  ├─ 症狀：語法錯誤、參數錯誤                                    │
│  └─ 處方：仔細檢查，修正錯誤                                    │
│                                                                 │
│  類型 C: 環境問題        → 修復環境                              │
│  ├─ 症狀：依賴缺失、版本不符                                    │
│  └─ 處方：安裝依賴、切換版本                                    │
│                                                                 │
│  類型 D: 策略錯誤        → 切換策略                              │
│  ├─ 症狀：方法不適合當前情境                                    │
│  └─ 處方：從策略池選擇其他方案                                  │
│                                                                 │
│  類型 E: 資源限制        → 優化或換方案                          │
│  ├─ 症狀：記憶體不足、API 限制                                  │
│  └─ 處方：優化資源使用、分批處理                                │
└─────────────────────────────────────────────────────────────────┘