五大工具怎麼選、怎麼寫
看完個別工具的頁面後,這裡用一張表整理所有差異,方便對照,也方便你把已經寫好的內容搬到另一個工具。
檔案位置總表
| 工具 | 一直生效的說明檔 | 需要時才載入的技能包 | 全域(個人)路徑 |
|---|---|---|---|
| Cursor | .cursor/rules/*.mdc(alwaysApply: true) |
無獨立技能包格式 | 使用者設定內的 User Rules |
| GitHub Copilot | .github/copilot-instructions.md |
無獨立技能包格式,用 .github/instructions/*.instructions.md |
IDE/帳號設定內的個人指令 |
| Claude | CLAUDE.md(專案根目錄) |
.claude/skills/<name>/SKILL.md |
~/.claude/skills/<name>/SKILL.md |
| OpenAI Codex | AGENTS.md(逐層疊加) |
.agents/skills/<name>/SKILL.md |
~/.codex/AGENTS.md、~/.agents/skills |
| Google Antigravity | AGENTS.md / GEMINI.md + .agents/rules/*.md |
.agents/skills/<name>/SKILL.md |
~/.gemini/GEMINI.md、~/.gemini/config/skills |
觸發方式總表
| 工具 | 一直套用 | 依檔案路徑 | 依描述自動判斷 | 手動指定 |
|---|---|---|---|---|
| Cursor | alwaysApply: true |
globs |
description(不填 globs) |
@規則名 |
| GitHub Copilot | .github/copilot-instructions.md 全域套用 |
applyTo |
無此機制 | 無此機制 |
| Claude | CLAUDE.md 全域套用 |
paths(選用欄位) |
description |
/技能名 |
| OpenAI Codex | AGENTS.md 全域套用 |
無此機制 | description |
@(ChatGPT)/$(CLI) |
| Google Antigravity | Always on | Glob | Model decision(description) |
@規則名//技能名 |
撰寫上的關鍵差異
- 資料夾式技能包 vs 單一規則檔:Claude、Codex、Antigravity 用「資料夾+
SKILL.md+可選的scripts/references」,同一包幾乎能原封不動搬到另外兩個工具;Cursor 與 Copilot 則是單一 Markdown/.mdc檔案,沒有隨附腳本或資源檔的慣例。 - 必填欄位不同:Claude 和 Antigravity 的
SKILL.md只要求description;Codex 額外要求name也必填;Cursor 的.mdc三個欄位都選填,但至少要填一個才有意義;Copilot 的.instructions.md則是applyTo必填。 - 路徑比對語法命名不同、行為類似:Cursor 叫
globs、Copilot 叫applyTo、Antigravity 叫 Glob 模式,三者都是標準 glob 語法(如src/**/*.ts),可以直接照抄。 - Copilot 沒有「Agent 自動判斷相關性再載入」的技能包機制:它的兩種指令檔(全域、路徑限定)符合條件就一定套用,不會像其他工具一樣先看一句
description再決定要不要展開全文。 - AGENTS.md 是唯一真正「跨工具」的檔名:Cursor、Codex、Antigravity 都認得專案根目錄的
AGENTS.md;如果你想寫一份給多個工具共用的專案說明,AGENTS.md是目前最泛用的選擇,Claude 則仍需要另外一份CLAUDE.md,Copilot 需要另外一份.github/copilot-instructions.md。 - 只有 Antigravity 有獨立的 Workflow 層:Rule/Skill 五個工具都有對應概念,但「排好順序、一次跑完好幾個步驟」的 Workflow 目前只有 Antigravity 正式支援,而且官方已宣布要把它整併進 Skill(詳見〈Google Antigravity〉)。其他工具想做類似的事,通常是把步驟寫進單一 Skill/Rule 裡,靠模型自己照順序執行。
想把 Claude 的技能搬到 Codex 或 Antigravity?
因為三者遵循同一套 Agent Skills 開放標準,資料夾結構幾乎一樣,通常只需要:
- 把整個
<skill-name>/資料夾複製到目標工具的技能路徑(例如從.claude/skills/複製到.agents/skills/)。 - 確認
SKILL.mdfrontmatter 符合目標工具的必填欄位——Codex 需要補上name(若原本沒有)。 - 重新檢查
description是否清楚描述「什麼時候該用」,因為各工具的自動判斷邏輯都靠這句話。
反過來,Cursor 或 Copilot 的規則檔因為不是資料夾格式,需要手動把內容貼進 CLAUDE.md/AGENTS.md(一直生效)或改寫成一份新的 SKILL.md(需要時才載入),無法直接複製資料夾。
相關資料
- 回到總覽:〈各工具 Skills 設定總覽〉
- 為什麼要有這些機制:〈核心概念〉