← 返回開發日記

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 完整解析,可把它當作「工作流架構」;本篇是「名詞對照表 + 決策手冊」,兩者互補、不重複。

實務上最常踩的坑是「把該按需載入的 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(namedescription 等)+ 正文 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 仍要各自維護。

一句話記憶
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 欄位可能分化。
  • 「description 寫得越長越好」 → description 是語意匹配的索引,過長反而降低觸發精準度;細節放正文或 references/

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 與 Claude Code 使用者,建議把 Skill 正文當成「單一真相來源」放進 skills/ 目錄,用 CI 或腳本同步到各宿主路徑;Rules 則因工具而異,不必強求共用。這樣新人 onboarding 時只需理解三層分工,不必記住十幾個容易混淆的產品名稱。

延伸閱讀: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 執行節點。

前往首頁
限時優惠