Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Development

shutdown

收工同步助手(三層級自動偵測)。當使用者說「收工」、「結束了」、「下班」、「準備換電腦」、「同步」、「先到這裡」、「換電腦繼續做」等任何要結束工作並保存進度的請求時,請一定要使用此技能。本技能會更新 AGENTS.md 進度與 handoff.md 交接檔、git commit + push、把詳細紀錄寫進 Obsidian,確保下次(或在另一台電腦、或換一個 Agent)打開能無縫接續。

mathruffian-dot · Static checks on file

Installation

Read the source and dependencies before running a command. Copying does not install or execute anything.

npx skills add mathruffian-dot/cross-device-agent-skills --skill shutdown

About this skill


name: shutdown description: 收工同步助手(三層級自動偵測)。當使用者說「收工」、「結束了」、「下班」、「準備換電腦」、「同步」、「先到這裡」、「換電腦繼續做」等任何要結束工作並保存進度的請求時,請一定要使用此技能。本技能會更新 AGENTS.md 進度與 handoff.md 交接檔、git commit + push、把詳細紀錄寫進 Obsidian,確保下次(或在另一台電腦、或換一個 Agent)打開能無縫接續。

收工同步助手(三層級)

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

層級收工動作給誰看
L1 本地更新 AGENTS.md 進度+改寫 handoff.md下一個 session 的任何 Agent、任何電腦
L2 GitHubcommit + 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,另一台電腦要手動建>

沒做到的項目用 ⚠️ 或 ❌ 並說明原因。 若本次改過 ~/.config/opencode/ 底下的全域設定或技能,要特別提醒使用者:這些檔案不在專案 repo 裡,不會被這次的 push 帶走,換電腦要自己再裝一次或另外複製。

不該做的事

  • ❌ 對「沒實質進度」的對話也跑同步
  • ❌ 沒更新 handoff.md 就收工(那是下次開工的唯一線索)
  • ❌ commit message 寫「更新」、「修改」這種沒資訊的字
  • ❌ 自動 add untracked 的新檔或敏感檔(要使用者確認)
  • ❌ 把該寫進 Obsidian 的長篇細節塞進 handoff.md(交接檔要保持一頁內讀完)

與開工(startup)的對偶關係

面向收工開工
AGENTS.md / handoff.md寫入讀出
Git 動作add + commit + pushstatus + fetch(不 pull)
Obsidian寫詳細紀錄只列路徑、需要才讀
對外副作用推 GitHub、改檔案無

注意事項

  • 所有訊息使用繁體中文
  • 專案藍圖檔名固定是全大寫 AGENTS.md(Mac/Linux 會區分大小寫)
  • Windows+雲端硬碟資料夾內的 repo,第一次操作若遇 git 寫入錯誤:git config windows.appendAtomically false