debugging-and-error-recovery:先重現,再找根因
用重現、定位、縮小、修正與防止復發的順序處理測試、建置與正式環境錯誤。
學完會知道
- 理解 debugging-and-error-recovery 在開發流程裡負責的工作
- 判斷什麼情況適合使用 debugging-and-error-recovery
- 完成通用 Skills CLI、Codex 或 Claude Code 安裝
開始前先準備
- 可使用支援 Agent Skills 的 coding agent
- 準備一個能實際驗證的小型開發任務
這個 Skill 在做什麼
用重現、定位、縮小、修正與防止復發的順序處理測試、建置與正式環境錯誤。
為什麼有用
一看到錯誤就改第一個可疑地方,很容易讓症狀暫時消失,根因卻還在。這個 Skill 先保存證據,再縮小問題,最後用測試或監控守住修正。
適合什麼場景
- 測試突然失敗,不知道和哪次修改有關。
- 正式環境偶發錯誤,但本機無法直接重現。
- 修正過同一個 bug,幾週後又出現。
和站內相近內容的差別
AI 除錯不要先猜 的 diagnosing-bugs 要求先建立會對指定症狀變紅的快速迴圈。這個 Skill 使用較廣的五步 triage,也涵蓋建置失敗、安全回復與無法重現時的處理。
如何安裝
想先查看可選清單,可以執行:
npx skills add addyosmani/agent-skills --list
只安裝這一個 Skill:
npx skills add addyosmani/agent-skills --skill debugging-and-error-recovery
安裝完整 24 個 Skills:
npx skills add addyosmani/agent-skills
這個 Skill 的 SKILL.md 沒有引用上游根目錄的共用 references。只想使用這一個流程時,可以單獨安裝;若會串接其他開發階段,再裝整套會比較省事。
手動安裝時,先 clone 上游 repo,再把整個 Skill 資料夾放進代理使用的 skills 目錄:
git clone https://github.com/addyosmani/agent-skills.git
來源資料夾是 skills/debugging-and-error-recovery/。如果上面列出共用 references,還要保留上游的相對路徑。
Codex
Codex CLI 0.122 以上可安裝整套原生外掛:
codex plugin marketplace add addyosmani/agent-skills
codex plugin add agent-skills@agent-skills
安裝後重新開啟 session。手動指定時輸入 @debugging-and-error-recovery;也可以直接描述任務,讓 Codex 依 Skill 的 description 自動選用。
Claude Code
Claude Code 可從 marketplace 安裝:
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills
此外掛也提供 /spec、/plan、/build、/test、/review、/code-simplify 與 /ship 等流程指令。這些指令會編排對應 Skills,不代表每個指令都只使用本頁這一個 Skill。
自動啟用還是手動指定
自動優先。錯誤一出現就應停止新增功能並進入除錯流程。複雜正式環境事故則要手動補上資料範圍與操作權限。
在 Codex 手動呼叫的寫法:
@debugging-and-error-recovery
請依這個 Skill 的原始流程處理目前任務,完成後列出驗證證據。
原始來源
相關 Skill
讀完後可以直接點進去複製來試的本地 Skill。