2026 Cursor Agent Skills 完全指南:
SKILL.md 寫法、三級載入與 Mac 工作流實戰

若你每次在 Cursor 都要重貼「先測試、再提交、再開 PR」的長提示,Agent Skills 就是把流程封裝成可複用 SOP 的開放標準,現已支援 Cursor、Claude Code、Codex CLI、Gemini CLI 等工具。

本文面向在 Mac 上跑 OpenClaw、Hermes 或日常開發的工程師:說明 Skill 價值、與 Rule 的差異、SKILL.md 欄位與三級漸進載入,並提供 六步建立與驗證清單。讀畢應能寫出第一個專案級 Skill,並判斷何時需要 7×24 裸金屬 Mac。

01 為何需要 Agent Skill:告別重複 Prompt

  • 無法跨對話複用:關閉工作階段後,部署檢查清單不會自動繼承。
  • 上下文被佔滿:整本維運手冊塞進系統提示,擠壓真正寫碼的 Token。
  • 團隊難對齊:每人一份規則變體,版控與審查成本高。

Skill 模組化「如何做一件事」:啟動時只讀 name/description;任務匹配再載入 SKILL.md;執行中才讀 references 或跑 scripts。MCP 負責工具;Skill 負責編排與驗收。

02 Skill 與 Rule 怎麼選:對照矩陣

Rule 與 Skill 對照(2026)
維度 Rule Skill
載入時機 工作階段內持續生效 相關任務時按需載入
適用場景 程式風格、Git 安全邊界 部署、PR、安全稽核等多步流程
跨工具 多為 Cursor 本地 agentskills.io 標準,可進 Git

03 SKILL.md 結構與三級漸進載入

目錄範例:.cursor/skills/deploy-app/SKILL.md。必填 frontmatter:name、寫觸發條件description

三級漸進載入
級別 時機 內容
L1 發現 Agent 啟動 各 Skill 的 name + description
L2 啟用 語意匹配 完整 SKILL.md
L3 按需 執行步驟 references/;scripts 僅輸出回傳

Cursor Agent Skills 文件

agentskills.io 開放標準

04 在 Mac 上建立第一個 Skill:六步清單

  1. 選定單一職責:例如裸金屬主機驗收或 Gateway 回滾。
  2. 建立目錄:mkdir -p .cursor/skills/mac-host-verify/scripts
  3. 撰寫 SKILL.md:description 寫觸發詞;正文採 Gather → Act → Verify。
  4. (可選)腳本:sw_versxcode-select -p 放入 verify.sh。
  5. 驗證觸發:新開 Agent 以真實任務句測試;敏感流程設 disable-model-invocation。
  6. 團隊推廣:README 連結路徑;必要時用 /migrate-to-skills 遷移舊規則。

05 2026 生態數據與 CALMVPS 收束

  • 開放標準:Anthropic 於 2025 年 12 月公布;Cursor 2.4+ 支援專案與使用者目錄。
  • 跨平台:Claude Code、Codex、Copilot、Gemini CLI 等宣稱相容,欄位以各工具文件為準。
  • 社群目錄:第三方聚合稱公開 Skill 達萬級;安裝前務必審閱腳本與權限。

個人 Mac 合蓋即斷線、純 Linux VPS 又無 macOS 原生工具鏈。需要 7×24 穩定裸金屬 Mac 承載 Gateway 與團隊 Skill 腳本時,CALMVPS 月租 通常是更優解。見 CALMVPS 定價頁