問題現場
跟 AI 協作久了會累積很多心得：哪種 prompt 有效、哪個坑踩過、什麼決策當時為什麼那樣選。但這些東西如果只留在對話視窗裡，其實跟沒學過差不多——痛點很快就浮現：
- 下一輪重踩坑：換一個對話、換一個任務、甚至換一個 AI，之前學到的全都不見，又從零開始。
- 經驗無法累積：心得散落各處，沒有結構，回頭根本找不到、也用不上。
要解的是：怎麼讓「協作經驗」變成會累積、會複利的資產，而不是每次重來的勞動。
最小技術背景
- AI 協作：跟 AI 工具一起完成工作（寫程式、整理資料、做簡報等）。
- 學習記錄（learning record）：把一次任務的決策、失敗、可重用做法、踩坑等，整理成固定格式的紀錄。
- durable memory：耐久、可被重複取用的記憶，相對於「只存在當下對話」的暫時記憶。
- retrieval index：一份可檢索的索引，讓需要時能快速找到相關紀錄。
系統架構與資料流
每次交付都「擠出」教訓，存成結構化紀錄、建索引，下一輪直接取用，形成回饋迴路：
flowchart LR PJ["每個專案 / 交付"] --> EX["抽取高摩擦教訓"] EX --> REC["結構化學習記錄｜固定欄位"] REC --> IDX["retrieval index 可檢索"] IDX --> NEXT["下一輪：自己 / 下一個 AI 直接取用"] NEXT --> PJ
關鍵設計決策（含取捨）
| 決策 | 選了什麼 | 否決的替代 | 為什麼 |
|---|---|---|---|
| 記憶形式 | 抽成耐久、結構化的紀錄 | 留在對話視窗 / 散落 notes | 否決：用不上，也累積不起來 |
| 寫給誰看 | 寫成「下一個 AI 能直接照用」 | 寫成「給人回顧的心得文」 | 否決：人讀得懂，agent 卻挖不出能照做的資訊 |
| 紀錄結構 | 固定欄位（決策 / 失敗 / prompt / 坑 / 驗證 / 下一步） | 自由書寫 | 否決：沒結構，之後要嘛找不到、要嘛重用不了 |
| 分型 | 依用途分成治理說明、技術手冊、視覺風格指南 | 一種格式套所有情境 | 否決：不同協作情境，需要的顆粒度根本不一樣 |
代表性技術證據
固定的紀錄結構（示意）
decision_log: # 做了哪些關鍵選擇，又為什麼這樣選
failed_attempts: # 試過、但放棄的路，還有為什麼放棄
reusable_prompts:# 真的有效、可以重複用的指令模板
gotchas: # 那些環境 / 工具才有的坑
verification: # 這次到底怎麼驗的（測試 / dry-run / 截圖 / 驗收）
next_directions: # 接下來要做什麼、還有哪些沒解關鍵在「verification」與「reusable_prompts」這兩欄——它們讓紀錄從「回顧」變成「可被下一個 agent 直接執行」。
踩過的坑
| 欄位 | 內容 |
|---|---|
| 症狀 | 學習記錄寫了不少，下一個 AI 接手時還是重踩同樣的坑 |
| 初判（猜錯） | 本來以為是「記得不夠多」，於是把紀錄寫得更長 |
| 驗證 | 讓一個新 agent 只靠舊紀錄接手，發現它讀不出可執行的資訊 |
| 根因 | 紀錄寫成「給人回顧的心得文」，沒有可被 agent 直接取用的結構 |
| 修法 | 改成固定欄位 + 可檢索 index，重點放可重用 prompt 與驗證方式 |
| 預防 | 把「新 agent 能否只靠紀錄完成接手」當成紀錄的驗收標準 |
驗證方式
- 可接手：找一個沒有上下文的 agent，只給紀錄，看它能否完成接手。
- 可檢索：用索引能快速定位相關紀錄，而不是全文翻找。
- 結構一致：每篇紀錄欄位齊全（決策 / 失敗 / prompt / 坑 / 驗證 / 下一步）。
- 驗收標準：紀錄能讓下一輪「站在上次結論上繼續」，而非重新踩坑。
可複製 SOP：留下能被下一個 AI 用的記憶
適用情境：任何會反覆與 AI 協作、希望經驗累積的工作。
不適用情境：一次性、不會再碰的任務，可不必建檔。
前置條件
- 一套固定欄位的紀錄模板。
- 一個放紀錄、可檢索的位置（索引 / 標籤）。
步驟
- 收尾即記錄：每次重大交付一結束，趁記憶還新鮮，把高摩擦的教訓擠出來。
- 填固定欄位：決策、失敗、可重用 prompt、坑、驗證、下一步。
- 為 agent 而寫：重點放「可執行」而非「可感懷」——能照做的 prompt、能跑的驗證。
- 建索引：加上標籤 / 連回生出它的那個專案，之後好找。
- 用接手測試驗收：丟給一個新 agent，讓它只靠紀錄接手，它讀不出什麼、就補什麼。
停損點
- 新 agent 只靠紀錄接不了手 → 紀錄不合格，補可執行資訊。
- 紀錄找不到、檢索不到 → 先補索引再繼續累積。
驗收標準
- 下一輪能站在上次結論上繼續；紀錄可檢索、結構一致。
回滾：紀錄模板調整時，以「接手測試通過」的版本為基準。
可複製到：任何團隊 / 個人想把 AI 協作經驗沉澱成資產的場景。
決策回放（三個月後回讀用）
- 背景：AI 協作心得若只留在對話，下一輪會重踩坑、無法累積。
- 限制：紀錄須對人與 agent 都可用；不外流真實專案機密內容。
- 考慮過但放棄：到處散落的自由 notes——被「難檢索、難重用」否決。
- 證據：固定欄位模板、retrieval index、接手測試。
- 未解：要不要讓每個 AI session 自動產出紀錄；還有跨專案的 prompt / 驗證 playbook 怎麼彙整。
作者備註： 這個其實是這整個作品集的「方法母體」——其他每個專案的學習記錄，都是這套記憶系統的實例。它最大的價值不是給我回顧，是讓下一個接手的 AI 不必重新認識我。