rules-eval
评估Claude Code规则文件质量
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:rules-eval。 它的用途是:评估Claude Code规则文件质量 完整的 Skill 内容见:https://321skill.com/skills/rules-eval-x-9/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'评估当前项目.claude/rules/目录下的所有规则文件,检查frontmatter是否完整、globs是否匹配、质量是否达标。' 它会扫描规则文件,输出质量报告,指出缺少的字段、无效的globs以及潜在问题。
介绍
解决什么问题:你在使用Claude Code时,.claude/rules/目录下的规则文件可能包含无效的frontmatter、不正确的globs路径或质量缺陷,导致AI行为异常或规则失效。本Skill能自动扫描这些规则文件,发现配置错误和潜在问题,确保规则集始终处于健康状态。
怎么用:安装后,在项目根目录执行rules-eval命令,它会递归遍历.claude/rules/中的所有规则文件,检查每个文件的frontmatter字段完整性、globs语法正确性、注释规范以及常见的质量反模式(如冗余规则、冲突配置)。输出结构化的审计报告,包含问题列表、严重等级和修复建议。
适合谁:适合使用Claude Code进行辅助开发的个人开发者或团队,尤其是需要维护大量自定义规则的后端、前端或全栈工程师。测试工程师也可用它来验证规则对代码审查流程的影响。
使用建议或注意事项:建议在每次更新规则后运行一次审计,或在CI/CD流程中集成此工具。注意本工具只检查规则文件的语法和结构,不验证规则逻辑的正确性,也不评估规则对AI行为的实际效果。
核心特点
专为Claude Code的.claude/rules/目录设计,能检查frontmatter、globs和配置规范,而非泛用代码检查工具。
注意事项
不能评估规则逻辑的语义正确性,也不适用于非Claude Code的配置文件。
常见问题
如何安装?
全局安装:npm install -g rules-eval
支持哪些规则格式?
支持YAML和Markdown格式的规则文件,包含frontmatter的.md文件也可识别。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/rules-eval-x-9/raw/index.md 读取 rules-eval 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/rules-eval-x-9/raw/index.md(查看排版版本)