ashe-li /handoff — 跨 context 接手 prompt
當你要切換 context（開新對話 / 即將 /compact / 換機器繼續 / 隔天再戰），本 skill 掃描當前狀態與對話脈絡，產出自包含的接手 prompt——貼到任何新 context 都能無縫接手，不需要再口頭交代背景。
觸發語句範例：「給我新 context 完整需要的 prompt」「我要準備 compact 了，給我 compact 之後可以用的 prompt」「幫我整理 handoff」「我要換機器繼續，給我接手用的 prompt」。
與其他 skill 的差異：
- session 快照類工具（如 ECC 的 save-session，存整份 JSON、需配對載入）綁定特定環境；本 skill 只輸出純文字 prompt，跨環境通用
- compact 提示類工具（如 ECC 的 strategic-compact）解決何時該 compact；本 skill 解決 compact 之後怎麼接手
/update沉澱長期知識庫；本 skill 為短期接手橋樑
Step 1：偵測當前狀態（事實層）
並行收集當前環境快照（避免接手者誤判）：
git rev-parse --abbrev-ref HEAD # 當前 branch
git status --short # 未 commit 變更
git log --oneline -10 # 近期 commit
git stash list # stash 狀態
pwd # 工作目錄
額外掃描（依當前情境條件性執行）：
- 是否在 worktree：檢查
.git是檔案還是目錄 - 是否有進行中的 plan：
ls plans/active/*.md 2>/dev/null - 是否有 background process：本對話中尚未結束的
Bash run_in_background
路徑、branch、commit hash、檔名都必須記錄絕對值——接手者沒有當前對話的記憶，模糊指涉（「那個檔案」「剛剛的 branch」）會直接報廢。逐項判斷偵測到的環境項目（stash、進行中 plan、其他 untracked 檔案）是否與本次任務相關；不相關的項目要在 Step 3 環境快照中明確標註「不相關於本任務」，否則接手者可能誤判為任務遺留（例如嘗試 pop 不相關的 stash）並污染工作目錄。
Step 2：對話脈絡萃取
回顧本次對話，逐項整理以下七個區塊，作為 Step 5 完整性驗證的基準：
- 任務目標 — 使用者最初提出什麼需求？
- 當前進度 — 已完成哪些步驟？已跑過哪些指令？
- 決策脈絡 — 為什麼選 X 不選 Y？已放棄哪些方案？
- 環境快照 — branch / worktree / 修改檔案 / 進行中 plan
- 重要 context — 不會反映在 git diff 的隱含資訊（外部討論、效能數據、ticket 編號、社群共識/反面意見）
- 待辦項目 — 還沒做的事，依優先順序排列
- 立即可執行的下一步 — 接手者第一個 prompt 該下什麼？（必須具體到檔案路徑與動作）
萃取原則：
- 只記錄真正討論/做過的事，禁止揣測或補白
- 若某區塊不適用，明確標記
N/A並附理由（例：「N/A — 本次無放棄方案」） - 引用使用者原句時保留原文，不擅自改寫
Step 3：產出 Handoff Prompt
依下列模板輸出，所有區塊必須對應 Step 2 七項：
# Handoff Prompt（產出時間：{{YYYY-MM-DD HH:MM}}）
> **給接手 Claude：** 先讀完整個 prompt，再從「立即可執行的下一步」開始。
> 動手前先 `git status` 與 `git rev-parse --abbrev-ref HEAD` 確認與下方環境快照一致。
## 1. 任務目標
{{使用者原始需求，盡量保留原句}}
## 2. 當前進度
- **已完成：**
1. ...
2. ...
- **進行中：** ...
- **被擋住的事項：** {{若無則 N/A}}
## 3. 決策脈絡
- **採用：** 選 X 不選 Y，因為 ...（含依據：RFC/業界實踐/效能數據/社群共識）
- **已放棄：** 試過 A，因 B 放棄
- **反面意見/已知陷阱：** ...
## 4. 環境快照
- 工作目錄：`{{absolute path}}`
- Branch：`{{branch}}`
- Worktree：{{是 — 主 repo 在 X / 否}}
- 未 commit 變更（**本任務相關**）：
```
{{僅列出本次工作產生的變更}}
```
- 未 commit 變更（**不相關**）：{{若有與其他任務交雜的變更，列在此處避免接手者誤動，或 N/A}}
- 進行中 plan：`{{plans/active/<slug>.md}}` 或 N/A
- 進行中 plan（不相關）：{{列出與本任務無關的 active plans 提醒接手者忽略，或 N/A}}
- Stash：{{若與本任務相關列出，否則明確標註「不相關 — stash@{0}: ...」或 N/A}}
- Background process：{{列出未結束的，或 N/A}}
## 5. 重要 context（不會反映在 diff）
- Ticket：{{TICKET-XXXX / Notion URL / N/A}}
- 外部依據：{{引用過的 RFC/文件/社群討論連結}}
- 隱含知識：{{調查數據、效能比較、業界慣例}}
## 6. 待辦項目（依優先順序）
1. ...
2. ...
## 7. 立即可執行的下一步
> **直接複製以下作為第一個 prompt：**
```
{{1–2 句具體指令，含完整檔案路徑與要做的動作。
範例：「打開 /abs/path/to/file.ts 第 42 行，把 X 改成 Y，然後跑 npm test」}}
```
Step 4：輸出方式（HITL）
用 AskUserQuestion 確認輸出方式：
- 直接顯示 — 印在對話中供你複製
- 寫入檔案 — 存到
.claude/handoff/handoff-{{YYYY-MM-DD-HHMM}}.md - 兩者皆要 — 顯示 + 存檔（建議：compact 前用此選項，compact 後若 prompt 沒留下還有檔案可救）
若選 2 或 3，自動建立目錄：mkdir -p .claude/handoff
Step 5：完整性驗證
輸出後逐條比對 Step 2 的七個區塊，標記每項為 ✅（已涵蓋）/ ⚠️（缺漏，需說明建議補充方向）/ N/A。
完整率 = (✅ + N/A) / 7：
- 100%：直接交付
- < 100%：警告使用者哪些區塊缺漏
- < 70%：阻止輸出 — 對話資訊不足，要求使用者補充後重跑