shutdown

收工同步助手（三層級）

對話結束前，把這次的工作保存到專案建到的每一層：

層級	收工動作	給誰看
L1 本地	更新 AGENTS.md 進度＋改寫 handoff.md	下一個 session 的任何 Agent、任何電腦
L2 GitHub	commit + push	版本歷史＋雲端備份
L3 Obsidian	詳細紀錄寫進 專案工作流程.md	未來需要完整脈絡的自己

核心原則

1. 開工是「讀」、收工是「寫」——handoff.md 是收工的必寫項，這是跨電腦／跨 Agent 交接的生命線
2. 不在 vacuum 中執行——先從對話脈絡盤點今天做了什麼
3. 只動需要動的——沒實質進度（只是問問題、沒改檔案）就不跑同步
4. 有疑問先問人——commit 前先給訊息草稿等點頭；不確定要不要 add 的檔案先問
5. 精簡與詳細分家——handoff.md 只放交接必需資訊，完整脈絡（決策原因、踩坑細節）寫 Obsidian，兩邊不重複

層級偵測（收工看「這個專案」建到哪層）

• L1：專案有 AGENTS.md／handoff.md → 更新（沒有就提議先跑「初始化專案」）
• L2：專案有 .git → commit + push
• L3：AGENTS.md 登記了 Obsidian 路徑，且目前有可用的 Obsidian MCP 工具（能讀寫 vault 筆記的工具）→ 寫詳細紀錄

判斷 L3 請看你手上實際有哪些工具，不要假設特定工具名稱。 低層級電腦打開高層級專案：做得到的照做，做不到的在 handoff.md 註明（例：「本次在無 Obsidian 的電腦收工，L3 筆記未更新」），回到高層級電腦時補。

收工 SOP（依序執行）

L1：更新藍圖與交接檔（永遠執行）

1. 盤點本次成果：從對話歷史摘要——完成了哪些檔案、做了什麼決定、踩了什麼坑
2. 更新 AGENTS.md：
   • 路線圖 checklist：勾掉完成項、新增發現的待辦
   • 「資料夾結構」有新增檔案就補
3. 改寫 handoff.md（整份重寫，不是往下堆）：
   • ⏯️ 目前做到哪：本次最後完成的動作
   • 🚦 目前狀態：可運行？哪些做一半？
   • ➡️ 下一步：具體、可執行的 1-3 項
   • ⚠️ 注意事項：新踩的坑、暫時 workaround
   • 🕐 最後更新：時間＋更新者（Agent 名 @ 電腦名）＋ Git push 狀態（先寫「待推」，L2 完成後回填）
     • 電腦名取得方式：Windows（PowerShell）用 $env:COMPUTERNAME；Mac／Linux 用 hostname

L2：git 同步（專案有 .git 才做）

1. git status --short 看變動 → 擬繁體中文 commit 訊息（標題：動詞＋對象；正文 3-5 條 bullet 描述變動＋為什麼）→ 給使用者過目，點頭再 commit
2. commit → git push
3. 回填 handoff.md 的 Git push 欄：成功 → ✅ 已推；失敗 → ❌ 未推（原因），並在回報中特別提醒（沒推成功，另一台電腦就拿不到 GitHub 備份）
4. 不要 add：.env、API key、憑證檔、untracked 的不明新檔（先問）

L3：Obsidian 詳細紀錄（可用才做）

1. 更新 <你的 vault>/<專案資料夾名>/專案工作流程.md：
   • 「⏯️ 上次做到哪」段：同步 handoff 摘要
   • 「🗓️ 最近更動紀錄」表格：加一行（日期＋摘要＋同步狀態）
   • 「🕳️ 踩坑筆記」：有新坑就依分類補（含原因與解法，這裡寫詳細版）
   • 決策紀錄：本次做了什麼取捨、為什麼（handoff 不放這些，放這裡）
2. 表格超過 30 行 → 提醒使用者歸檔到 歷史日誌.md

回報（層級 checklist）

✅ L1 本地：AGENTS.md 進度已更新、handoff.md 已改寫（更新者：<Agent> @ <電腦名>）
✅ L2 GitHub：<repo> 已 commit + push（<commit 標題>）
✅ L3 Obsidian：專案工作流程.md 已補紀錄
⚠️ 手動處理：<例：本次新增了 ~/.xxx_api_key，另一台電腦要手動建>