handoverlisted

# Handover — Session 交接 prompt 產生器 ## Overview 把目前 session 的工作狀態濃縮成一份自包含的 handover prompt，複製到剪貼簿， 貼到任何全新 session（Claude Code、claude.ai、甚至其他工具）即可接手。 **品質標準：沒看過這個對話的人，讀完 handover 第一輪就能開始有生產力的工作， 不需要追問任何澄清問題。** 使用者可附加指示（如 `/handover 重點放在 API 設計討論` 或 `/handover 用英文`）， 附加指示優先於本文件的預設。 ## 流程 ### 1. 收集即時狀態（不要憑記憶） Repo 狀態必須現場查證，對話早期的記憶可能已過時： ```bash 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 都查得到。 ```markdown # Handover: <一行主旨> **TL;DR：**<現況一句話＋下一步一句話。讀者只看這兩句就知道處境。> ## 任務目標 <要做什麼、為什麼做。1-3 句。> ## 限制與偏好（使用者明講的，違反會返工） - <限制、範圍排除（「這次不做 X」）、工具偏好> ## 試過但失敗的路（不要重走） 1. <做法> → <失敗原因> → <已 revert / 部分保留> ## 關鍵決策 - <採用什麼、否決什麼、為什麼> ## 環境陷阱 - <接手者一動手就會踩到的事，含 檔案:行號 或指令> ## 開放問題（等使用者決定） - <問題> — <為什麼重要／候選選項>（沒有開放問題就整段刪除，連標題都不留） ## Repo 狀態（<產出時間點> 實際查證） - branch / 最近 commit / 未 commit 的變更與原因 ## 下一步（依優先序） 1. <可執行的動作，含依賴關係> ## 第一個動作 <接手後第一輪該下的具體指令或該讀的檔案。> ``` ### 4. 自檢品質關卡 產出前逐條檢查，任一條不過就修： - [ ] 只讀 handover 能否回答「現在卡在哪、第一步做什麼」？ - [ ] 失敗路徑是否完整？（漏掉＝新 session 重走死路，