handoff

name	handoff
description	產生跨 context 接手 prompt — 萃取本次對話的目標、進度、決策、未完成項目，輸出可直接貼到新 session 或 /compact 之後使用的自包含 prompt。
allowed-tools	Bash, Read, Glob, Grep, AskUserQuestion, Write
argument-hint	["可選：focus 主題或場景描述"]

/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 完整性驗證的基準：

1. 任務目標 — 使用者最初提出什麼需求？
2. 當前進度 — 已完成哪些步驟？已跑過哪些指令？
3. 決策脈絡 — 為什麼選 X 不選 Y？已放棄哪些方案？
4. 環境快照 — branch / worktree / 修改檔案 / 進行中 plan
5. 重要 context — 不會反映在 git diff 的隱含資訊（外部討論、效能數據、ticket 編號、社群共識/反面意見）
6. 待辦項目 — 還沒做的事，依優先順序排列
7. 立即可執行的下一步 — 接手者第一個 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 確認輸出方式：

1. 直接顯示 — 印在對話中供你複製
2. 寫入檔案 — 存到 .claude/handoff/handoff-{{YYYY-MM-DD-HHMM}}.md
3. 兩者皆要 — 顯示 + 存檔（建議：compact 前用此選項，compact 後若 prompt 沒留下還有檔案可救）

若選 2 或 3，自動建立目錄：mkdir -p .claude/handoff

---

Step 5：完整性驗證

輸出後逐條比對 Step 2 的七個區塊，標記每項為 ✅（已涵蓋）/ ⚠️（缺漏，需說明建議補充方向）/ N/A。

完整率 = (✅ + N/A) / 7：

• 100%：直接交付
• < 100%：警告使用者哪些區塊缺漏
• < 70%：阻止輸出 — 對話資訊不足，要求使用者補充後重跑