2026 Cursor Agent Skill 完整指南：從 SKILL.md 到雲端 Mac Agent 工作流

AI Agent 的演進路徑很清晰：聊天機器人 → 任務助理 → 具備領域工作流的智慧體。當 Agent 能改程式、調 CI、連 Telegram 閘道時，瓶頸往往不在模型智商，而在上下文裡有沒有穩定、可執行的規程。

傳統「巨型 Prompt」有三類痛點：每次對話重複描述複雜流程；無關檔案與歷史擠占上下文視窗；無法跨儲存庫、跨團隊複用。Skill 把「如何做一件事」封裝成帶中繼資料的資料夾：Agent 啟動時只讀 name 與 description（約數十 Token/個），任務匹配後再載入完整 SKILL.md，執行中才拉取 references/ 或執行 scripts/ 的輸出——腳本本體不必進上下文。

• 一句話定義：Skill 是寫給 Agent 的操作手冊，讓它在正確時機做正確的事。
• 可引用資料（生態）：截至 2026 年初，社群 Skill 規模已達數萬級；Cursor Marketplace 支援一鍵安裝 Rules + Skills + MCP 組合包。
• 與本站場景：在雲端 Mac 上跑 Hermes、OpenClaw 或 Copilot 編碼 Agent 的自託管 Runner 時，專案級 .cursor/skills/ 與儲存庫 AGENTS.md 應一併版本化，避免「本機 Skill 齊全、CI Agent 裸奔」。

許多團隊把「所有約定」塞進 .cursor/rules，導致每次對話都載入大量靜態文字。對照下表可快速選型：

Skill 能做什麼？自訂 / 指令（如 /deploy）、多步驟工作流（提交 → 推送 → 開 PR）、領域知識注入、內嵌 Bash / Python / Node 腳本，以及與 Hooks、MCP 聯動。MCP 告訴 Agent「能呼叫什麼工具」；Skill 告訴 Agent「遇到這類任務按什麼順序做」——二者互補，不是取代。

標準目錄（Cursor 專案級範例）：

.cursor/skills/deploy-app/
├── SKILL.md
├── scripts/
│   ├── validate.py
│   └── deploy.sh
├── references/
│   └── REFERENCE.md
└── assets/
    └── config-template.json

description 欄位是 Agent 自動路由的核心：應寫觸發條件，而非文章摘要。錯誤範例：「這個 skill 包含部署相關指令」；正確範例：「當使用者需要部署應用、提到上線、發布到生產環境、切換 staging/production 時使用」。

• 必填：name（小寫、連字號，與資料夾名一致）、description
• 選填：paths（glob 限定檔案範圍）、disable-model-invocation: true（僅手動 /skill-name 觸發）、metadata
• 發現路徑：專案 .cursor/skills/、~/.cursor/skills/（使用者級）；Claude Code 常用 .claude/skills/；Monorepo 可在子套件內嵌套 skills 目錄，作用域隨路徑隔離

官方文件：Cursor Agent Skills；開放標準：agentskills.io。

agentskills.io 定義的載入邏輯可概括為三階段：

1. L1
   發現（啟動時）：僅載入各 Skill 的 name + description，判斷「可能與當前任務相關」。
2. L2
   啟用（匹配時）：讀取完整 SKILL.md 指令體，Agent 按步驟執行。
3. L3
   按需（執行中）：拉取 references/；執行 scripts/ 並將輸出回灌上下文（腳本原始碼通常不占 Token）。

觸發方式：預設自動（Agent 依對話判斷）；手動輸入 /skill-name；附加用 @skill-name 作參考。設 disable-model-invocation: true 時行為類似傳統 Slash Command，僅顯式呼叫才載入。

最快路徑：在 Cursor Agent 輸入 /create-skill，以自然語言描述工作流，由 Agent 產生目錄與 SKILL.md。

手動路徑：在專案根建立 .cursor/skills/your-skill-name/SKILL.md → 填寫 frontmatter 與步驟 → 在 Settings → Rules 確認已被發現 → 用真實任務測試 description 是否觸發。

遷移：Cursor 2.4+ 內建 /migrate-to-skills，可把舊的 dynamic rules 與 slash commands 轉為 Skill 包，避免 Rule 與 Skill 雙份維護。

生態已跨編輯器統一格式：同一 SKILL.md 可從 Claude Code 複製到 Cursor 的 .cursor/skills/，無需改寫法。常見類別包括：開發效率（Prompt 庫、Skill Installer）、前端（Vercel 的 React/Next 最佳實踐稽核）、工作流（PR Skill、TDD Skill）、多媒體（Remotion 影片 Skill）等。

對 Mac 使用者而言，Skill 解決的是對話內規程；7×24 在線、持久記憶、Telegram 閘道 仍需要穩定主機——這正是 Hermes 三層記憶 與 OpenClaw 本地 Agent 系列文強調的場景。把 .cursor/skills/ 提交進 Git，在獨佔雲端 Mac 上 clone 同一儲存庫，Agent 與 CI Runner 才能共享同一套 Skill 資產。

• 資料點：開放標準由 Anthropic 在 2025 年底發布，現已被 16+ 種 Agent 產品採納（含 Cursor、Claude Code、Codex、Gemini CLI）。
• 版本：Cursor 2.4+ 穩定支援；更早版本在 Nightly 預覽。
• 安全提示：安裝第三方 Skill 前閱讀 scripts/，社群 Skill 與 npm 套件一樣需要供應鏈審視。

在筆電上寫 Skill 很順，但合上蓋子閘道就斷；共用 macOS VPS 又常見頻寬抖動、超賣與長連線中斷。若你要讓 Skill 驅動的 Agent（Hermes、自託管 Runner、本地推理）持續在線，建議把執行平面遷到 NUKCLOUD 多區域裸機 Mac，與 控制台撥備 Runbook 對齊。

1. 01
   盤點工作流：列出需 Skill 化的流程（部署、PR、測試、報價單等），區分應留在 Rule 的靜態約定與應放進 Skill 的多步操作。
2. 02
   在儲存庫落地 .cursor/skills/：用 /create-skill 或手寫 SKILL.md；以真實任務句測試 description 自動觸發；提交 Git 供團隊共享。
3. 03
   在 下單頁 選擇獨佔 Apple Silicon 節點：依 Agent 需求選統一記憶體（本地推理參考 ds4 文 的 96GB 門檻）；避免共用池超賣。
4. 04
   控制台撥備與常駐：在 控制台 取得 SSH；設定 launchd 保活 Agent 閘道；同步與筆電相同的 Xcode / Node / Python 版本。
5. 05
   銜接 GitHub Agent 平面：自託管 macOS Runner 跑 Copilot 編碼 Agent / gh-aw 時，儲存庫內 AGENTS.md + Skills 一併生效；Branch Protection 保留人工審核。
6. 06
   72 小時 Soak Test：記錄 Skill 觸發命中率、腳本退出碼與長連線穩定性；若共用 VPS 曾出現隨機斷連，對照獨佔節點 P95 延遲後再決定擴租或自購 Mac Mini。

共用分鐘池式 macOS 主機難以同時滿足租戶邊界可稽核與Agent 長連線；對要把 Skill 化工作流當生產能力的團隊，NUKCLOUD 雲端 Mac 提供與自購機器相同的 macOS CLI，卻把硬體迭代與故障換機交給平台。可先造訪 定價頁 按小時驗證，再決定是否購置本機。更多主機選型見 說明中心。