lesson:把教訓寫成規則並升級
目的:讓每次糾正只發生一次。
0. 先分流:這是事實/偏好,還是規則?
- 單純事實/偏好/build 指令(「這個專案用 pnpm」「使用者偏好簡短回報」) → 交給內建 auto memory(預設開啟、自動記錄,無人工步驟),不進本流程。
- 需要變成「以後都要遵守」的規則 → 走下面 A/B 節。
A. 記錄一條新 lesson
先查重:在 tasks/lessons.md 搜尋關鍵字,已有同類條目 → 不新增,改走「B. 升級」。
用固定格式追加(檔案不存在才建立):
## [YYYY-MM-DD] <一行標題:動詞開頭>
- 觸發情境:<具體到下一個 session 能比對,含檔名/指令/使用者原話>
- 錯誤行為:<我實際做了什麼>
- 正確行為:<應該做什麼,可執行的一步步>
- 判準:<一句 if-then,讓弱模型能機械式套用>
- 狀態:first-hit
判準欄位不可空白:寫不出 if-then 表示還沒想清楚,再想。太抽象等於沒寫—— 壞例「要更小心測試」對照好例「改任何公開函式簽名前先 grep 所有呼叫端」,差別在 後者具體到下一個 session 能直接比對情境,不是換個說法重複同一句空話。
B. 升級(同一 lesson 第 2 次被觸發時)
- 把該條目的
狀態:first-hit改為狀態:promoted-to:<位置>。 - 依「制度分層」選升級目的地:
- 規則可用程式判定(如「禁止 commit 含 console.log」)→ 用 /update-config 做成 hook。最優先。
- 1–2 行寫得完、每次都適用 → 加進 CLAUDE.md 的「硬規則」,加一條前先看能否刪一條。
- 多步驟程序 → 寫成 skill,CLAUDE.md 留一行觸發指引。
- lessons.md 的原條目保留(作為升級紀錄),不刪除。
鐵則
- 糾正發生的當下就記,不要等任務結束(會忘)。
- 一條 lesson 只記一個模式;混多個就拆開。