debugging

此技能為軟體儲存庫內的系統化調試與問題排查提供了結構化的框架。專為開發人員與 AI 代理設計，它強調透過紀律嚴明的方法來識別、隔離與解決缺陷。透過整合這些最佳實踐，團隊可以最大限度地減少根因分析所需的時間，並降低回歸錯誤的發生率。此技能適用於需要嚴格代碼品質與標準化診斷程序的環境，是 ai-rules 工具管理之專案的重要組成部分，確保 AI 代理遵循專案特定的錯誤處理規範與日誌記錄策略。

• 包含日誌驗證、重現問題、隔離問題與結果驗證的系統化診斷工作流。

• 利用二分搜尋法與分治法來縮小複雜問題範圍的最佳實踐。

• 有效記錄日誌的指南，包括如何在執行流中插入臨時診斷語句進行追蹤。

• 追蹤代碼演變與審查提交歷史以識別近期回歸錯誤的方法。

• 在開始分析之前，確保已擷取所有應用程式日誌與堆疊追蹤。

• 此技能的主要輸入為儲存庫內容，輸出則為精確、可重現的缺陷報告或修正建議。

• 執行這些規則時，務必確保環境維持乾淨狀態，以防二級錯誤掩蓋真正的根因。

• 在應用任何代碼變更之前，始終優先建立可靠的重現步驟，以避免臆測性的修復。

• 將此技能與自動化測試套件結合使用，以驗證錯誤修復不會無意間破壞現有功能。

• 適用於多種程式語言與框架，前提是儲存庫環境支援標準日誌記錄與基於 Git 的版本控制。