2026 Cursor Agent Skill 完整指南：SKILL.md 格式、三級載入與 Mac 雲 7×24 實戰（含決策矩陣）
若你每次都要在對話裡重複「先跑測試再部署」「按公司規範寫 PR」，傳統 Prompt 會占滿上下文且無法跨專案複用——Agent Skill 把這類流程封裝成可版本管理的 SKILL.md。本文面向 Cursor / Claude Code 開發者，說明 agentskills.io 開放標準、Skill 與 Rule 的差異、三級漸進載入機制，並給出五步創建 Runbook 與「筆電 vs Linux VPS vs Mac 雲」常駐硬體決策矩陣。
目錄
1. 三個痛點：為什麼需要 Agent Skill
- 複雜 Prompt 無法複用。 部署 Runbook、安全審計清單、PR 範本每次都要貼上，團隊知識鎖在個人聊天紀錄裡，新人 onboarding 成本極高。
- 上下文被無關規則占滿。 把整本規範寫進 .cursorrules 會始終占用 Token；真正寫程式碼時，Agent 反而看不清目前檔案差異。
- Skill 與硬體形態脫節。 即便寫好 OpenClaw / Hermes 的 Skill，Gateway 仍要 7×24 常開；筆電合蓋、廉價 Linux VPS 無原生 macOS，會導致 Skill「寫了卻跑不起來」——參見 Hermes Agent 三層記憶與常駐硬體。
一句話定義：Skill 是給 AI Agent 寫的操作手冊，在正確時機按需載入，讓 Agent 做正確的事。
2. Skill 是什麼：與 Rule 的核心對比
| 對比維度 | Rule（規則） | Skill（技能） |
|---|---|---|
| 載入時機 | 會話啟動時常駐 | 相關任務出現時按需載入 |
| 適用場景 | 命名規範、程式碼風格、品牌語氣 | 多步驟工作流（部署、審計、開 PR） |
| 上下文占用 | 固定占用 | 動態高效，scripts 輸出不占正文 Token |
| 類比 | 新人入職須知 | 專項操作手冊 |
Skill 可封裝斜杠命令與腳本，並與 MCP 聯動：MCP 提供工具，Skill 編排步驟與條件。
3. SKILL.md 檔案結構與格式規範
標準目錄（相容 Cursor、Claude Code、Codex、Gemini CLI）：
最小可用 SKILL.md 範例（遵循 agentskills.io 開放標準）：
description 是路由鍵，不是摘要。 錯誤寫法：「這個 skill 包含部署相關指令」；正確寫法：寫清何時載入（觸發詞、場景、檔案路徑）。
4. 三級漸進載入機制
- 發現： 僅讀
name+description判斷相關性。 - 啟用： 載入完整
SKILL.md執行步驟。 - 按需： 拉取
references/；scripts/只回傳輸出，原始碼不占 Token。
路徑：.cursor/skills/、.agents/skills/、~/.cursor/skills/。Cursor 2.4+ 支援 /create-skill 與 /migrate-to-skills。
5. 常駐硬體決策矩陣：Skill 寫好了，跑在哪裡？
| 承載方式 | 7×24 常開 | 原生 macOS / Xcode | Skill 腳本沙箱 | 適合場景 |
|---|---|---|---|---|
| MacBook 本地 | ❌ 合蓋斷線 | ✅ | ✅ | 個人試驗、短會話 |
| Linux VPS | ✅ | ❌ 無 Apple 工具鏈 | ✅ | 純 CLI Agent、無 Metal |
| VPSMAC Mac 雲節點 | ✅ launchd | ✅ 裸機 SSH | ✅ | OpenClaw/Hermes Gateway、團隊 Skill 倉庫 |
agentskills.io 為跨平台開放標準；團隊應將專案級 Skill 納入 Git，並在 Mac 雲上驗收 Gateway——參見 OpenClaw skill-browser 部署。
6. 五步 Runbook：從 0 到第一個可上線 Skill
步驟 1 — 定義觸發場景
選高頻重複任務，把使用者話術與檔案 Glob 寫入 description。
步驟 2 — 創建 SKILL.md
mkdir -p .cursor/skills/my-skill，name 與目錄名一致。
步驟 3 — 拆分 references / scripts
詳文與可執行檢查分層，步驟中說明「為何執行」。
步驟 4 — 冒煙測試
驗證自動觸發、/my-skill 手動觸發及 disable-model-invocation 行為。
步驟 5 — 部署 Mac 雲
rsync skills 至 VPSMAC，launchd 常駐 Gateway——見 Mac 雲 Agent 節點。
7. 可引用技術要點（2026）
- 開放標準： Agent Skills 規範託管於 agentskills.io，SKILL.md 最少欄位為
name+description，可選paths、disable-model-invocation、metadata。 - Cursor 內建命令：
/create-skill互動創建；/migrate-to-skills（2.4+）遷移舊規則與 slash commands。 - 安全邊界： 從 ClawHub 引入第三方 Skill 前須審計
exec與網路權限——可複用站內 OpenClaw 生產加固 清單。
8. FAQ
Skill vs MCP？ MCP 連 API，Skill 編排流程。會僵化嗎？ 否，Model 仍自主決策。放哪？ 通用放 ~/.cursor/skills/，專案放 .cursor/skills/ 並提交 Git。
9. 結論：Skill 解決「怎麼做」，Mac 雲解決「一直做」
堆 Prompt 或塞滿 Rule 會浪費 Token、難版本化；筆電合蓋斷線，Linux VPS 無 Apple 工具鏈。Skill 把流程封進 SKILL.md，租賃 VPSMAC Mac 雲用月費換裸機 macOS 與 launchd 7×24，讓 Gateway 與 Skill 真正常開。