SKILL.md
readonlyread-only
name
safe-debug
description
Rigor Debug / Rigor Audit 技能，適用於深度學習研究工作。當使用者貼上 traceback、終端機錯誤、CUDA OOM、檢查點載入失敗、形狀不符、NaN loss 症狀或訓練失敗，且希望在進行任何修補前先進行保守診斷，並將除錯修復與研究貢獻明確分開時使用。請勿用於大規模重構、推測性改寫、自動探索性修補或一般性的程式庫熟悉。
safe-debug
將此作為 Rigor Debug / Rigor Audit 技能使用。安裝後的 slug 仍為
safe-debug 以保持相容性。
使用 ../../references/agent-operating-principles.md 中的共享操作原則；此技能應引導
保守診斷，而不妨礙模型找到局部根本原因。
何時使用
- 使用者提供 traceback、終端機錯誤，或具體的訓練/推論失敗症狀。
- 使用者希望在修改程式碼前先進行診斷、縮小根本原因範圍，並獲得最小修補建議。
- 使用者希望進行安全的除錯流程，並在修改前獲得明確的人類批准。
何時不使用
- 當使用者想要廣泛的程式庫導覽，但沒有活躍的失敗狀況。
- 當任務是推測性實驗或程式碼改寫。
- 當使用者要求大規模重構或可讀性改寫。
明確界限
- 先診斷。
- 預設不修改儲存庫程式碼。
- 如果需要修補，提出最小的修復方案，並要求明確批准。
- 在中高風險變更前，建議建立儲存點或分支。
- 除錯修復不自動視為研究貢獻；如果它改變了實驗意義或可比性，請明確說明。
輸出預期
debug_outputs/DIAGNOSIS.mddebug_outputs/PATCH_PLAN.mddebug_outputs/status.json
備註
使用 references/debug-policy.md、../../references/research-rigor-principles.md 和共享的 references/research-pitfall-checklist.md。
