SuperAPI AI 工具集

rules-eval

编程与开发

查看项目

更新于 10-15 17:20

技能介绍

Rules Evaluation Framework 是一个面向 Claude Code 的规则评估技能,用来评估 .claude/rules/ 目录下的规则文件是否符合质量标准。它适用于规则审计场景,不适用于评估技能、评估钩子或撰写新规则。

主要能力:验证 YAML frontmatter 语法与字段、分析 glob 模式语法与具体性、评估内容质量(可操作、简洁、不冲突)、检查组织方式(命名、结构、符号链接),并衡量 token 效率与冗余。规则文件支持通过 frontmatter 的 paths 字段进行路径范围的按条件加载,也可编写无 paths 字段的无条件规则。

使用方式:在当前项目评估规则可运行 /rules-eval;评估指定目录可运行 /rules-eval .claude/rules/;带建议的详细分析可运行 /rules-eval --detailed。评估流程会扫描 .claude/rules/ 下所有 .md 文件(含子目录),依次验证 frontmatter、分析 glob、评估内容、检查组织并衡量 token 效率。

评分维度:Frontmatter 有效性 25 分,Glob 模式质量 20 分,内容质量 25 分,组织 15 分,Token 效率 15 分。分值含义:91-100 优秀,76-90 良好,51-75 基础需优化,26-50 低于标准,0-25 严重。

限制与注意:需使用 YAML 语法正确的 frontmatter;未加引号的 glob 模式会被列为阻断性问题;使用 Cursor 专有字段(alwaysApply、globs)会被标记为不符合 Claude Code 预期 schema;得分低于 26 的规则会附带至少一项纠正措施。相关资源包括 modules 下的验证与质量模块,以及 scripts/rules_validator.py 工具;相关技能为 abstract:skills-eval 与 abstract:hooks-eval。具体安装或调用方式资料未提供。