如果你每次在 Cursor 里都要重复「先跑测试、再提交、再开 PR」的长提示词，Agent Skills 就是把这套流程写成可复用「操作手册」的开放标准——由 Anthropic 在 2025 年底推动、现已在 Cursor、Claude Code、Codex CLI、Gemini CLI 等多工具间互通。
本文面向在 Mac 上跑 OpenClaw、Hermes 或日常编码的开发者与效率工具爱好者：说明 为何需要 Skill、与 Rule 的差异、SKILL.md 字段与三级渐进加载，并给出从目录创建到触发验证的六步清单。读完应能独立写出第一个项目级 Skill，并判断何时该用裸金属 Mac 承载 7×24 Agent 工作流。
01 为什么需要 Agent Skill：从重复 Prompt 到可复用工作流
AI Agent 的演进路径大致是：聊天机器人 → 任务助理 → 具备领域流程的智能体。传统「每次对话粘贴一大段 Prompt」会遇到三类痛点：
- 无法跨对话复用：关闭会话后，部署 checklist、安全审计步骤不会自动继承。
- 上下文被占满：把整本运维手册塞进系统提示，会挤占真正写代码的 Token。
- 团队难以对齐：每人本地一份 .cursorrules 变体，评审与版本管理成本高。
Skill 解决的是「如何做一件事」的模块化：Agent 启动时只读取各 Skill 的 name 与 description（发现阶段）；任务匹配时再加载完整 SKILL.md（激活阶段）；执行中才按需读 references/ 或跑 scripts/（按需阶段）。一句话：Skill 是给 Agent 写的专项操作手册，在正确时机做正确的事。
与 MCP 的关系：MCP 连接外部 API 与工具；Skill 描述编排顺序与验收标准。二者互补，Skill 可以指导 Agent 何时调用哪条 MCP。
02 Skill 与 Rule 怎么选：对照矩阵与典型能力
很多团队把「命名规范」和「发布流水线」混在同一文件里。下表帮助拆分职责；发版或 Cursor 大版本更新后请以官方文档为准。
| 维度 | Rule | Skill |
|---|---|---|
| 加载时机 | 会话内持续生效（项目/用户级） | 相关任务时按需加载 |
| 适用场景 | 代码风格、禁止注释、Git 安全边界 | 多步工作流：部署、PR、安全审计、领域专家流程 |
| 上下文占用 | 固定占用上下文 | 发现阶段仅元数据，正文动态展开 |
| 跨工具移植 | 多为 Cursor 本地约定 | 遵循 agentskills.io 开放标准，可进 Git 仓库共享 |
| 类比 | 新人入职须知 | 专项 SOP 手册 |
Skill 还能承载：斜杠命令（/deploy）、脚本执行（Bash/Python/Node，输出回灌给 Agent）、Hooks 与 CI/CD 联动。Cursor 2.4+ 提供 /migrate-to-skills，可把部分 dynamic rules 与旧 slash commands 迁移为 Skill 目录结构。
03 SKILL.md 结构与三级渐进加载机制
推荐目录（项目级示例）：
SKILL.md
scripts/validate.py
scripts/deploy.sh
references/REFERENCE.mdYAML frontmatter 核心字段（与文件夹名一致的 name、写触发条件而非摘要的 description 为必填）：
- paths：可选 Glob，限定仅在匹配文件时 surfaced。
- disable-model-invocation：为
true时仅手动/skill-name触发，禁止自动路由。
| 级别 | 时机 | Agent 读取内容 |
|---|---|---|
| Level 1 发现 | Agent 启动 | 所有 Skill 的 name + description |
| Level 2 激活 | 任务语义匹配 | 完整 SKILL.md 指令体 |
| Level 3 按需 | 执行步骤中 | references/ 文档；scripts/ 仅输出回传，脚本本体不占 Token |
发现路径（多工具并存时以各工具文档为准）：.cursor/skills/（Cursor 项目级）、~/.cursor/skills/（用户全局）、.agents/skills/（Claude Code / Codex / Gemini CLI 等）。官方说明见下列链接，仓库或 CLI 更新后请再次打开核对。
Anthropic Engineering: Equipping agents with Agent Skills
---
name: deploy-app
description: >-
当用户需要部署、上线、切换 staging/production、
或询问 CI/CD 发布流程时使用。
paths: apps/web/**
---
## 执行步骤
1. 运行 scripts/validate.py 校验环境变量
2. 运行 scripts/deploy.sh <env>
3. 对照 references/REFERENCE.md 验收健康检查04 在 Mac 上创建第一个 Skill：六步落地清单
- 选定单一职责：例如「裸金属 Mac 交付后验收」或「Hermes Gateway 升级回滚」，避免一个 Skill 覆盖全栈。
- 创建目录：在项目根执行
mkdir -p .cursor/skills/mac-host-verify/scripts（团队共享则提交到 Git）。 - 编写 SKILL.md：
description写触发词（部署、验收、7×24、launchd 等），正文用 Gather → Act → Verify 结构，并说明为何要先校验再部署。 - （可选）添加脚本：把
sw_vers、xcode-select -p等检查放进scripts/verify.sh，Agent 只消费 stdout。 - 验证触发：新开 Agent 会话，用真实任务语句测试是否自动命中；敏感流程设
disable-model-invocation: true并仅用/skill-name调用。 - 团队推广：在 README 或内部 wiki 链接 Skill 路径；Cursor Settings → Rules 确认已被发现；大段 Rule 用
/migrate-to-skills分批迁移。
最快路径：在 Cursor Agent 输入 /create-skill 并用自然语言描述工作流，再人工收紧 description 与步骤边界。编写原则：单一职责、SKILL.md 控制在约 500 行内、详细 Schema 放 references/、全文术语一致（统一用「部署」或「发布」其一）。
05 2026 生态数据、FAQ 与 CALMVPS Mac 工作流收束
- 开放标准发布时间线：Anthropic 于 2025 年 12 月 公布 Agent Skills 为开放格式；规范与集成说明集中在 agentskills.io，Cursor 在 2.4+ 稳定支持项目级与用户级目录。
- 跨平台采用（2026 年初行业口径）：除 Cursor 外，Claude Code、OpenAI Codex、GitHub Copilot、Gemini CLI、Windsurf 等均宣称兼容或部分兼容同一 SKILL.md 结构；具体字段以各工具当前文档为准。
- 社区规模（第三方目录口径，非官方审计）：多个聚合站点称公开 Skill 条目已达数万级；安装前务必阅读 SKILL.md 与脚本内容，必要时做供应链扫描，勿盲目
npx skills add。 - 与 Hermes / OpenClaw 的衔接：Hermes 等 Agent 亦有自有 Skill 目录（如
~/.hermes/skills）；Cursor 项目 Skill 适合研发侧 PR/部署，运行时 Agent Skill 适合7×24 对话与工具链——可并存，但避免重复维护同一流程的两份正文。
FAQ 速答
- Skill 会让 Agent 变笨吗？ 不会强制覆盖模型判断；写得越清晰，行为越一致。
- 全局还是项目级？ 通用提交流程放
~/.cursor/skills/；与 CALMVPS 实例验收绑定的放仓库.cursor/skills/。 - 和 MCP 二选一吗？ 否。Skill 编排步骤，MCP 提供工具调用面。
把 Agent 工作流绑在合盖即断线的个人 Mac 上，Skill 再完善也会因进程中断而失效；绑在无 macOS 的 Linux VPS 上，则无法原生跑 Xcode、launchd 与 Metal 路径。对需要稳定 7×24、可 SSH/VNC、快速交付裸金属 Mac 来承载 OpenClaw Gateway、Hermes 常驻或团队共享 Skill 脚本的场景，CALMVPS 裸金属 Mac 租赁 通常是更优解：独占 Apple Silicon、多区域节点、按月弹性。机型见 CALMVPS 定价页。