很多团队刚开始用 Claude Code 时，最容易走进一个坑，看到什么规则都往 CLAUDE.md 里塞。代码风格放进去，构建命令放进去，API 文档也放进去，发布流程也放进去，甚至连一次性的排障步骤也想写进去。短期看很爽，Claude Code 每次打开项目都像拿到了一本厚厚的项目手册。可一段时间后，问题会慢慢冒出来，Claude 读得越来越多，响应越来越像背诵制度文件，真正跟当前任务有关的信息反而被噪声稀释。CLAUDE.md 和 Skill 都能存放指令，但它们不是同一种东西。一个更像团队墙上的长期约定，另一个更像工具箱里的专用操作卡。CLAUDE.md 解决的是「Claude 每次进入项目都必须知道什么」，Skill 解决的是「Claude 在某类任务发生时才需要调用什么」。Anthropic 官方文档里也明确区分了这层关系，Claude Code 会在会话启动时加载工作目录上方层级中的 CLAUDE.md 和 CLAUDE.local.md，而 Skill 的完整内容只有在被使用时才加载，长参考资料在不用的时候几乎不占主上下文空间。CLAUDE.md 更像项目里的空气CLAUDE.md 最适合放那些「不需要被触发，也不应该被遗忘」的规则。比如项目只允许 pnpm，不允许 npm。比如所有新增 API 都要走 src/server/routes 里的现有错误返回结构。比如测试命令固定是 pnpm test，不要猜测 yarn test。比如某个老系统里不能直接改数据库 migration，只能通过内部脚本生成。这些内容不是任务，而是环境。Claude Code 每次进入项目，如果不知道这些规则，后面的所有判断都会跑偏。就像一个新同事入职