Other memory

Handover — Session 交接 prompt 產生器

Overview

把目前 session 的工作狀態濃縮成一份自包含的 handover prompt，複製到剪貼簿， 貼到任何全新 session（Claude Code、claude.ai、甚至其他工具）即可接手。

品質標準：沒看過這個對話的人，讀完 handover 第一輪就能開始有生產力的工作， 不需要追問任何澄清問題。

使用者可附加指示（如 /handover 重點放在 API 設計討論 或 /handover 用英文）， 附加指示優先於本文件的預設。

流程

1. 收集即時狀態（不要憑記憶）

Repo 狀態必須現場查證，對話早期的記憶可能已過時：

git branch --show-current && git log --oneline -5 && git status --porcelain && git diff --stat

不在 git repo、或任務與程式碼無關（研究、寫作、BD 分析）→ 跳過， 模板的「Repo 狀態」段整段刪除——連標題都不留，不要寫「本段省略」。

2. 對話挖掘 checklist

逐項回顧整個對話，每項都要有答案（「無」也是答案）：

• 任務目標與動機 — 使用者最初要什麼、為什麼
• 目前進度 — 卡在哪、下一個動作是什麼
• 試過但失敗的路 — 每條含：做法、失敗原因、是否已 revert
• 關鍵決策 — 採用了什麼、否決了什麼、為什麼
• 使用者明講的限制與偏好 — 包含「這次不做」的範圍排除
• 環境陷阱 — 版本、設定、工具怪癖等接手者一動手就會踩到的事
• 開放問題 — 使用者還沒決定的事（方向、方案選擇）；這不是限制也不是決策，獨立列出
• 尚未完成的待辦 — 含優先順序與彼此依賴關係

3. 按模板組裝

預設繁體中文。每句話都必須是新 session 無法從程式碼、git、專案文件自行得到 的資訊——已 commit 的工作一行帶過即可，細節 git 都查得到。

# Handover: <一行主旨>

**TL;DR：**<現況一句話＋下一步一句話。讀者只看這兩句就知道處境。>

## 任務目標

<要做什麼、為什麼做。1-3 句。>

## 限制與偏好（使用者明講的，違反會返工）

- <限制、範圍排除（「這次不做 X」）、工具偏好>

## 試過但失敗的路（不要重走）

1. <做法> → <失敗原因> → <已 revert / 部分保留>

## 關鍵決策

- <採用什麼、否決什麼、為什麼>

## 環境陷阱

- <接手者一動手就會踩到的事，含 檔案:行號 或指令>

## 開放問題（等使用者決定）

- <問題> — <為什麼重要／候選選項>（沒有開放問題就整段刪除，連標題都不留）

## Repo 狀態（<產出時間點> 實際查證）

- branch / 最近 commit / 未 commit 的變更與原因

## 下一步（依優先序）

1. <可執行的動作，含依賴關係>

## 第一個動作

<接手後第一輪該下的具體指令或該讀的檔案。>

4. 自檢品質關卡

產出前逐條檢查，任一條不過就修：

• 只讀 handover 能否回答「現在卡在哪、第一步做什麼」？
• 失敗路徑是否完整？（漏掉＝新 session 重走死路，這是 handover 最貴的段落）
• 有沒有 git/程式碼查得到的冗餘細節？（有就刪）
• 「限制」「開放問題」「待辦」是否各歸其位？（限制是不能做的，開放問題是還沒決定的，待辦是要做的）
• 有沒有任何密鑰值？env var 只寫名稱不寫值；token、密碼、連線字串一律不進 handover——它會被複製到剪貼簿與其他工具，等同外流。需要憑證的步驟寫「向使用者索取」
• 路徑是否完全限定？一律絕對路徑或 ~/ 開頭，指令要能直接貼上執行；不要寫只在特定 cwd 下才成立的相對路徑
• 有沒有對話術語？不寫「我們討論過」「如前所述」——新 session 沒有「前」，直接改述內容本身

5. 交付

用 quoted heredoc 複製進剪貼簿（防變數展開與跳脫問題）：

pbcopy <<'HANDOVER_EOF'
<handover 全文>
HANDOVER_EOF

然後在回覆中完整呈現 handover 全文（剪貼簿被蓋掉時可從對話撈回）， 並告知使用者：已複製，開新 session 直接貼上即可。 pbcopy 失敗（非 macOS）→ 只呈現全文，請使用者手動複製。

Common Mistakes

錯誤	後果與修法
憑對話記憶寫 repo 狀態	早期記憶已過時 → 產出當下實際跑 git 指令
詳述已 commit 的工作	浪費篇幅，git 都查得到 → 一行＋commit 主旨帶過
省略失敗路徑	新 session 重走死路，最貴的返工 → checklist 第 3 項強制回答
限制寫成待辦	「不要做 X」被當成「去做 X」 → 限制獨立成段
heredoc 忘記 quote EOF	內文的 $、backtick 被 shell 展開 → 一律 <<'HANDOVER_EOF'
把「這次不做」的想法漏掉	接手者順手實作，超出範圍 → 範圍排除寫進限制段
未定案的事塞進限制或決策段	接手者誤以為已定案，擅自動工 → 開放問題獨立成段
密鑰值抄進 handover	剪貼簿＝外流；env var 只寫名稱，憑證寫「向使用者索取」
相對路徑	新 session 的 cwd 不一定相同 → 絕對路徑或 ~/ 開頭