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 |
|---|---|---|---|
| 加载时机 | 每次对话默认加载 | 相关任务时按需加载 | 工具调用时连接 Server |
| 适用场景 | 命名规范、禁止注释、品牌语气 | 部署、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 预览。更多部署问题见帮助中心。