القائمة
產生跨 context 接手 prompt — 萃取本次對話的目標、進度、決策、未完成項目，輸出可直接貼到新 session 或 /compact 之後使用的自包含 prompt。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | handoff |
| description | 產生跨 context 接手 prompt — 萃取本次對話的目標、進度、決策、未完成項目，輸出可直接貼到新 session 或 /compact 之後使用的自包含 prompt。 |
| allowed-tools | Bash, Read, Glob, Grep, AskUserQuestion, Write |
| argument-hint | ["可選：focus 主題或場景描述"] |
當你要切換 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 為短期接手橋樑
並行收集當前環境快照（避免接手者誤判）：
git rev-parse --abbrev-ref HEAD # 當前 branch
git status --short # 未 commit 變更
git log --oneline -10 # 近期 commit
git stash list # stash 狀態
pwd # 工作目錄
額外掃描（依當前情境條件性執行）：
.git 是檔案還是目錄ls plans/active/*.md 2>/dev/nullBash run_in_background路徑、branch、commit hash、檔名都必須記錄絕對值——接手者沒有當前對話的記憶，模糊指涉（「那個檔案」「剛剛的 branch」）會直接報廢。逐項判斷偵測到的環境項目（stash、進行中 plan、其他 untracked 檔案）是否與本次任務相關；不相關的項目要在 Step 3 環境快照中明確標註「不相關於本任務」，否則接手者可能誤判為任務遺留（例如嘗試 pop 不相關的 stash）並污染工作目錄。
回顧本次對話，逐項整理以下七個區塊，作為 Step 5 完整性驗證的基準：
萃取原則：
N/A 並附理由（例：「N/A — 本次無放棄方案」）依下列模板輸出，所有區塊必須對應 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」}}
```
用 AskUserQuestion 確認輸出方式：
.claude/handoff/handoff-{{YYYY-MM-DD-HHMM}}.md若選 2 或 3，自動建立目錄：mkdir -p .claude/handoff
輸出後逐條比對 Step 2 的七個區塊，標記每項為 ✅（已涵蓋）/ ⚠️（缺漏，需說明建議補充方向）/ N/A。
完整率 = (✅ + N/A) / 7：
本 repo 自持 agent 定義目錄索引（complexity-triage / doc-reviewer / doc-updater / tdd-guide），供 design、update 等 skill 的 general-purpose subagent 呼叫時引用定義與檢查清單；本身非直接可呼叫的 skill，不會出現在指令清單中。
萬用助手 — 自動分析情境、盤點可用資源、智慧路由至最佳 agent/skill 組合，一鍵完成複雜工作流。
開發設計 — 自動盤點可用資源，透過 Plan agent 建立完整實作計畫，輸出至 plans/active/<slug>.md 供使用者確認後才進入實作。
更新知識庫 — 依序執行文件更新、審查、context 整理、pattern 提取，將本次 session 的變更沉澱為文件與知識。
貼上 Notion URL，自動抓取頁面需求內容，串接 /design 建立實作計畫。
依 plan.md 的 Dependencies DAG 推進實作 — Python 狀態機決定下一步（非 LLM 判斷），自動串接 TaskCreate/TaskUpdate。觸發：使用者要求依 plan 推進、要求 task tracking 對齊 DAG、或抱怨 LLM 跳步漏步。