rules-eval

ルール評価フレームワーク

使用しない場合

• スキルを評価する場合（abstract:skills-evalを使用）
• フックを評価する場合（abstract:hooks-evalを使用）
• 新しいルールを作成する場合（hookify:writing-rulesを使用）

概要

このスキルは、.claude/rules/ディレクトリにあるClaude Codeのルールを品質基準に照らして評価します。YAMLフロントマター、globパターンの構文、コンテンツの品質、ディレクトリ構成を検証します。ルールファイルは、pathsフロントマターによるパススコープ付きの条件付き読み込みと、条件なしのルール（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フロントマターの構文とフィールドを検証します
3. globパターンの正確性と具体性を分析します
4. コンテンツの品質（実行可能性、簡潔さ、非競合性）を評価します
5. 構成（命名、構造、シンボリックリンク）を確認します
6. トークン効率と冗長性を測定します

スコアリング

カテゴリ	ポイント	評価対象
フロントマターの妥当性	25	YAML構文、必須フィールド、正しいフィールド名
Globパターンの品質	20	構文、具体性、引用符
コンテンツの品質	25	実行可能性、簡潔さ、非競合性
構成	15	命名、構造、シンボリックリンクの使用
トークン効率	15	ルールのサイズ、冗長性の検出

スコア	レベル
91-100	優秀 - 本番環境で使用可能
76-90	良好 - 軽微な改善の余地あり
51-75	基本的 - 最適化が必要
26-50	基準未満 - 重大な問題あり
0-25	クリティカル - ルールが無効または破損

リソース

スキル固有のモジュール

• フロントマターの検証：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ファイル（サブディレクトリを含む）に対して、5つの評価軸ごとの内訳を含む品質スコア（0～100）が付与されていること。
• スコアを報告する前に、YAMLフロントマターの構文エラーと引用符で囲まれていないglobパターンが、ブロッキング事項として列挙されていること。
• Cursor固有のフィールド（alwaysApply、globs）を使用するルールが、想定されるClaude Codeスキーマに準拠していないものとして指摘されていること。
• 26点未満（クリティカル層）のルールについて、スコアだけでなく、具体的な修正方法を少なくとも1つ報告すること。