← 返回开发日记

Claude Skills、Agent Skills 与 Cursor Rules 有什么区别?2026 对照指南

AI 编程 & 工作流 · 2026.08.08 · 约 15 分钟阅读

Claude Skills、Agent Skills 与 Cursor Rules 三层对照示意

搜「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 RulesClaude Code SkillsAgent 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(namedescription 等)+ 正文 Runbook + 可选 references/、脚本。Cursor、Claude Code 等宿主按同一规范解析,因此团队可把同一份 Skill 正文同步到 .cursor/skills.claude/skills,仅按各工具文档微调 frontmatter。标准解决的是可移植性,不替代 Cursor Rules 的常驻约束。

一句话记忆
Cursor Rules = Cursor 里的家规(自动、常驻);Claude Skills = Claude Code 里的 SOP(按需);Agent Skills = 大家共用的 SOP 文件格式(可跨工具)。

3. 核心对比表(How Compare)

Cursor Rules vs Claude Skills vs Agent Skills
类型 入口 执行能力 上下文 适合人群
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:commitsecurity-reviewdisable-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 目录就能用」 → 扩展名与加载器不同;.mdc Rules 不会按 Skill 的 description 匹配触发。
  • 「三个名词互斥,只能选一个」 → 典型栈是 Rules(约束)+ Skills(流程)+ Agent Skills 格式(共享)
  • 「有 Skills 就不需要 Rules」 → Skills 按需加载,无法替代「每次都不能 force push」类底线。
  • 「标准更新了,Claude Skills 会自动兼容」 → 关注 agentskills.io 与各宿主 changelog,frontmatter 字段可能分化。

7. 七步落地:附可复制示例

  1. 列清单:哪些约束「每次对话都要遵守」→ 候选 Cursor Rules;哪些是「偶尔跑的流程」→ 候选 Skills。
  2. 写 Rules:单文件 < 80 行,用 globs 限定作用范围。
  3. 按 Agent Skills 规范起草 SKILL.mdname + 动词开头的 description
  4. 放入宿主目录:Cursor 用 .cursor/skills/<name>/SKILL.md;Claude Code 用 .claude/skills/
  5. 高风险 Skill:加 disable-model-invocation: true,仅允许 /security-review 类显式调用。
  6. 提交 Git:与代码同 PR,避免配置只存在于个人笔记本。
  7. 绑定 macOS 节点:Skill 含 Xcode/shell 时,在 Runbook 里写清 SSH 目标与前置检查。
示例 1:Cursor Rule(常驻约束)
# .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.
示例 2:Agent Skills 格式(双宿主可共享正文)
# .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.
示例 3:Claude Skills 专属选项(可选 frontmatter)
---
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

Claude Skills 和 Agent Skills 是同一个东西吗?
不完全是。Agent Skills 是开放规范(SKILL.md 怎么写);Claude Skills 是 Claude Code 对该规范的实现与产品命名。你可以说「我的 Claude Skill 符合 Agent Skills 标准」,但不能把「Agent Skills」理解成只有 Claude 才有。
Cursor Rules 能代替 Skills 吗?
不能。Rules 自动常驻,适合短约束;Skills 按需加载,适合长流程。把长 Runbook 写进 Rules 会拖慢每次对话并增加误触发成本。
SKILL.md 应该提交到 Git 吗?
应该。与 .cursor/rules 一样,团队共享的 Skills 应和代码同仓版本化,新成员 clone 后即可复用同一套 AI 工程化配置。
只用 Claude Code、不用 Cursor,还需要 Cursor Rules 吗?
不需要 Cursor Rules 文件。用 CLAUDE.md 或项目说明承担常驻约束;Skills 仍建议按 Agent Skills 格式编写以便将来迁移工具。
和 Workflow 那篇文章有什么区别?
Workflow 文讲「编排层 + Rules + Skills」如何搭整套 AI 编程工程;本文专讲三个热搜名词的定义与对照,不展开斜杠命令、CI 触发等 Workflow 细节。
含 Xcode 的 Skill 为什么推荐云 Mac?
codesign 与 xcodebuild 依赖原生 macOS。Skill 描述的是步骤,真正执行需要稳定 Mac 节点;云 Mac 提供 7×24 SSH 环境,避免笔记本通宵开机。

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 跑完。

Hashvps · Mac 云服务

Rules 与 Skills 要跑通,Mac 节点得稳

云端 Mac mini M4:原生 macOS、SSH 直达,适合把 SKILL.md Runbook 绑到 Xcode/CI 执行节点。

前往首页
限时优惠