第 10 章 · 進階

除錯、重現、定位根因與卡關復原

本章目標

完成本章後，你應能在不擴大權限或變更範圍的前提下，說明自己的下一步、驗收證據與回復方法。

開始前／前置條件

保存錯誤訊息、目前 Diff、執行命令、輸入與環境；不要先清理現場。區分「預期結果」、「實際結果」和「還沒知道的事」。

操作步驟

1. 把問題縮成最小重現：起點、操作、輸入、預期、實際和頻率。
2. 要求 Agent 先列假設、對應證據和驗證順序，不直接大改。
3. 一次驗證一個假設；修正後重跑重現步驟和相鄰回歸檢查。

卡住時／失敗與復原

無法重現時不要猜修，縮小環境、輸入與時間條件；改動開始擴散時回到乾淨基線，先重新建立最小案例。

官方 Quickstart 的小型任務與檢查循環可作為除錯起點。