rules-eval

评估Claude Code规则文件质量

代码质量 全栈开发后端开发测试工程师 审计Claude Code规则配置 claude ★ 1.1k 更新于 2026-08-01

安装使用

复制下面这段提示词发给你的 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 格式),按其中说明在我的环境里完成安装和配置。