Cross Device Agent Skills Opencode — Development skill for Claude Code

跨電腦 Agent 工作流三技能（OpenCode 版）

三個全域技能，讓你在**任何一台電腦、任何一個 Agent** 之間無縫接續同一個專案。

技能	你說	它做什麼
startup	「開工」「上次做到哪」「我們繼續」	讀專案藍圖與交接檔 → 檢查 git → 告訴你上次做到哪、建議下一步
shutdown	「收工」「下班」「換電腦繼續做」	更新藍圖與交接檔 → commit + push → 確保下次打開能接上
project-init	「初始化專案」「開新專案」	依你這台電腦有的工具，自動建到最高可用層級

核心設計：三層級，有什麼用什麼

不是「全部裝好才能用」，而是**自動偵測、優雅降級**：

層級	需要	建立什麼
L1 本地	只要有資料夾	AGENTS.md（專案藍圖）＋ handoff.md（交接檔）
L2 GitHub	gh 已登入	私有 repo，版本歷史與跨電腦同步
L3 Obsidian	Obsidian MCP 可用	專案詳細筆記

**只有 L1 是必要的。** 沒裝 GitHub 就停在 L1，沒有 Obsidian 就停在 L2，技能會自己判斷並告訴你跳過了什麼。

為什麼藍圖叫 `AGENTS.md`

因為 `AGENTS.md` 是**跨 Agent 開放標準**——OpenCode、Claude Code、Codex、Gemini CLI 都讀得懂。專案層的檔案刻意用開放格式，換一個 Agent 接手也能無縫工作。

⚠️ **檔名必須全大寫。** Windows 不分大小寫，所以寫成小寫也能動；但 Mac／Linux 分大小寫，小寫的 `agents.md` 會變成「檔案明明在、Agent 卻讀不到」——這個錯誤很難察覺，因為在你自己的電腦上一切正常。

安裝

1. 放進 OpenCode 的技能目錄

git clone https://github.com/mathruffian-dot/cross-device-agent-skills-opencode.git

把 `startup/`、`shutdown/`、`project-init/` 三個資料夾複製到：

~/.config/opencode/skills/

Windows 的完整路徑是 `%USERPROFILE%\.config\opencode\skills\`。

也可以直接把這個 repo 的網址丟給 OpenCode，請它幫你裝。

2. 開啟技能權限

編輯 `~/.config/opencode/opencode.json`：

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "skill": {
      "startup": "allow",
      "shutdown": "allow",
      "project-init": "allow"
    }
  }
}

3. 重啟 OpenCode

**技能目錄是啟動時掃描的，不重啟不會生效。**

4. 驗證

在任何一個專案資料夾裡跟 OpenCode 說「**開工**」。它應該要開始找 `AGENTS.md` 與 `handoff.md`，而不是回你「請問要做什麼」。

典型的一天

早上   在 A 電腦說「開工」   → 讀到昨天的進度，接著做
傍晚   說「收工」            → 更新交接檔、push
隔天   在 B 電腦說「開工」   → pull 下來，接上昨天的進度

換 Agent 也一樣——**工作流綁在資料，不綁在 Agent**。這三個技能只是把「該讀什麼、該寫什麼」變成一句話。

其他 Agent 的版本

Agent	位置
OpenCode	本 repo
Claude Code	cross-device-agent-skills

兩者的 SOP 完全