CHECKLIST · 16 條

AI agent 紀律檢查表
派工前先把驗收線拉清楚

這是我們自己每天在跑的規矩，不是整理來的心法。16 條裡每一條都配一個可以當場執行的驗法，你能拿它去戳自己的流程。 整份就在這頁，不用留 email，也不用下載任何檔案。

直接看清單 →看把這些變成護欄的工具
BEFORE DISPATCH

派工前：把「做完」定義成可以驗的東西

多數失控不是 agent 做錯，是任務從一開始就沒有可驗的完成線。

完成定義寫成檔案層的斷言，不是動詞。

怎麼驗：把「整理好報表」改寫成「這個路徑的檔案存在，而且內容含這個欄位」。寫不出來就代表還沒想清楚，先不要派。

驗收指令在派工前就寫好，跟任務一起交出去。

怎麼驗：任務單上要有一行可以直接複製貼上執行的指令。事後才想驗法，通常會挑到一個剛好會過的驗法。

一張單只放一件事。

怎麼驗：如果驗收需要兩個以上不相干的判斷，拆成兩張單。合併的單失敗時，你分不出是哪一半壞了。

EVIDENCE

證據：退出碼 0 不算證據

假綠燈幾乎都長同一個樣子。流程回報成功，產物那一端沒人去看。

跑完了跟有東西出來，要分開檢查。

怎麼驗：退出碼是流程的狀態，不是產物的狀態。排程回報成功但檔案是空的，帳面上看起來一模一樣。

檔案存在不等於寫成功。

怎麼驗：由寫入的那一端自己讀回來比對。用另一個程序確認檔案在，只證明有東西被建立，不證明內容是對的。

檔案時間只有「最後一次被寫」的意思。

怎麼驗：不要拿產物的修改時間回推某段工作何時開始。要起訖時間，就在流程裡各記一筆。

產出有沒有被用到，要去下游看。

怎麼驗：查消費端的紀錄，不是查產出端有沒有生出來。生出來沒人讀的東西，在報表上跟成功沒有差別。

REPORT

回報：已驗證跟推測要分開寫

回報寫得順，是因為推測跟事實混在同一段話裡。分開寫就會卡住，那個卡住的地方就是問題。

每個數字都要指得出它是哪一條指令跑出來的。

怎麼驗：指不出來就標未驗。標未驗不丟臉，把未驗的數字寫成結論才是。

數字要附查法與時間。

怎麼驗：同一個數字換個查法就變了，代表其中一個查法是錯的。這時候要停下來，不是挑好看的那個。

沒做的事要點名。

怎麼驗：回報結尾列出這次跳過了什麼、為什麼跳過。只講做完的部分，等於把範圍悄悄縮小。

ZERO

說「沒有」之前：先確認你查得夠寬

「查無」是最容易產生的假結論。查得比實際窄，就會查出一個很乾淨的零。

寫下「查無」之前，先確認搜尋範圍。

怎麼驗：大小寫、遞迴、名稱前綴變體各試一次。三個裡漏一個，零就是假的。

分母是零的比率不是 0%。

怎麼驗：先確認被統計的東西真的有進到統計裡。沒有樣本的 0%，跟失敗率 0% 是完全不同的兩件事。

「全部就這些」要說得出清單怎麼來的。

怎麼驗：附上實際查詢條件與命中總數。窮盡感通常來自查詢條件，不是來自世界。

REVERSIBLE

可逆性：退不回來的事不要交給自動流程

agent 可以把每一步都準備好。最後那一下不可逆的，留給人按。

刪除或覆寫之前，先打開來看。

怎麼驗：對目標路徑做一次讀取再動手。路徑打錯的代價，跟多讀一次的代價不成比例。

改設定之前，先留一份現況。

怎麼驗：改完要能用一行指令還原。還原不了的改動，就不該讓自動化自己做。

不可逆的步驟不放進自動流程。

怎麼驗：不可逆的步驟改成等人確認。

WHY NO PDF

這頁本來掛著一個下載鍵，檔案一直沒生出來

那個鍵按下去是 404。與其讓它繼續掛在那裡，不如把內容直接放上來。 上面第二組講的就是這件事：說「已完成」的時候，要有人真的去按按看。

看這套規矩跑在什麼東西上 →
NEWSLETTER

要你的 email 之前,先講清楚你會收到什麼

寄的是上面那幾個開源專案的實作紀錄。這週改了什麼、哪裡踩坑、哪個做法你可以直接抄回去用。

目前寄出 0 期。沒做出東西的那週就不寄。

看 AI agent 紀律檢查表 →

訂閱實作紀錄:這週改了什麼、哪裡踩坑、哪個做法你可以直接抄回去用。

目前寄出 0 期。沒做出東西的那週就不寄。