交接文件
撰寫一份交接文件，讓全新的代理無須重讀整個對話即可接續當前工作。記錄狀態與意圖，而非逐字稿。
儲存位置
將交接文件儲存在當前專案儲存庫內 — 絕不要放在 OS 暫存目錄或對話中內嵌。
- 解析儲存庫根目錄：執行
git rev-parse --show-toplevel。如果失敗（非 git 儲存庫），則回退至當前工作目錄。 - 確保在該根目錄下存在
handoffs/目錄；若無則建立。 - 寫入
handoffs/<slug>-handoff-<UTC-timestamp>.md，其中：<slug>是根據任務（或如果有傳入引數，則根據引數）產生的簡短 kebab-case 主題，例如notebook-proxy-review。<UTC-timestamp>格式為YYYYMMDDTHHMMSSZ，例如20260527T144059Z。 時間戳確保每份交接文件都是唯一的 — 絕不覆蓋現有的交接文件。
- 寫入完成後，列印所建立檔案的絕對路徑。
應撰寫的內容
如果技能有傳入引數，則將這些引數視為下一階段的工作重點，並據此調整每個章節的內容。
使用以下章節。每個章節請保持在長度限制內；交接文件是指標文件，而非完整記錄。對於確實為空的章節請直接省略，不要填充。
- 標頭 — 標題、日期（UTC）以及一行說明下一階段的工作目的。（≤5 行）
- 目標 — 目標及其成功標準。（≤3 句）
- 當前狀態 — 已完成的事項、可運作的部分、已驗證 vs. 假設的部分。（≤10 條）
- 下一步驟 — 為下一個代理準備的具體、有序行動。（≤8 條）
- 關鍵決策與理由 — 已鎖定的選擇及其原因，讓下一個代理無需重新辯論。（≤8 條）
- 陷阱 / 地雷 — 已經踩到的陷阱、出乎意料的事、看似完成但實際上未完成的事。（≤8 條）
- 相關檔案與參考資料 — 指向程式碼、PRD、計畫、差異比較、問題的檔案路徑與 URL。僅引用，不要內嵌其內容。（≤12 項）
- 開放問題 — 需要使用者或後續工作解決的未決決策。（≤6 條）
- 建議技能 — 下一個代理應呼叫的技能，每個技能附上一行原因。（≤6 項）
規則
- 不要重複其他產出物（PRD、計畫、ADR、問題、提交、差異比較）中已經包含的內容。改用路徑或 URL 引用它們。
- 不要在交接文件中貼上大量檔案內容或完整命令輸出。請指向來源。
- 刪除機密與個人識別資訊 — 任何符合 API_KEY / SECRET / TOKEN / PASSWORD / PRIVATE_KEY 或個人資料的內容。本機檔案路徑則可保留。