交接
目標：讓下一個 Agent（對此對話無任何記憶）能不問任何人、不重新推導，直接繼續工作。
開始工作時
- 完整閱讀
docs/HANDOFF.md，然後閱讀docs/handoff/LOG.md最近 3 筆記錄。 - 根據實際狀況驗證：
git status、git log --oneline -10、git branch -a，並查看公開的 Pull Requests（gh api repos/al0olo/agents-village/pulls --jq '.[].title'）。 - 若交接文件與實際狀況不一致，請相信實際狀況，先修正交接文件再開始新工作，並在日誌中說明。
- 用一兩句話向使用者說明下一步要做什麼，然後執行。
工作進行中
發生以下任一情況時，立即更新 docs/HANDOFF.md：一項工作完成、做出決定、某種方法失敗、發現環境中的奇特之處、建立或合併 PR。
工作結束（或被打斷）時
- 使用下方範本重新撰寫
docs/HANDOFF.md。它描述的是當前狀態，而非歷史：直接取代過時的行，不要一直堆疊。 - 在
docs/handoff/LOG.md最前面插入一筆註明日期的記錄（最新的在最上面）：寫明你做了什麼、為什麼做、什麼失敗了、以及相關連結。歷史記錄存放在這裡。 - 執行
scripts/check-handoff.sh，並將交接文件與工作內容一起提交。 - 最後一條訊息給使用者：哪些已完成、下一步要做什麼、以及任何需要他們決策的事項。
docs/HANDOFF.md 範本
# 交接
更新時間：YYYY-MM-DD 由 <agent/model> · 分支：<name> · 最新提交：<sha>
## 目標
一段話：目前專案試圖達成的目標。
## 狀態
- 已完成：項目（PR #n）
- 進行中：項目，停在哪個確切步驟，未提交的檔案（如有的話）
- 未開始：項目
## 下一步
單一的下一個動作，必須具體到可以立即開始執行，並附上指令。
## 待辦序列
下一步之後的有序列表。
## 待決事項（需擁有者決策）
問題、選項、我的建議。
## 注意事項
環境中的奇特之處、失敗的方法及其原因、看似錯誤但實為意圖的行為。
## 如何驗證
能用來證明當前狀態健康的指令。
## 參考資料
深入了解時需要的檔案與文件。
品質標準
- 明確指出檔案名稱、分支名稱、PR 編號、指令。不使用「如上所述」、「我們討論過的那個東西」等模糊用語。
- 記錄失敗的方法及其原因，以免有人重蹈覆轍。
- 區分你已驗證的內容與你假設的內容，並明確指出哪些是哪些。
- 保持
docs/HANDOFF.md在約 150 行以內；將歷史記錄移至日誌中。