04.01 Codex 出錯時怎樣定位和修復

介紹原始報錯、最小復現、修改範圍與迴歸檢查。

01 · 導讀

介紹原始報錯、最小復現、修改範圍與迴歸檢查。
適合：工作流程偶爾失敗或輸出不穩定，不知道從哪裡查的學員。

教學範例：Northstar Studio 為虛構業務，服務英國獨立咖啡店。 棉布袋 35×40cm、MOQ 100、打樣 7–10 個工作天皆為說明寫法的虛構參數；報價、運費、認證、完整交期不詳。 範例不代表真實經營成果。

02 · 相關資料

• 失敗步驟、原始報錯和輸入版本。
• 可重複問題的小樣本。
• 之前的正常參考樣本。

03 · 核心講解

報錯是證據，不是結論。 「超時」可能發生在網路、工具或執行階段，不能直接判斷模型壞了。

最小複現是把輸入縮到仍能出現相同問題的最小範圍，避免每次重跑整個流程。

讓 Codex 直接「修好所有問題」容易擴大修改範圍。 更穩健的辦法是保留報錯原文、複現步驟和相關文件，先確認失敗發生在讀取、產生、校驗或外部連接。 修復後重複原來的失敗場景，再看相鄰流程是否仍正常。

一份清楚的排錯記錄寫“腳本階段缺少 audience”，而不是“Codex 不夠聰明”。 先確認輸入有沒有目標受眾，再看欄位名稱或提示詞是否衝突，最後才考慮工具與環境。

讀取工具失敗時用自己有權限存取的固定測試資源，內容產生失敗時用一條選題和一份事實表。 縮小範圍能減少無關噪音，也避免診斷過程中重複執行外在動作。

修復後重跑原失敗場景和一個舊正常樣本。 若只能偶爾成功，記錄為暫時恢復並保留錯誤條件，不把碰巧成功當作穩定解決。

Codex 說「我已經修好」時仍要看文件差異和重跑結果；口頭解釋不是驗證證據。

會員可閱讀完整文章。 登入