Handoff 接力機制
解 Auto-compaction 規則衰減 的對策：每次 session 結束前讓 AI 寫
handoff.md（做了什麼 / 還沒做什麼 / 下次要注意什麼），下次新 session 開頭先讀。不依賴 compaction 保留記憶，改用文件接力——是 Externalized Memory 在 Claude Code 上的具體實踐。
為什麼需要 handoff
依賴 compaction： vs 依賴 handoff：
session 變長 每次主動寫狀態
→ auto-compact → 新 session 讀檔
→ CLAUDE.md 規則被丟（接近 0%） → 100% 拿回脈絡
→ AI 行為漂移 → 行為穩定
→ Compaction 是「希望 AI 自己壓重點」，handoff 是「強制把重點寫進檔案」。
一鍵設定 prompt
幫我設定 handoff 機制：在 CLAUDE.md 加上兩條規則，
第一條是每次新對話開始先讀 ~/.claude/tasks/handoff.md，
第二條是 session 結束前主動寫 handoff.md，
記錄做了什麼、還沒做什麼、下次要注意什麼。
→ Claude Code 會把規則寫進 CLAUDE.md，之後跨 session 自動運作。
handoff.md 該寫什麼
| 區塊 | 內容 |
|---|---|
| 做了什麼 | 本 session 完成的具體工作（檔案、commit、決策） |
| 還沒做什麼 | 開頭/中途想做但沒做完的（含理由：blocked / 跳過） |
| 下次要注意什麼 | 踩過的坑、發現的限制、下次接手要先看的東西 |
→ 三段對齊「過去 / 未來 / 鋪路」。
跟 vault wiki/log.md + wiki/daily/ 體系的對應
| Claude Code | 本 vault |
|---|---|
~/.claude/tasks/handoff.md | wiki/log.md + wiki/daily/YYYY/MM/YYYY-MM-DD.md |
| 每 session 寫 | 每次 ingest / repair / promote 寫 |
| 下次 session 讀 | 下次 LLM agent 進來讀 |
→ 兩者都是 Externalized Memory 的應用。
與其他概念的關係
強連結
- Auto-compaction 規則衰減 — 本 pattern 的觸發痛點
- Externalized Memory — 本 pattern 是它的 Claude Code 實作
- Memory 記憶功能 — Memory 用於「跨 session 累積偏好」，handoff 用於「跨 session 接續工作脈絡」，兩者互補
- CLAUDE.md（專案手冊） — 規則寫進 CLAUDE.md 觸發
推斷連結
- Compounding Engineering ?? — handoff 累積成 log.md 即 compounding 體現
- Plan 模式 ?? — Plan 模式產出的計畫適合存進 handoff，session 結束時 carry over