先说结论
CLAUDE.md、AGENTS.md 和 Cursor 规则每个会话都待在上下文里,所以只写事实和边界。Skill 只在相关任务出现时才加载,长流程放进去也不会拖累每次对话。
CLAUDE.md、AGENTS.md 和 Cursor 规则,分别谁在读
Claude Code 读 CLAUDE.md,Codex 读 AGENTS.md,Cursor 除了自己的规则,这两个文件也都读。SKILL.md 三家都读,但只在用得上时才读。
| 文件 | 谁会读 | 何时读 |
|---|---|---|
CLAUDE.md | Claude Code、Cursor | Claude Code:会话开始时读取 ~/.claude/CLAUDE.md 和项目里的文件;子文件夹里的那份,等 Claude 进到那个目录干活时才读。Cursor:始终应用。 |
AGENTS.md | Codex、Cursor | Codex:先读 ~/.codex/AGENTS.md,再从仓库根目录一路往下读到你启动的目录,每层一份;离得越近越优先;总共不超过 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。” | 指令文件 |
| “没批准不许部署。” | 指令文件 |
| “提交前先跑测试。” | 指令文件 |
| “我们写发布说明的完整步骤。” | Skill |
| “按我们的品牌风格做一份发布演示文稿。” | Skill |
每个会话
指令文件不管用不用得上,每次对话都占上下文
需要时
Skill 在被用到之前只占大约一句话
怎么把流程从 CLAUDE.md 里挪出去
一个常见的改造前后
一份 CLAUDE.md 慢慢多出 60 行“怎么写发布说明”。每次对话都得为它买单,连调 bug 也不例外。把它挪进 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”类的规则直接转成 Skills。
常见问题
CLAUDE.md 是什么?
一个写着指令的 Markdown 文件,Claude Code 每个会话开始时都会读。你个人的放在 ~/.claude/CLAUDE.md,项目的放在 CLAUDE.md 或 .claude/CLAUDE.md。
Codex 里该用 AGENTS.md 还是 Skills?
两个都用。简短、始终成立的规则放进 AGENTS.md,只在需要时才加载的流程做成 Skills。Codex 指南里两样都讲了。
Cursor 规则和 Skills 是一回事吗?
不是。规则是会被加进对话的 .mdc 文件;Skills 是文件夹,Agent 判断相关或被你点名时才用。详见 Cursor 指南。
参考来源
这篇对你有帮助吗?
