performing-systematic-debugging-for-stubborn-problems

此技能透過應用改良的 Fagan 檢查方法論，為系統化偵錯提供結構化框架。它專為面臨複雜、持續存在且多次嘗試修復仍無效的問題的開發人員所設計。透過從試誤式的「快速修復」轉向系統化的多階段分析，此工具確保透過邏輯嚴密性而非臆測來識別根本原因。

流程分為四個階段：初始概述、系統化檢查、使用「五個為什麼」技術進行根本原因分析，以及解決方案與驗證。在檢查階段，代理程式扮演閱讀者的角色，執行逐行程式碼導覽，以偵測邏輯錯誤、邊界條件失敗、錯誤的例外處理、資料流不一致以及整合點缺陷。它要求明確的推理，代理程式必須記錄每一項假設，標記不明確的部分以進行深入分析，並透過大聲思考來保持透明度。

• 執行逐行檢查以識別邏輯錯誤、控制流程問題與邊界條件缺陷。

• 實作「五個為什麼」技術，將症狀追溯至環境、並發或設計背景中的根本原因。

• 促進對預期行為與實際行為的詳細記錄，以釐清複雜的系統互動。

• 產生結構化的驗證計畫，包括具體的測試案例、手動步驟與監控策略，以確保永久解決問題。

• 作為防止「隨機偵錯」的守門員，要求在實作前必須完成分析。

• 最適合用於難以處理的錯誤、複雜的分散式系統故障，或需要深入架構理解的舊有程式碼缺陷。

• 不適用於簡單的語法錯誤、不涉及程式碼的環境配置問題，或初步的故障排除。

• 輸入需要問題背景、程式碼庫與失敗的嘗試歷史；輸出為分類後的缺陷清單、根本原因報告與驗證藍圖。

• 使用者必須在各階段之間提供明確核准，以確保品質與系統設計約束的一致性。

• 針對邏輯或整合點極為晦澀的複雜部分，運用「深度思考 (ultrathink)」能力。