eval-rules

用途：审计 Claude Code 的指令规则文件。它递归发现 .claude/rules/ 与 ~/.claude/rules/ 下的所有 .md 规则，校验结构、把 paths glob 与真实项目文件比对，并与用户逐条复核，使规则目录比开始时更健康。不覆盖 Codex 的 .rules（那是 Starlark 命令审批策略，非指令）。\n\n适用时机：首次编写规则；规则似乎从不生效或对所有文件生效；把 CLAUDE.md 中的 @ 导入迁移为按路径作用域的规则；定期清理；接手新代码库后。\n\n两种模式：默认执行步骤 1-5 含交互复核；audit-only（用户要求不改动）执行步骤 1-3 与 5，只列出建议改动而不询问或编辑。\n\n主要能力：发现规则文件并记录来源、符号链接状态与 git 跟踪状态；读取并解析 frontmatter，把 paths（列表或逗号分隔字符串）规范化为列表，区分 scoped 与 always-on；用脚本把每个 pattern 与实际文件匹配，记录命中数、样例，标记死模式、无效 [ 模式、超出大括号展开预算的模式、以及联合覆盖超过 30% 文件的过宽规则；给出每条 scoped 规则 12 分制评分（frontmatter 解析、paths 字段、模式有效性、作用域、内容质量，另含少于 15 条规则的 +1 加分），阈值 Good>=83%、Needs work 58-82%、Fix<58%；最后输出审计报告与变更摘要。\n\n关键事实：paths 是 Claude Code 唯一读取的 frontmatter 字段，其他字段被静默忽略，因此 Cursor 的 globs/alwaysApply/description 会导致按预期限定的规则静默常驻；frontmatter 解析失败也会把规则当作无 paths 常驻。用户规则先于项目规则加载，二者互不覆盖。符号链接目标在工作目录内正常加载；在外需外部导入批准，且批准后仅无 paths 的链接规则加载；网络路径永不加载。跨项目共享可放 ~/.claude/rules/。\n\n限制：Codex 的 .rules 不在范围内；用户级规则的 pattern 依赖具体项目，仅审计具名项目时评分；Claude Code 实际匹配器未公开，边界结果只作如实标注；删除规则需用户明确同意。