rules-eval

规则评估框架

不适用的情况

• 评估技能（使用 abstract:skills-eval）
• 评估钩子（使用 abstract:hooks-eval）
• 编写新规则（使用 hookify:writing-rules）

概述

此技能依据质量标准评估 .claude/rules/ 目录中的 Claude Code 规则。它会验证 YAML frontmatter、glob 模式语法、内容质量和目录组织。规则文件支持通过 paths frontmatter 按路径范围条件加载，也支持无条件加载的规则（不含 paths 字段）。

主要验证项：YAML 语法错误、未加引号的 glob 模式、Cursor 专用字段（alwaysApply、globs）、范围过广的模式、内容冗长程度和命名规范。

快速开始

# Evaluate rules in current project
/rules-eval

# Evaluate specific directory
/rules-eval .claude/rules/

# Detailed analysis with recommendations
/rules-eval --detailed

评估工作流

1. 扫描 .claude/rules/ 下的所有 .md 文件（包括子目录）
2. 验证 YAML frontmatter 语法和字段
3. 分析 glob 模式的正确性和具体程度
4. 评估内容质量（可执行、简洁、无冲突）
5. 检查组织方式（命名、结构、符号链接）
6. 衡量 Token 效率和冗余情况

评分

类别	分值	重点
Frontmatter 有效性	25	YAML 语法、必需字段、正确的字段名
Glob 模式质量	20	语法、具体程度、引号
内容质量	25	可执行、简洁、无冲突
组织方式	15	命名、结构、符号链接使用
Token 效率	15	规则大小、冗余检测

分数	等级
91-100	优秀 - 可用于生产环境
76-90	良好 - 仍可进行小幅改进
51-75	基础 - 需要优化
26-50	未达标准 - 存在重大问题
0-25	严重 - 规则无效或已损坏

资源

技能专用模块

• Frontmatter 验证：参见 modules/frontmatter-validation.md
• Glob 模式分析：参见 modules/glob-pattern-analysis.md
• 内容质量指标：参见 modules/content-quality-metrics.md
• 组织模式：参见 modules/organization-patterns.md

工具

• 规则验证器：scripts/rules_validator.py

相关技能

• abstract:skills-eval - 技能评估框架
• abstract:hooks-eval - 钩子评估框架

退出标准

• .claude/rules/ 下的每个 .md 文件（包括子目录）都获得质量评分 （0-100），并附有五个维度的分类评分明细。
• 在报告任何评分之前，先将 YAML frontmatter 语法错误和未加引号的 glob 模式列为阻断性发现。
• 使用 Cursor 专用字段（alwaysApply、globs）的规则会被标记为 不符合预期的 Claude Code 架构。
• 对于评分低于 26（严重级别）的规则，报告至少一项具体的修正措施， 而不只是给出分数。