log-debug-issue

log-debug-issue 技能為 VRP-Toolkit 專案的除錯生命週期提供了系統化的文件紀錄框架。它專為需要追蹤複雜問題、非預期行為以及隨機最佳化模型或 ALNS 啟發式演算法中反覆出現錯誤的開發者、研究人員及維護者所設計。透過在 .claude/DEBUG_LOG.md 中強制執行一致的紀錄格式，此代理程式能建立一個可搜尋的知識庫，有助於防止迴歸問題、加速根源分析並簡化長期維護工作。

• 捕捉結構化的問題中繼資料，包括日期、環境上下文（作業系統、Python 版本、套件版本）以及針對不穩定 ALNS 結果或隨機失敗的精確重現步驟。
• 記錄反覆的調查過程，詳列初步假設、失敗的實驗與診斷測試，這為艱難的除錯階段提供了決策流程的可視性。
• 追蹤根本原因、實作的修復方法、臨時替代方案以及長期預防策略（如單元測試或架構重構），將解決方案正式化。
• 維護「常見模式與解決方案」區塊以促進知識轉移，讓團隊成員能快速參考先前解決的問題，如匯入錯誤、索引錯誤或相依性衝突。
• 將除錯工作與專案管理橋接，確保日誌中未解決的問題能正確追蹤為 CLAUDE.md 中的阻礙事項或待辦任務。
• 建議將問題 ID 包含在 Git 提交訊息中，以便追蹤除錯工作與版本控制之間的關聯。

當出現異常（如 ALNS 演算法的非預期輸出、連續近似模型中的數值不穩定或 PDPTW 測試套件的失敗）時，使用者應觸發此技能。該技能要求使用者輸入問題描述、症狀細節以及調查結果。預期的輸出是一個符合專案規範、填入結構化 Markdown 模板的日誌條目，確保文件在所有專案模組中標準化。在除錯時，請務必將「經驗教訓」區塊填寫完整，這對於未來優化 VRP 框架至關重要。限制包含須確保所有條目皆新增至指定路徑 .claude/DEBUG_LOG.md，以維持儲存庫整潔並符合專案開發流程。