用途:在使用者表示「收工」「下班」「準備換電腦」「同步」等結束工作並保存進度的請求時,把本次工作保存到專案已建立的多個層級,方便跨電腦、跨 Agent 交接。
主要能力(三層級):L1 本地更新 AGENTS.md 進度並整份改寫 handoff.md;L2 若專案有 .git 則 commit + push;L3 若 AGENTS.md 登記 Obsidian 路徑且目前有可讀寫 vault 筆記的工具,則寫入詳細紀錄。層級依「這個專案」實際建到哪層判斷,低層級電腦打開高層級專案時,做不到的在 handoff.md 註明,回到高層級電腦再補。
使用方式:依序執行收工 SOP。先從對話脈絡盤點本次成果,更新 AGENTS.md 的路線圖 checklist 與資料夾結構,改寫 handoff.md(含目前做到哪、目前狀態、下一步、注意事項、最後更新時間與更新者)。L2 用 git status --short 看變動,擬繁體中文 commit 訊息並給使用者過目後再 commit、push,再回填 handoff.md 的 Git push 狀態。L3 更新專案工作流程.md 的進度、更動紀錄表格與踩坑筆記。最後以層級 checklist 回報,未完成項目用 ⚠️ 或 ❌ 說明原因。
限制與注意:沒實質進度不跑同步;不自動 add untracked 新檔或敏感檔(如 .env、API key、憑證),需使用者確認;commit message 不可只寫「更新」「修改」;handoff.md 保持精簡,長篇細節放 Obsidian。所有訊息使用繁體中文,藍圖檔名固定為全大寫 AGENTS.md。Windows 加雲端硬碟資料夾內的 repo 若遇 git 寫入錯誤,可用 git config windows.appendAtomically false。若改過 ~/.config/opencode/ 全域設定或技能,需提醒使用者這些檔案不在專案 repo 內,不會被 push 帶走。