若你每次在 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 |
|---|---|---|
| 載入時機 | 工作階段內持續生效 | 相關任務時按需載入 |
| 適用場景 | 程式風格、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 僅輸出回傳 |
04 在 Mac 上建立第一個 Skill:六步清單
- 選定單一職責:例如裸金屬主機驗收或 Gateway 回滾。
- 建立目錄:
mkdir -p .cursor/skills/mac-host-verify/scripts - 撰寫 SKILL.md:description 寫觸發詞;正文採 Gather → Act → Verify。
- (可選)腳本:將
sw_vers、xcode-select -p放入 verify.sh。 - 驗證觸發:新開 Agent 以真實任務句測試;敏感流程設 disable-model-invocation。
- 團隊推廣: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 定價頁。