startup

開工接續助手（三層級）

新對話開始時，幫使用者快速進入「上次做到哪」的脈絡，避免從零開始解釋。

核心原則

1. 開工是「讀」、收工是「寫」——本技能只讀、只報告，不改任何檔案
2. 不主動 git pull（避免覆蓋本地未 commit 變動，只提醒「要不要 pull」）
3. 30 分鐘內 fetch 過就跳過（避免單台多對話冗餘）
4. Obsidian 有需要才讀——L3 筆記是詳細背景資料，開工預設不讀、只列出路徑
5. 跟收工（shutdown）技能是對偶關係：收工存進去、開工讀出來

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

• L1：專案有 AGENTS.md／handoff.md → 讀
• L2：專案有 .git → 做 git 檢查
• L3：AGENTS.md 同步層級表登記了 Obsidian 路徑，且目前有可用的 Obsidian MCP 工具（例如能列出 vault 目錄、讀寫筆記的工具）→ 列出筆記路徑（不主動讀）

判斷 L3 時請看「你手上實際有哪些工具」，不要假設特定的工具名稱——不同的 Obsidian MCP 名稱不一樣。 注意：偵測依據是「專案有什麼」，不是「電腦有什麼」。低層級電腦打開高層級專案時做得到的照做、做不到的註明（優雅降級）。

開工 SOP（依序執行）

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

1. 讀 AGENTS.md：專案目標、路線圖進度、工作約定（摘要，不全文倒出）
2. 讀 handoff.md：上次做到哪、目前狀態、下一步、注意事項
3. 檢查「最後更新」欄：
   • 取得這台電腦的名稱——Windows（PowerShell）用 $env:COMPUTERNAME；Mac／Linux 用 hostname
   • 若更新者的電腦名 ≠ 這台電腦 → 特別標示「⚠️ 上次在另一台電腦（名稱）收工」，並確認雲端硬碟同步已完成（看 handoff.md 的檔案時間戳是否與交接檔內寫的時間吻合；若本地檔案明顯過舊，提醒等雲端同步完再開工）
   • 若 handoff.md 的更新時間比 AGENTS.md 舊很多 → 提醒「上次可能沒有正式收工」

Fallback（舊專案相容）：若專案沒有 AGENTS.md／handoff.md：

• 有 Obsidian MCP → 改讀 <你的 vault>/<專案資料夾名>/專案工作流程.md 或 工作筆記.md 的「上次做到哪」段
• 讀完提議：「這個專案還沒有 AGENTS.md＋handoff.md，要不要用『初始化專案』補建？」（提議即可，不主動建）

L2：git 檢查（專案有 .git 才做）

1. 本地狀態：git status --short
   • clean → 「本地工作區乾淨」
   • 有未 commit 變動 → 列出，提醒「上次有未完成的修改，要繼續還是放棄？」
2. 遠端狀態（30 分鐘規則）：
   1. 先看 .git/FETCH_HEAD 的最後修改時間（用你手上的檔案工具讀取時間戳即可，不要用只有某個平台才有的 shell 語法）
   2. 檔案不存在，或距離現在超過 30 分鐘 → 執行：

      git fetch origin
      

   3. 再看落後幾個 commit：

      git rev-list --count "HEAD..@{u}"
      

      引號不能省：PowerShell 會把沒加引號的 @{...} 當成 hashtable 語法而報錯。 若回報「沒有上游分支」之類的錯誤 → 視為 0，並在報告註明「尚未設定上游分支」。

   4. 落後 > 0 → 提醒「遠端有 N 個新 commit，要 git pull 嗎？」不主動 pull
3. 交叉比對防呆：若 handoff.md 寫「Git push：✅」但遠端沒有對應的新 commit → 警告「上次收工可能沒推成功，建議先確認再動工」

L3：Obsidian 筆記（有登記才列，不主動讀）

1. 在報告中列出筆記路徑（例：<專案資料夾名>/專案工作流程.md），註明「需要詳細背景時我再去讀」
2. 只有兩種情況才主動讀：handoff.md 的「下一步」明確指向筆記內容，或使用者要求