搜「Claude Skills」会看到 Anthropic 文档,搜「Agent Skills」会跳到 agentskills.io,再在 Cursor 里翻「Rules」——三个名字都带 Skill/Rule,很多人第一反应是「是不是同一套东西换了个文件夹」。实际上它们分属三层:Cursor Rules 是 IDE 常驻家规,Claude Skills 是 Claude Code 里的按需 Runbook 产品能力,Agent Skills 则是跨工具共享的 SKILL.md 开放格式。下文用统一字段对比、场景矩阵和可复制示例,帮你把命名混乱一次性理顺。非对称结论:分水岭在「常驻约束 vs 按需手册 vs 格式公约」,不在模型谁更强。
本文面向同时在用 Cursor 与 Claude Code 的开发者,厘清三者定义、文件路径、加载时机、可移植性与常见混用坑;并说明与站内《Workflow / Rules / Skills 三层工程化》一文的关系——那篇讲「怎么分层搭工作流」,本篇专讲「三个热搜名词各自是什么」。官方参考:Cursor Rules、Claude Code Skills、Agent Skills Specification。
1. 为什么 Claude Skills、Agent Skills、Cursor Rules 总被混在一起?
2025 下半年到 2026 年,AI 编程工具不约而同推出「可版本化的 Agent 配置」:Cursor 强化 .cursor/rules 与 .cursor/skills,Anthropic 在 Claude Code 里推广 .claude/skills,社区又推动 agentskills.io 作为跨宿主标准。三股力量几乎同时出现,营销话术都含「Skill」「Agent」,中文社区翻译也不统一,于是出现典型困惑:
- 把 30 步发布流程写进 Cursor Rules,每次对话都背着几千 token;
- 在 Claude Code 里找「Rules 面板」,发现产品叫 Skills;
- 下载别人分享的
SKILL.md,不知道放.cursor还是.claude; - 以为「Agent Skills」是某个新 SaaS,其实是文件格式规范。
根因是产品层、实现层、标准层叠在一起命名。若你已读过AI Coding Workflow、Rules、Skills 完整解析,可把它当作「工作流架构」;本篇是「名词对照表 + 决策手册」,两者互补、不重复。
2. 三者分别是什么?(What)
2.1 Cursor Rules — 始终加载的约束层
Cursor Rules 是 Cursor IDE 的常驻策略:打开匹配项目时自动注入上下文。常见位置包括项目 .cursor/rules/*.mdc、用户 Settings 里的 Rules、以及根目录 AGENTS.md。适合写:最小 diff、禁止改哪些目录、回复语言、何时必须跑测试、禁止 force push 等短、硬、每条对话都成立的条款。官方说明强调 Rules 应精简——长 Runbook 不应塞在这里。
2.2 Claude Skills — Claude Code 的按需 Runbook 产品
Claude Skills(Claude Code Skills)是 Anthropic 终端/IDE Agent 产品内的能力包:目录在 .claude/skills/<name>/SKILL.md(也可用户级)。Agent 先读 frontmatter 的 description,匹配用户意图后再加载正文,执行 code review、发布、安全审计等多步流程。支持 /skill-name 显式调用,以及 disable-model-invocation 防止误触发。深度选型可参考Claude Code Skills 10 框架指南。
2.3 Agent Skills — 跨工具的 SKILL.md 开放标准
Agent Skills 不是某一家公司的功能开关,而是 Agent Skills Specification 定义的文件格式与目录约定:SKILL.md frontmatter(name、description 等)+ 正文 Runbook + 可选 references/、脚本。Cursor、Claude Code 等宿主按同一规范解析,因此团队可把同一份 Skill 正文同步到 .cursor/skills 与 .claude/skills,仅按各工具文档微调 frontmatter。标准解决的是可移植性,不替代 Cursor Rules 的常驻约束。
3. 核心对比表(How Compare)
| 类型 | 入口 | 执行能力 | 上下文 | 适合人群 |
|---|---|---|---|---|
| Cursor Rules | 打开项目 / 匹配 glob 即加载 | 约束编辑行为、格式、禁区 | 常驻,应控制在精简篇幅 | 全体 Cursor 用户、Reviewer |
| Claude Skills | /skill 或语义匹配 description |
执行多步 Runbook(review、发布) | 按需加载,可挂 references/ | Claude Code / API Agent 用户 |
| Agent Skills | 由宿主实现(非独立产品) | 规范 SKILL.md 结构与元数据 | 不占用上下文,直到宿主加载 | 跨工具团队、开源维护者 |
3.1 路径与所有权对照
| 对比项 | Cursor Rules Cursor 产品 | Claude Skills / Agent Skills Runbook 层 |
|---|---|---|
| 典型路径 | .cursor/rules/*.mdc | .claude/skills/ 或 .cursor/skills/ 下的 SKILL.md |
| 标准归属 | Cursor 文档 | Agent Skills 开放规范 + 各宿主文档 |
| 跨 IDE 复制 | 仅 Cursor(概念可手写进别家 Rules) | 正文可共享,路径因宿主而异 |
| 适合内容 | 红线、风格、权限 | 检查清单、命令序列、模板 |
4. 场景怎么选?决策矩阵
| 你的场景 | 优先用什么 | 备注 |
|---|---|---|
| 只用 Cursor 写业务代码 | 3~5 条项目 Rules → 按需 Cursor Skills(同 Agent Skills 格式) | Rules 别写 Runbook;Skill 写 review/迁移 |
| 只用 Claude Code 终端 Agent | Claude Skills(遵循 Agent Skills 格式)→ 用户级 Rules 等价物(CLAUDE.md 等) | 无 Cursor Rules 面板,约束写在项目说明文件 |
| Cursor + Claude Code 双栈 | 共享 SKILL.md 正文 → 各放 .cursor/skills 与 .claude/skills → Cursor Rules 单独维护 |
Agent Skills 管格式,Cursor Rules 管 Cursor 专属约束 |
| 开源库贡献指南 | CONTRIBUTING + Agent Skills 包(security-review)→ 可选 Cursor Rules 片段 | Skill 对非 Cursor 用户也有说明价值 |
| 含 Xcode / codesign 的 Runbook | Skill 描述命令序列 → Rules 禁止乱改 signing → macOS 执行节点 | 与GitHub Actions macOS 构建配合,编译放远端 Mac |
5. 推荐组合(Stack)
组合 A — Cursor 单栈(个人项目)
- Rules:
core.mdc三条红线(最小 diff、不擅自 commit、改完跑 lint) - Skills:一个
code-review(Agent Skills 格式,放.cursor/skills/) - 不写 Claude 目录,避免仓库噪音
组合 B — Claude Code 单栈(终端优先)
- Claude Skills:
commit、security-review(disable-model-invocation: true) - 项目根
CLAUDE.md承担「常驻约束」角色(类比 Rules,非 Agent Skills)
组合 C — 双栈团队(推荐)
- 单仓
skills/源目录或 submodule,CI 同步到.cursor/skills与.claude/skills - Cursor Rules 仅 Cursor 开发者需要;Claude 用户读
CLAUDE.md - 新 Skill 先按 Agent Skills 写 frontmatter,再各工具微调
组合 D — 带远程执行的 Agent
- Skill 内写明 SSH 到云 Mac 跑
xcodebuild的步骤 - Rules 禁止在未确认时改生产配置
- 执行节点用固定 macOS 镜像,与AI 编程工具选型中的「执行环境」维度一致
6. 常见误区
「Agent Skills 是 Claude 专属」→ 它是开放格式;Claude Skills 是 Anthropic 实现之一。「Cursor Rules 可以写 20 步发布流程」→ 应拆成 Skill;Rules 越长,每次对话越浪费上下文。「复制 SKILL.md 到 Rules 目录就能用」→ 扩展名与加载器不同;.mdcRules 不会按 Skill 的 description 匹配触发。「三个名词互斥,只能选一个」→ 典型栈是 Rules(约束)+ Skills(流程)+ Agent Skills 格式(共享)。「有 Skills 就不需要 Rules」→ Skills 按需加载,无法替代「每次都不能 force push」类底线。「标准更新了,Claude Skills 会自动兼容」→ 关注 agentskills.io 与各宿主 changelog,frontmatter 字段可能分化。
7. 七步落地:附可复制示例
- 列清单:哪些约束「每次对话都要遵守」→ 候选 Cursor Rules;哪些是「偶尔跑的流程」→ 候选 Skills。
- 写 Rules:单文件 < 80 行,用
globs限定作用范围。 - 按 Agent Skills 规范起草 SKILL.md:
name+ 动词开头的description。 - 放入宿主目录:Cursor 用
.cursor/skills/<name>/SKILL.md;Claude Code 用.claude/skills/。 - 高风险 Skill:加
disable-model-invocation: true,仅允许/security-review类显式调用。 - 提交 Git:与代码同 PR,避免配置只存在于个人笔记本。
- 绑定 macOS 节点:Skill 含 Xcode/shell 时,在 Runbook 里写清 SSH 目标与前置检查。
# .cursor/rules/core.mdc --- description: Core repo constraints (always on) globs: "**/*" --- - Minimize diff; no drive-by refactors. - Never commit unless the user explicitly asks. - Do not modify backend/ unless the task requires it.
# .cursor/skills/code-review/SKILL.md (Claude: .claude/skills/code-review/SKILL.md) --- name: code-review description: Review staged git diff for bugs and test gaps. Use when user asks for review or before PR. --- 1. Run `git diff --staged` (or branch vs main). 2. Report Critical / Warning / Suggestion. 3. Do not auto-fix unless asked.
--- name: xcode-release description: Archive and export IPA on macOS runner. Manual invocation only. disable-model-invocation: true --- Prerequisites: macOS host, valid signing cert, Xcode selected. Steps: clean → archive → export → verify IPA checksum.
8. 总结
Cursor Rules 解决「在 Cursor 里每次对话都不能越界的线」;Claude Skills 解决「在 Claude Code 里某类任务怎么按 SOP 做」;Agent Skills 解决「这份 SOP 文件长什么样、怎么在多个 Agent 宿主之间搬运」。三者不是替代关系,而是约束层 + 产品能力 + 格式标准的组合拳。先按层分类,再谈复制别人的配置包,能少走很多「放了文件却不触发」的弯路。
延伸阅读:Cursor Rules · Claude Code Skills · Agent Skills 开放标准 · 站内Workflow / Rules / Skills 三层工程化
FAQ
Rules 与 Skills 要落地,执行环境得一致
把 SKILL.md 里的 Xcode 构建、Fastlane 或 launchd 步骤真正跑起来,离不开原生 macOS。Hashvps 云端 Mac mini M4 提供 SSH/VNC、独享 IPv4 与可复现的 Homebrew 环境——同一套 Skills 在本地与云端行为一致,Agent 不必被笔记本硬件绑架。
若你正在把 Claude Skills 或 Cursor Skills 接到 iOS 发布流水线, Hashvps 云 Mac 是性价比很高的执行节点—— 了解套餐方案,让 Runbook 在远端 7×24 跑完。