Community程式設計與開發github.com

mtai0524/claude-skills

系統化除錯,找出並修復根本原因,而非僅處理表面症狀。適用於任何錯誤、異常、測試失敗或非預期行為。

claude-skills 是什麼?

此技能提供了一套結構化的除錯方法論,專為 AI 代理(如 Claude Code、Cursor、Codex)設計,幫助開發者系統性地定位並修復軟體錯誤。它強調「根治」而非「應付」,要求先重現問題,再追蹤堆疊軌跡找到錯誤源頭,並驗證假設後才進行修復。修復時必須從根源著手(修改共享程式碼而非單一呼叫點),最後透過測試證明修復有效。支援任何包含錯誤、堆疊軌跡或測試失敗的場景,流程清晰可執行,適合整合至 CI/CD 或開發工作流程中。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mtai0524/claude-skills/tree/HEAD/skills/debug-root-cause

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

除根除錯

  1. 重現:取得確切的錯誤訊息、堆疊軌跡,以及能觸發該錯誤的最小步驟。若無法重現,請先告知,不要猜測。
  2. 定位:沿著堆疊軌跡找到出錯的那一行,然後往回讀取,找出不良狀態最初被建立的地方。
  3. 假設:用一句話陳述一個可能原因。透過日誌、測試或閱讀程式碼來驗證。在未確認原因之前,不做任何修復。
  4. 一次修復,從根源下手:對你修改的函式,grep 所有呼叫端;修改共享程式碼,而非逐一處理每個呼叫點。
  5. 證明它:新增或執行一個在修復前會失敗、修復後會通過的測試,並重新執行相關測試。若無測試專案,則建置受影響的專案,並在程式碼中逐步檢查失敗案例。
  6. 回報:原因、修復方式、驗證方式 — 三行。

絕不:壓制錯誤、加上盲目的 try/catch,或在未理解失敗原因前重試。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

相關技能