rules-eval

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Rules Evaluation Framework

规则评估框架

Overview

概述

This skill evaluates Claude Code rules in

.claude/rules/

directories against quality standards. It validates YAML frontmatter, glob pattern syntax, content quality, and directory organization. Rules files support path-scoped conditional loading via

paths

frontmatter and unconditional rules (no

paths

field).

Key validations: YAML syntax errors, unquoted glob patterns, Cursor-specific fields (

alwaysApply

globs

), overly broad patterns, content verbosity, and naming conventions.

本skill用于对照质量标准评估

.claude/rules/

目录下的Claude Code规则。它会验证YAML frontmatter、glob模式语法、内容质量和目录组织。规则文件支持通过

paths

frontmatter实现路径范围的条件加载，也支持无

paths

字段的无条件规则。

核心验证项包括：YAML语法错误、未加引号的glob模式、Cursor专属字段（

alwaysApply

、

globs

）、过于宽泛的匹配模式、内容冗余以及命名规范。

Quick Start

快速开始

bash

undefined

bash

undefined

Evaluate rules in current project

评估当前项目中的规则

/rules-eval

Evaluate specific directory

评估指定目录

/rules-eval .claude/rules/

Detailed analysis with recommendations

输出包含优化建议的详细分析

/rules-eval --detailed

undefined

/rules-eval --detailed

undefined

Evaluation Workflow

评估工作流

Scan
```
.claude/rules/
```
for all
```
.md
```
files (including subdirectories)
Validate YAML frontmatter syntax and fields
Analyze glob patterns for correctness and specificity
Assess content quality (actionable, concise, non-conflicting)
Check organization (naming, structure, symlinks)
Measure token efficiency and redundancy

扫描
```
.claude/rules/
```
下所有
```
.md
```
文件（包含子目录）
验证YAML frontmatter的语法和字段
分析glob模式的正确性和匹配精准度
评估内容质量（可落地、简洁、无冲突）
检查组织规范（命名、结构、符号链接）
衡量token效率和冗余度

Scoring

评分规则

Category	Points	Focus
Frontmatter Validity	25	YAML syntax, required fields, correct field names
Glob Pattern Quality	20	Syntax, specificity, quoting
Content Quality	25	Actionable, concise, non-conflicting
Organization	15	Naming, structure, symlink usage
Token Efficiency	15	Rule size, redundancy detection

Score	Level
91-100	Excellent - Production-ready
76-90	Good - Minor improvements possible
51-75	Basic - Needs optimization
26-50	Below Standards - Significant issues
0-25	Critical - Invalid or broken rules

分类	分值	考核重点
Frontmatter有效性	25	YAML语法、必填字段、字段名称正确性
Glob模式质量	20	语法、匹配精准度、引号使用
内容质量	25	可落地、简洁、无冲突
组织规范	15	命名、结构、符号链接使用
Token效率	15	规则体积、冗余检测

得分	等级
91-100	优秀 - 可直接生产环境使用
76-90	良好 - 可进行小幅优化
51-75	基础达标 - 需要优化
26-50	低于标准 - 存在明显问题
0-25	严重问题 - 规则无效或损坏

Resources

参考资源

Skill-Specific Modules

技能专属模块

Frontmatter Validation: See
```
modules/frontmatter-validation.md
```
Glob Pattern Analysis: See
```
modules/glob-pattern-analysis.md
```
Content Quality Metrics: See
```
modules/content-quality-metrics.md
```
Organization Patterns: See
```
modules/organization-patterns.md
```

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

Tools

工具

Rules Validator:
```
scripts/rules_validator.py
```

规则验证器:
```
scripts/rules_validator.py
```