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 真正常开。