用途:编写 CLAUDE.md 和 .claude/rules/ 规则文件,为 AI 编码代理提供项目专属记忆。只写非显而易见的约定、架构模式、易错点和已确认的解决方案,不写明显模式、不重复文档、不给通用编码建议。
主要能力:支持用标题组织内容(架构、约定、易错点、测试);大型项目可拆分为 .claude/rules/ 下多个 .md 文件,按主题分文件;支持 YAML frontmatter 的 paths 字段做路径限定规则,仅当读取匹配 glob 的文件时才加载;无 paths 的规则随会话启动加载,与 .claude/CLAUDE.md 同优先级;用户级规则放在 ~/.claude/rules/,先于项目规则加载,项目规则优先级更高。
使用方式:单个 CLAUDE.md 适合多数项目,建议 1k-4k token、100-300 行。用 wc -c CLAUDE.md 估算字符数再除以约 4。超过预算时精简措辞、删除通用建议、消除重复内容,或拆分规则文件。写具体内容与主动语态,链接已有文档而非复制。
限制与注意事项:不写行号(文件变动会导致引用失效),用描述性路径;不写代码风格规则(交给 ESLint、Prettier、Black、golangci-lint 等),不写 README 中的安装步骤、数据库 schema、API 规范、部署流程、临时 TODO;添加前需与用户级 CLAUDE.md、同级规则文件及覆盖相同内容的 skill 做冲突审查,冲突的指令会让代理每会话自行消解矛盾;同一主题只放一处。任务特定指令宜用 skill 而非常驻规则。只在遇到真实问题时更新,不为假设场景预先解决。
适用场景:从代码库探索或复杂问题中提炼非显而易见模式、反复向代理解释同一件事、记录代码中不易看出的易错点时。具体收费、价格、安装命令与平台信息暂未提供。