SKILL.md，由 Agent 按需載入。本文面向開發者與效率工具使用者，結論包括：① Skill 與 Rule、MCP 的分工；② 符合 agentskills.io 的目錄與 frontmatter；③ 發現→啟用→執行的三級載入；④ 六步建立與遷移 Runbook；⑤ 2026 生態數據與 Mac 7×24 宿主選型。
2026 為什麼需要 Agent Skill？傳統 Prompt 的三大痛點
AI Agent 的演進路徑很清晰：從聊天機器人 → 任務助理 → 具備領域工作流的智慧體。Anthropic 在 2025 年底將 Agent Skills 發布為開放標準，Cursor 2.4+、Claude Code、Codex、Gemini CLI 等已支援同一套 SKILL.md 模式——你在 Cursor 寫的 Skill，換到 Copilot 或 Codex 往往只需改路徑。
重複勞動：每次對話都要重述多步驟流程（提交、推送、寫 PR 描述），容易漏步驟或版本不一致。
上下文污染：把整本「部署手冊」寫進 Rule，會始終佔用 Token，擠壓程式碼與 diff 的空間。
無法複用：聊天紀錄不能 Git 管理，團隊無法像共享程式碼一樣共享「Agent 操作手冊」。
Skill 的解法：把流程拆成獨立資料夾，description 負責路由，正文僅在相關任務時載入；腳本在 scripts/ 執行，腳本本體不佔上下文，只把輸出餵給 Agent。
一句話定義：Skill 是給 Agent 寫的「操作手冊」，讓它在正確時機做正確的事——與 Hermes 裡「任務後自動寫 Skill」的複利思路同源，但 Cursor 側更強調人寫規範 + 團隊 Git 協作。
社群目錄規模在 2026 年初已常被引用為三萬級以上可安裝 Skill（含 Marketplace 與第三方聚合站）；標準本身由 Anthropic 發起、Apache 2.0 程式碼與 CC-BY-4.0 文件許可，降低廠商鎖定風險。
Agent Skill 和 Rule、MCP 怎麼分工？對照矩陣
| 維度 | Rule（規則） | Skill（技能） | MCP |
|---|---|---|---|
| 載入時機 | 每次對話預設載入 | 相關任務時按需載入 | 工具呼叫時連接伺服器 |
| 適用場景 | 命名規範、禁止註解、品牌語氣 | 部署、PR、安全稽核、領域 Runbook | GitHub API、資料庫、瀏覽器 |
| 上下文成本 | 固定佔用 | 僅啟用時占滿文 | 按工具 schema 計費 |
| 類比 | 新人入職須知 | 專項操作手冊 | 電話簿 + API 插座 |
| MESHLAUNCH 側 | 儲存庫 .cursor/rules/ | .cursor/skills/ 或 .agents/skills/ | 可選掛 CI、Issue 工具 |
Rule 回答「Agent 應該一直遵守什麼」；Skill 回答「遇到這類任務時按什麼步驟做」；MCP 回答「能呼叫哪些外部能力」。
Cursor 官方建議：Rule 保持精簡高品質，偶爾才用的流程放進 Skill。內建 /migrate-to-skills（2.4+）可把歷史 dynamic rules 與 slash commands 遷到 Skill 格式，避免 Rule 膨脹。
SKILL.md 檔案結構與三級漸進載入機制
標準目錄（專案級範例）：
.cursor/skills/deploy-app/
├── SKILL.md
├── scripts/
│ ├── validate.py
│ └── deploy.sh
├── references/
│ └── REFERENCE.md
└── assets/
└── config-template.json
Monorepo 可用巢狀路徑，例如 apps/web/.cursor/skills/，Skill 僅在該子樹編輯檔案時 surfaced——類似 frontmatter 裡的 paths Glob 限定。
--- name: deploy-app description: >- 當使用者需要部署應用、提到「上線」「發布到生產環境」、 「切換 staging/production」時使用。 paths: apps/web/** disable-model-invocation: false --- # 部署應用 ## 執行步驟 1. 執行 `scripts/validate.py` 檢查環境變數完整性 2. 執行 `scripts/deploy.sh <environment>` 3. 驗證健康檢查端點回傳 200
三級載入（agentskills.io 與 Cursor 文件一致）：Level 1 發現——啟動時只讀所有 Skill 的 name + description；Level 2 啟用——任務匹配時讀完整 SKILL.md；Level 3 按需——執行中讀 references/、跑 scripts/（輸出進上下文，腳本原始碼不佔 Token）。觸發方式：自動路由、對話框 /skill-name、或 @skill-name 附加上下文；disable-model-invocation: true 時僅手動斜線命令觸發。
| 發現路徑 | 作用域 |
|---|---|
.cursor/skills/ | Cursor 專案級 |
.agents/skills/ | Claude Code / Codex / Gemini CLI |
~/.cursor/skills/ | 使用者全域（Cursor） |
~/.agents/skills/ | 跨工具全域 |
最佳實務摘要：description 寫觸發條件而非摘要；單一職責；SKILL.md 控制在約 500 行內，細節下沉 references/；步驟寫清「為什麼」以便 Agent 舉一反三；全文術語統一（只用「部署」或只用「發布」其一）。
如何建立第一個 Agent Skill？六步 Runbook
最快路徑：在 Cursor Agent 輸入 /create-skill，用自然語言描述工作流，按精靈命名並儲存到 .cursor/skills/。
手動建立：mkdir .cursor/skills/your-skill-name/，新建 SKILL.md，name 必須與資料夾名一致（小寫、數字、連字號）。
寫 description：列舉使用者會說的動詞與場景（「開 PR」「合併請求」「gh pr create」），這是自動路由的核心。
拆腳本：把可重複命令放進 scripts/，正文只寫何時跑、失敗如何回滾；路徑統一正斜線 scripts/deploy.sh。
遷移舊規則：執行 /migrate-to-skills，把 dynamic rules 與舊 slash commands 轉為 Skill，再在 Settings → Rules 確認列表。
驗收：用真實任務試觸發——若 Agent 未載入，改 description 而非加長正文；Gather → Act → Verify：先讀 git status，再執行，最後用測試或 HTTP 檢查驗證。
2026 年社群常見 Skill 類型（節選，便於選型，非背書）：開發效率——Prompt Lookup、Skill Installer、Ralph 式自主測試迴圈；前端——Vercel 系 React/Next 效能與無障礙稽核；工作流——PR Skill、TDD Skill、Skill Writer。與 OpenClaw 的 ClawHub 不同，Cursor Skill 更貼近IDE 內編碼會話；與 Hermes 自動沉澱 Skill 不同，這裡強調人審 + Git PR 的品質閘門。
2026 生態數據與 Mac 雲端 7×24 宿主：可引用硬資訊
開放標準：agentskills.io 定義 frontmatter、Markdown 正文、發現路徑；Anthropic 工程文說明 Skills 如何把「程序性知識」打包為可移植資料夾。
跨平台：同一 Skill 可在 Cursor、VS Code Copilot、Codex CLI 等載入；Microsoft Agent Framework 已提供 SkillsProvider 做發現與 run_skill_script（2026 生態報導）。
宿主與複利：若 Skill 綁定 launchd、Xcode 簽名、macOS 瀏覽器自動化或 Telegram Gateway（見Hermes 記憶篇），筆電合蓋≈60% 可用性體感，會打斷 Skill 與 Cron 的複利；M4 閒置約 4–6W、Gateway 典型 15–25W，適合常年開機。
貼近 MESHLAUNCH 業務的設想：客服或營運可把「設備型號 + 租期 → 報價單」「標準合約草稿」「歸還檢查清單」做成專案級 Skill，在租來的 Mac Mini 上與 Cursor Agent 同機執行，避免個人筆電權限與休眠問題。純 Linux VPS 能跑通用 Skill，但缺 macOS 專屬路徑；樹莓派 I/O 與記憶體則不適合瀏覽器類 Skill。
若你需要在雲端 Mac 上 7×24 驗證 Skill + Gateway + 本地模型路由，MESHLAUNCH 的 Mac Mini M4 裸金屬月租通常是更優解：獨占 Apple Silicon、SSH 與本地同款目錄結構、退租前可打包 .cursor/skills 與 Agent 狀態目錄遷移。先看租用價格頁按日試跑；維運邊界見雲端說明中心。對比「只用免費雲端 IDE」：免費層往往無持久 daemon、無自訂 launchd，長時 Skill 複利仍要可控宿主機與穩定頻寬。
MCP 連接外部 API 與工具；Skill 是操作指南，告訴 Agent 何時、按何步驟呼叫這些工具。兩者互補，Skill 正文可寫明「先 MCP 拉 Issue，再 gh pr create」。
Skill 是結構化指導，模型仍自主決策。description 越貼近真實使用者措辭，觸發越穩；production 步驟建議寫清失敗回滾。可在下單頁租隔離環境做破壞性測試。
通用工作流（提交程式碼、寫測試）放 ~/.cursor/skills/；儲存庫特有流程放 .cursor/skills/ 並提交 Git。Cursor 2.4+ 穩定支援，早期功能在 Nightly 預覽。更多部署問題見雲端說明中心。