用途:指导编写 .claude/rules/ 目录下的规则文件,适用于创建、改进或审阅项目规则,使 Claude 能实际遵循。
主要能力与要点:
- 黄金格式。每条规则包含三部分:祈使句(做什么)、后果(缺少会出什么问题)、机制(为何失败)。机制明显时可用单行规则,需要解释时用多行。
- 正向表述。避免“不要使用 X”,改为“使用 Y”,减少粉红大象效应,并给出否定到肯定的转换模式。
- 可执行性检验。写规则前问:能否在 30 秒代码审查中检查合规?无法检验的模糊规则(如“写干净代码”“保持函数小”)需改写为具体可测的形式,或交给 lint。
- 预算约束。所有 .claude/rules/ 规则合计应低于 500 行,因为每次 Claude 交互都会加载规则并消耗 token。文档给出各档位的大致 token 成本,并提供删减策略:交给 linter、合并相关规则、删除 Claude 训练中已知的内容、用表格替代列表。
- 路径作用域。无作用域的规则对每个文件生效,成本高且常不必要;涉及特定目录、技术或层级的规则应加 paths 限定,如 src/api/**/*.ts。
- 冲突预防。两条规则不得互相矛盾;若可能冲突,应合并到同一文件并写明显式条件,并给出冲突检测清单。
- 工作示例与质量清单。展示从 12 个文件 800 行精简到 4 个文件 180 行的做法,以及发布前的检查项,如格式、正向表述、可执行性、总行数、路径作用域、无矛盾、不重复训练知识和 linter 已覆盖内容。
限制:资料主要针对 .claude/rules/ 的编写方法,未提供具体安装命令、运行环境或收费信息;相关约定可参考 writing-plugins 与 writing-prompts 文档,但本次资料中暂未提供其内容。