$9.99/月,访问全部 Premium Skills,随时取消。查看方案

Skills vs CLAUDE.md、AGENTS.md 和 Cursor 规则

指令文件每个会话都加载,Skill 只在对应任务出现时才加载。这条线划清楚了,Agent 反应更快,规则也短到真有人愿意读。

适合
仓库维护者
涵盖
Claude Code、Codex、Cursor
时长
阅读约 6 分钟

先说结论

CLAUDE.md、AGENTS.md 和 Cursor 规则每个会话都待在上下文里,所以只写事实和边界。Skill 只在相关任务出现时才加载,长流程放进去也不会拖累每次对话。

CLAUDE.md、AGENTS.md 和 Cursor 规则,分别谁在读

Claude Code 读 CLAUDE.md,Codex 读 AGENTS.md,Cursor 除了自己的规则,这两个文件也都读。SKILL.md 三家都读,但只在用得上时才读。

文件谁会读何时读
CLAUDE.mdClaude Code、CursorClaude Code:会话开始时读取 ~/.claude/CLAUDE.md 和项目里的文件;子文件夹里的那份,等 Claude 进到那个目录干活时才读。Cursor:始终应用。
AGENTS.mdCodex、CursorCodex:先读 ~/.codex/AGENTS.md,再从仓库根目录一路往下读到你启动的目录,每层一份;离得越近越优先;总共不超过 32 KiB。Cursor:始终应用。
.cursor/rules/*.mdcCursor四种模式选一种: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 后,原处只剩一行,只有你要写发布说明时才会加载这套流程。

CLAUDE.md, after
- Use pnpm. Never deploy without approval.
- For release notes, use the release-notes Skill.
  1. 1

    把这段流程剪切到 .claude/skills/release-notes/SKILL.md(Codex 和 Cursor 用 .agents/skills/)。

  2. 2

    写一段描述,说清什么时候该用它。

  3. 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 指南。

参考来源

这篇对你有帮助吗?