看懂實作05 / 20
核對依據
本頁內容
只聽 Agent 說「已經實作」是不夠的。每段實作說明後面都跟著它的依據：讀過的程式碼、跑過的測試、執行記錄和介面截圖，點開就能核對。有人問起時，你能指到具體的地方。
依據裡有什麼
在旁註裡展開「依據」。常見的材料有這幾類：
| 材料 | 顯示為 | 點選後 |
|---|---|---|
| 程式碼位置 | 函式名，或「檔名:行號」標籤 | 程式碼面板在右側打開，定位到那幾行 |
| 命令輸出，例如一次測試執行 | 標籤 | 在右側輔助欄打開完整輸出 |
| 程式碼差異（diff） | 標籤 | 在右側輔助欄打開 |
| 截圖和其他圖片 | 縮圖 | 放大查看 |
命令輸出、diff 和截圖來自 Agent 實作時留下的記錄：它在哪一輪跑了什麼命令、截了什麼圖，Noea 都儲存下來，說明可以直接引用。
查看程式碼位置
程式碼位置出現在句子中間時，通常顯示為函式或變數的名字，例如 openGrace；其餘情況顯示為「檔名:行號」的標籤，例如 grace.ts:6-18。同一條說明裡有兩個同名檔案時，標籤會帶上上一層資料夾。
滑鼠停在名字或標籤上，會顯示完整路徑、行號範圍和符號名。點選後，程式碼面板以這個檔案為範圍在右側打開，定位到所指的行。如果這個檔案仍停在某一輪實作結束時的狀態，那一輪的改動會疊在整個檔案上，方便你看清是哪一輪寫下的。右鍵選單可以以預設程式開啟、在 Finder 中顯示或複製路徑。
程式碼後來挪了位置，標籤顯示的行號和點選定位都以現在的位置為準。如果說明引用的那段程式碼已經改過，只找得到名字，標籤會變淡；檔案已刪除或所指程式碼找不到了，標籤會變淡並帶刪除線，懸停時說明原因。出現這兩種情況時，這段說明多半需要再次調查。
依據能證明到哪一步
看到一項材料時，先分清它屬於哪一種：
| 材料 | 能幫你確認什麼 | 還要留意什麼 |
|---|---|---|
| 實作程式碼或測試程式碼 | 程式碼採用了什麼邏輯，測試定義了哪些情境 | 有測試程式碼，不等於測試跑過、通過過 |
| 以前的執行結果 | 當時跑了什麼，當時的結果如何 | 之後程式碼變了，結果可能已不適用 |
| 這次解釋實際執行的驗證 | 在這次的環境和範圍內，結果如何 | 通過的情境不能代表沒覆蓋的情境 |
解釋和調查主要靠閱讀程式碼與已有材料，不會每次都重新跑測試、建置或啟動應用程式。只有讀程式碼無法確認某個影響結論的關鍵事即時，Agent 才會按需要驗證。好的依據會寫明它沒有驗證什麼，例如「沒有對接真實支付管道，扣款結果由測試替身給出」。證據不足、沒找到實作或者意圖有歧義時，依據和注意事項應該如實寫出來，而不是給出一個看似確定的結論。
也要記得：說明是一份帶證據的調查記錄，不是驗證證明。讓一個 Agent 再去檢查另一個 Agent 的實作，並不會自動得到更高的確定性。依據的價值在於你能點開核對，而不在於說明寫了「已確認」。
看截圖和介面
有些行為只看程式碼說不清，比如一條提示是否真的出現在介面上。Agent 在實作時如果截了圖，說明可以把截圖列為依據，例如「寬限期內，團隊設定頁頂部顯示一條提示」。
點選縮圖放大查看。看截圖時留意它拍的是哪個頁面、什麼狀態，以及它是哪一次執行留下的：截圖證明的是當時的介面，之後程式碼變了，介面也可能變。
逐項核對
核對依據時，可以逐項問：
- 這個引用對應的是不是這段意圖在說的事？
- 測試覆蓋的是哪種情況，邊界情況有沒有？
- 結果是否真的支援說明裡的結論？
- 依據有沒有寫明哪些情況沒有驗證？
例如寬限期的依據寫著「跑了寬限期的測試，6 個全部通過」，但注意事項裡提到「沒有測試覆蓋第 3 次重試成功的情況」。這時你知道，第 3 次重試那條路徑只有程式碼閱讀，沒有執行證明。
依據不夠時
缺少關鍵情境時，把滑鼠移到段落上，在左側點「詢問這段」，明確要求 Agent 驗證：
請補一個測試：寬限期第 6 天第 3 次重試成功，訂閱應回到正常狀態、不降級。跑完告訴我結果。
Agent 完成後，Noea 會自動解釋這一輪；如果你關閉了自動解釋，在段落左側點「調查」。新的說明會把這次執行列為依據。
說明裡的結論和依據對不上，或者你認為 Agent 理解錯了意圖，也在這裡追問，不要為了遷就程式碼去改意圖。見把談定的事寫進意圖。