簡短回答
CLAUDE.md、AGENTS.md 和 Cursor rules 每個工作階段都會放進 context，所以只寫事實和界線就好。Skill 只在相關任務出現時才載入，因此可以容納冗長的流程，而不會拖累每一段對話。
誰會讀取 CLAUDE.md、AGENTS.md 和 Cursor rules
Claude Code 讀取 CLAUDE.md，Codex 讀取 AGENTS.md，Cursor 則讀取自己的 rules 以及這兩個檔案。三者都會讀取 SKILL.md，但只在需要時才讀。
| 檔案 | 由誰讀取 | 何時讀取 |
|---|---|---|
CLAUDE.md | Claude Code、Cursor | Claude Code：工作階段開始時，從 ~/.claude/CLAUDE.md 和專案中讀取；子資料夾中的檔案則在 Claude 進入該資料夾工作時讀取。Cursor：一律套用。 |
AGENTS.md | Codex、Cursor | Codex：先讀 ~/.codex/AGENTS.md，再從 repo 根目錄往下到你啟動的位置，每個資料夾讀一個檔案；最接近的優先；總計上限 32 KiB。Cursor：一律套用。 |
.cursor/rules/*.mdc | Cursor | 四種模式之一：Always Apply、Apply Intelligently、Apply to Specific Files 或 Apply Manually |
SKILL.md | 三者皆會 | 只在請求符合它，或你用名稱呼叫時 |
什麼該放在 CLAUDE.md，什麼該放進 Skill
一個好用的判斷原則：如果一行寫得完，而且每段對話都該遵守，它就是指示。如果要一整頁才說得清楚，而且只跟某一類任務有關，它就是 Skill。
| 你想表達的內容 | 放在 |
|---|---|
| 「用 pnpm，不要用 npm。」 | 指示檔 |
| 「沒有核准絕不部署。」 | 指示檔 |
| 「commit 前先跑測試。」 | 指示檔 |
| 「我們撰寫版本說明的步驟。」 | Skill |
| 「用我們的品牌風格做一份發表簡報。」 | Skill |
每個工作階段
不管用不用得到，指示檔在每段對話都會占用 context
需要時
Skill 在被使用前大約只占一句話
如何把流程從 CLAUDE.md 搬出來
常見的前後對比
CLAUDE.md 慢慢長出一段 60 行、教你怎麼寫版本說明的內容。每段對話都要為它付出成本，連除錯時也一樣。把它搬進 Skill 後，原處只留下一行，而這套流程只在你要求撰寫版本說明時才會載入。
- Use pnpm. Never deploy without approval.
- For release notes, use the release-notes Skill.- 1
把流程剪下，放進
.claude/skills/release-notes/SKILL.md（Codex 和 Cursor 則放在.agents/skills/）。 - 2
寫一段說明何時該使用它的描述。
- 3
在指示檔裡留下一行指引。
你應該會看到： 指示檔變短了，而這套流程只在你要求撰寫版本說明時才會載入。
在 Cursor 中，/migrate-to-skills 可以幫你把「Apply Intelligently」規則轉換成 Skill。
常見問題
CLAUDE.md 是什麼？
一個寫滿指示的 Markdown 檔案，Claude Code 在每個工作階段開始時都會讀取它。你個人的放在 ~/.claude/CLAUDE.md；專案的放在 CLAUDE.md 或 .claude/CLAUDE.md。
在 Codex 中該用 AGENTS.md 還是 Skill？
兩個都用。把永遠成立的簡短規則放在 AGENTS.md，只在需要時才載入的流程放進 Skill。Codex 指南兩者都有介紹。
Cursor rules 和 Skill 一樣嗎？
不一樣。Rules 是會被加進對話的 .mdc 檔案；Skill 則是 Agent 在相關時或你呼叫時才使用的資料夾。請見 Cursor 指南。
參考來源
這篇指南對你有幫助嗎？
