systematic-debugging

systematic-debugging 技能旨在防止在處理複雜軟體問題時應用臨時補丁的常見工程反模式。透過強制執行嚴格的調查階段序列，該技能確保代理程式能識別錯誤的根本來源，而非僅僅掩蓋症狀。它適用於在可靠性至關重要的環境中工作的軟體開發人員與編碼代理。當發現測試失敗、生產環境錯誤、非預期的執行期行為或效能回歸時，該技能會自動觸發，強制執行「根本原因優先」的方法。

• 第一階段：進行全面的調查，包括堆疊追蹤分析、一致的重現步驟、近期 git 提交的差異分析，以及多組件邊界檢測。

• 第二階段：透過將損壞的程式碼與工作參考進行比較來進行模式分析，以識別微小的環境或邏輯差異。

• 第三階段：採用科學方法進行假設制定，要求在執行單變量測試前記錄推理過程。

• 第四階段：執行有針對性的修復，如果超過三次嘗試仍無法解決問題，內建架構評估的護欄機制會介入。

• 對於任何技術問題（包括 CI/CD 失敗、整合問題與競態條件）皆須強制使用。

• 要求基於證據的除錯：代理程式在提出變更前，必須記錄每個邊界（例如 API 層、資料庫查詢、建置腳本）的發現。

• 透過要求在多次嘗試修復無效時轉向架構審查，防止無效的開發循環。

• 與測試驅動開發 (TDD) 及其他 Superpowers 技能無縫整合，確保每次修復皆由先失敗後成功的測試案例驗證。

• 結合追蹤技術來定位損壞數據值的根源，確保修復發生在源頭而非僅在失敗點。