如果你每次让 Cursor 做部署、写测试或开 PR 都要重新粘贴一大段 Prompt，说明工作流还停在「聊天机器人」阶段。Agent Skill 是 Anthropic 在 2025 年底发布的开放标准（agentskills.io），已被 Cursor、Claude Code、Codex CLI、Gemini CLI 等 16+ 工具采纳——它把「如何做一件事」封装成可复用、按需加载的操作手册。本文面向开发者与 Mac 效率用户，给出 Skill 与 Rule 的选型对照、SKILL.md 规范、三级渐进加载机制，以及六步从零创建第一个 Skill 的落地清单；最后说明为何 7×24 常驻 Agent 工作流更适合把 Skill 脚本跑在Mac Mini 云端租赁节点上。
AI Agent 的进化路径很清晰：从聊天机器人 → 任务助理 → 具备专业领域能力的智能体。到了 2026 年，Cursor 2.4+ 已稳定支持 Skill，社区生态里已有超过 31,000 个 可安装技能包。但许多团队仍把复杂流程写在一次性 Prompt 里——这会在六个方面迅速撞墙：
重复劳动：每次部署、审计、开 PR 都要重新描述完整流程，新人 onboarding 成本极高。
上下文污染：长 Prompt 占满 Token 窗口，真正需要的代码上下文反而被挤出去。
无法跨对话复用：关闭会话后，流程知识随对话消失，团队无法沉淀。
工具边界模糊：没有结构化步骤时，Agent 容易跳过验证、误调 MCP 工具或执行顺序错乱。
跨平台不通用：写在 Cursor Rule 里的内容无法直接搬到 Claude Code 或 Codex CLI。
脚本与文档分离：部署脚本在 repo 里，操作说明在 Notion 里，Agent 无法自动关联。
Skill 的核心价值，正是把「如何做一件事」封装成可版本控制、按需加载、跨平台通用的模块。一句话定义：Skill 是给 AI Agent 写的操作手册，让它在正确的时机做正确的事——而不是每次从头教。
在 Cursor 项目里，开发者最常混淆的是 Rule（规则） 与 Skill（技能）。Rule 写在 .cursor/rules/ 里，启动时始终加载，适合命名规范、Git 提交约定、代码风格等「新人入职须知」。Skill 则按需激活，适合部署流水线、安全审计、PR 创建等多步骤工作流——更像「专项操作手册」。
| 对比维度 | Rule（规则） | Skill（技能） |
|---|---|---|
| 加载时机 | 始终加载，固定占用上下文 | 按需 / 相关时加载，动态高效 |
| 适用场景 | 持久约定（命名、风格、Git 规范） | 复杂工作流（部署、审计、开 PR） |
| 触发方式 | 自动生效于匹配文件 | Agent 自动路由 / 手动 /skill-name |
| 跨平台 | Cursor 专有格式 | agentskills.io 开放标准，16+ 工具通用 |
| 可执行脚本 | 不支持内嵌 | 可打包 scripts/，输出给 Agent 不占 Token |
| 与 MCP 关系 | 无直接关联 | Skill 编排步骤，MCP 提供外部工具调用 |
「Rule 告诉 Agent 应该像谁；Skill 告诉 Agent 应该怎么做。」
Skill 还能做什么？概括四类能力：自定义命令（用 /deploy 触发）、工作流封装（提交 → 推送 → 开 PR 一条龙）、领域知识注入（React 性能专家、安全审计专家）、Hooks 集成（与 CI/CD、密钥管理联动）。Cursor 2.4+ 内置 /migrate-to-skills，可把旧的 dynamic rules 和 slash commands 一键迁移为 Skill 格式。
每个 Skill 是一个目录，核心是必填的 SKILL.md。标准目录结构如下——文件夹名必须与 frontmatter 里的 name 一致（小写字母、数字、连字符）：
.cursor/skills/
└── deploy-app/ # 文件夹名 = skill 名称
├── SKILL.md # 核心指令（必须）
├── scripts/ # 可执行脚本（可选）
│ ├── validate.py
│ └── deploy.sh
├── references/ # 按需加载的参考文档（可选）
│ └── REFERENCE.md
└── assets/ # 静态模板、配置文件（可选）
└── config-template.json
--- name: deploy-app description: >- 当用户需要部署应用到 staging 或 production 环境时使用。 关键词：部署、发布、上线、环境切换。 paths: - "apps/web/**" disable-model-invocation: false --- # 部署应用 ## 执行步骤 1. 运行 `scripts/validate.py` 检查配置完整性，避免缺失环境变量导致启动失败 2. 执行 `scripts/deploy.sh <environment>` 3. 验证部署结果，失败时自动回滚 ## 注意事项 - production 环境需要二次确认
其中 description 是 Agent 路由的核心——必须写触发条件而非摘要。错误写法：「这个 skill 包含部署相关指令」；正确写法：「当用户提到部署、上线、切换环境时使用」。
Cursor 启动时采用三级加载，兼顾发现效率与 Token 节约：
name + description，决定哪些与当前任务相关。SKILL.md 指令体，按步骤执行。references/ 文档；scripts/ 脚本只获取输出，脚本本体不占 Token。Skill 发现路径因平台而异：Cursor 读 .cursor/skills/（项目级）与 ~/.cursor/skills/（全局）；Claude Code 兼容 .claude/skills/；Gemini CLI / Codex 读 .agents/skills/。开放标准意味着写一次、多平台复用——只需复制目录到对应路径。
最快的方式是在 Cursor Agent 对话框输入 /create-skill 并描述需求；若要手动创建或团队标准化，按下面六步走一遍即可跑通完整闭环：
定义单一职责：选一个具体任务（如「iOS 构建前检查」），避免「大而全超级 Skill」。复杂流程拆成多个 Skill 组合。
创建目录与 SKILL.md：在项目根建 .cursor/skills/ios-prebuild-check/SKILL.md，填写 frontmatter 与步骤，description 写触发词而非摘要。
添加 scripts/（可选）：把可重复执行的 Bash / Python 脚本放进 scripts/，在 SKILL.md 里说明「为什么跑这个脚本」而不只是「跑它」。
渐进披露长文档：详细 Schema、API 参考放 references/，SKILL.md 控制在 500 行以内。
验证触发：用真实任务测试——说「帮我部署到 staging」，看 Agent 是否自动加载；若不触发，优化 description 里的关键词。
提交到 Git 并共享：Skill 目录可版本控制，团队 clone 即得；全局通用 Skill 放 ~/.cursor/skills/，项目特有逻辑放 .cursor/skills/。
提示：编写高质量 Skill 遵循 Gather → Act → Verify 模式：先收集信息（读配置、查环境），再执行操作，最后验证结果。错误处理要写清楚——脚本失败时是重试、回滚还是中止。
注意：ClawHub 等社区 Skill 市场曾出现恶意技能（ClawHavoc 事件）。生产环境务必用 clawhub inspect 审计、pin 版本，并配置白名单；详见本站 ClawHub 技能安全 一文。
Agent Skills 开放标准在 2025 年 12 月由 Anthropic 发布，截至 2026 年初已有显著生态规模。以下三条数据可作为技术选型与成本决策的引用依据：
贴近 NodeMini 业务，三类 Skill 可显著降低客服与运维重复劳动：/mac-quote（设备型号 + 租期自动生成报价单）、/contract-draft（标准租赁合同草稿）、/device-check（归还前检查清单）。这些 Skill 的脚本需要在 macOS 环境 7×24 可访问——本地 MacBook 合盖即断，Linux VPS 又缺少 Xcode / Apple 工具链。
把 Skill 脚本与 Agent 常驻在远程 Mac Mini 租赁节点上，通过 SSH 触发 /deploy、跑 scripts/validate.py、再回报结果，是 2026 年 Mac 开发者工作流的自然延伸。本地笔记本只负责编辑 Skill 与审阅 diff；重脚本、长会话、Hook 监听交给云端独占 Mac——这与AI 开发者技术栈里「算力节点化」的结论一致。若你仍在本地 MacBook 上同时跑 IDE Agent + Skill 脚本 + 本地推理，风扇与内存会先成为瓶颈；Linux VPS 则缺少 macOS 原生工具链，Skill 里涉及 xcodebuild、Keychain、notarytool 的步骤无法可靠执行。对于需要Skill 脚本 7×24 常驻、又不想每年换顶配 MacBook 的团队，NodeMini 的 Mac Mini 云端租赁通常是更优解：秒级拨备、SSH 主线接入、独占算力与透明计费，让 Agent Skill 工作流与 iOS CI/CD 共用同一套稳定 macOS 基线。
MCP（Model Context Protocol）是工具调用协议，负责连接外部 API、数据库与 SaaS；Skill 是操作指南，告诉 Agent 何时、按什么顺序执行任务。两者互补——Skill 可以编排对 MCP 工具的调用，但 Skill 本身不替代 MCP 的连接能力。
Skill 是结构化指导，不是强制执行——Model 仍自主决策。写得越清晰（触发条件、错误处理、Verify 步骤），一致性越高。建议用真实任务反复测试 description 的触发词，并遵循单一职责原则。