專案交接
建立當前狀態的快照，讓新的代理能在沒有對話的情況下繼續工作。請勿自行清除對話。
1. 確認目的地
在撰寫之前確定交接目標：
- 優先使用呼叫時明確提供的目錄。請正規化路徑並確認其存在。
- 否則，從本次工作階段中實際討論、讀取、建立或編輯過的目錄與檔案中推斷候選項目。
- 僅將當前工作目錄、Codex 工作區根目錄、版本控制根目錄以及
README.md、AGENTS.md、package.json、pyproject.toml等專案標記視為信號。沒有任何一個標記本身具有權威性，且專案不一定使用 Git。 - 唯有當會話證據明確支持某一個候選項目時，才能直接進行，無需提問。
- 若目的地缺失或不明確，則顯示可能的候選項目，並提出一個簡潔的問題：
HANDOFF.md 要寫到哪個目錄？請勿猜測。
若多個獨立專案皆有變更，則偏好為每個專案分別建立 HANDOFF.md，並在撰寫前先確認各自的目的地。
2. 檢查實際狀態
在確認每個目標目錄後：
- 檢閱相關的工作階段內容，並檢查目標的結構、說明文件、關鍵文件、實作檔案與輸出結果。
- 若存在版本控制，請檢查其狀態與相關變更。若不存在，則繼續進行，不將其視為錯誤。
- 使用現有的測試或驗證證據。僅在有用時執行輕量、安全的檢查；不要安裝相依套件或對專案進行無關的修改。
- 在更新現有的
HANDOFF.md之前，請先讀取其內容。保留仍有效的資訊，取代過時的狀態，並將新完成的工作從剩餘工作區段中移出。
當檔案系統證據可得時，請勿僅依賴對話記憶。
3. 撰寫 HANDOFF.md
在 <已確認的目標>/HANDOFF.md 中建立或更新一個包含以下區段的簡潔當前狀態文件：
# 專案交接
> 更新日期：YYYY-MM-DD
> 目標：/絕對/已確認/路徑
## 當前狀態與結構
## 已完成項目
## 決策與慣例
## 剩餘工作與精確的下一步
## 陷阱與死路
## 驗證、風險與未解決問題
套用以下規則：
- 為已完成項目提供具體成果，以及相對於專案根目錄的檔案或目錄路徑。
- 記錄決策、技術選擇、風格或命名慣例及其原因。在有用時包含證據位置。
- 讓剩餘工作具備可操作性：優先級、確切的起始檔案或指令、阻礙因素，以及完成條件。
- 記錄失敗的方法及其失敗原因，避免下一個代理重蹈覆轍。
- 說明已執行的測試或檢查及其結果。明確指出哪些內容未被驗證。
- 區分觀察到的事實與會話中的聲明或推論。將不確定性標記為
待確認；絕不編造完成狀態、決策或測試結果。 - 使用絕對日期、簡潔的文字和路徑，而不是逐字稿風格的敘述。
- 絕對不要包含憑證、令牌、私人個人資訊、環境檔案內容或大量原始日誌。
- 保持文件為最新的交接快照，而不是僅追加的歷史記錄。
除非使用者明確要求其他變更，否則僅修改指定的 HANDOVER.md 檔案。
4. 驗證與回報
重新閱讀完成的檔案，並確認：
- 它位於已確認的目錄中；
- 每個必要的區段都存在；
- 下一步動作具體到足以讓新代理立即開始；
- 所有主張、路徑、日期與驗證狀態都與可得證據一致；
- 沒有敏感資訊被複製到文件中。
回報所寫入的路徑、簡短摘要，以及任何未解決的不確定性。然後停下來，讓使用者在手動執行 /clear 之前審查交接內容。