一、什么是 Rule
Rule 是放在 .claude/rules/ 目录下的 Markdown 文件,每个文件管一个主题的行为规范。
Rule 和 CLAUDE.md 本质上是同一类东西——都是你写给 Claude 的行为指导。区别在于组织方式:CLAUDE.md 是一整本项目手册,涵盖技术栈、架构决策、团队规范等全局性内容;Rule 是把手册按章节拆成独立文件,每个文件专注一个具体主题。
Rule 的独特价值在于两点:按主题独立维护方便团队协作,以及支持条件触发——只在你操作特定类型的文件时才加载,不需要的规则不占用上下文空间。
两个层级:
- 项目级
.claude/rules/*.md— 仅在当前项目生效,可提交到 Git 团队共享,所有成员的 Claude 自动遵守 - 个人级
~/.claude/rules/*.md— 在你的所有项目上都会生效,适合放跨项目通用的个人偏好和工作习惯
两层同时生效。冲突时项目级优先。当 CLAUDE.md 接近 200 行时,就该把内容按主题拆到 Rule 文件里——CLAUDE.md 保留全局概况,具体规范各自独立管理。
二、为什么需要它
三、怎么写 Rule
基本格式
Rule 文件是普通的 Markdown,放在 .claude/rules/ 目录下。文件名直接描述规则主题,一个文件管一件事:
条件触发
有些规则只和特定文件相关。在文件开头加 paths 字段,Rule 只在你操作匹配的文件时才加载:
这条 Rule 只在 Claude 读写测试文件时生效。其他时候不加载,节省上下文空间。
没有 paths 字段的 Rule 每次会话都会加载——大部分规则用这种方式就够了。
获取与积累
本课程提供了一套经过实战验证的通用 Rule 文件,覆盖写作规范、代码审查、任务执行等常见场景,下载后直接放入 .claude/rules/ 即可使用:获取通用 Rule 文件 →