搜「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 完整解析,可把它當作「工作流架構」;本篇是「名詞對照表 + 決策手冊」,兩者互補、不重複。
實務上最常踩的坑是「把該按需載入的 SOP 寫成常駐 Rule」:一來每次對話都背著冗長 checklist,二來 Agent 無法依任務類型精準觸發。反過來,把「禁止 force push」這類底線寫進 Skill 也沒意義——Skills 預設不會在每條訊息前載入。先問自己「這條規則是否每次對話都必須成立」,答案決定它該進 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 的常駐約束。
換句話說:Agent Skills 是「檔案長怎樣」的公約,Claude Skills 是「Claude Code 怎麼讀這份檔案」的產品實作。你在 GitHub 上看到的 SKILL.md 範本,多半已符合 Agent Skills 格式;貼進 .claude/skills 就能在 Claude Code 裡用,貼進 .cursor/skills 則在 Cursor Agent 裡用——但兩邊的 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 欄位可能分化。「description 寫得越長越好」→ description 是語意匹配的索引,過長反而降低觸發精準度;細節放正文或references/。
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 與 Claude Code 使用者,建議把 Skill 正文當成「單一真相來源」放進 skills/ 目錄,用 CI 或腳本同步到各宿主路徑;Rules 則因工具而異,不必強求共用。這樣新人 onboarding 時只需理解三層分工,不必記住十幾個容易混淆的產品名稱。
延伸閱讀: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 跑完。