其他
规则文件强制分类缺失时:校验并修正每条规则的…
当项目使用 CLAUDE.md/AGENTS.md/.cursorrules 或 *.spec.ts 规则文件,需要确认每条规则都有明确的强制执行等级标注并修好缺失项时使用。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 35/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 38/100 ×0.15
适用场景
规则文件强制分类缺失时:校验并修正每条规特定
解决思路
- 检测项目格式:查找是否存在 `CLAUDE.md.spec.ts` 或任意 `*.spec.ts` 文件;若有则为 v2(基于 spec)项目,规则必须使用 `enforce()`、`check()` 或 `guidance()`。
- 若无 spec 文件但存在 `CLAUDE.md`、`AGENTS.md`、`.cursorrules`,则为 v1(手写)项目,规则需要 `**Enforced by:**` 或 `**Guidance only**` 标注。
- v2 项目校验第 1 点:检查 `enforce()` 规则是否引用了真实存在的 linter 规则,执行 `npx vigiles compile` 验证。
- v2 项目校验第 2 点:检查是否有本可以用 `enforce()` 却写成 guidance 的规则,对照项目的 linter 配置查找匹配规则。
- v2 项目校验第 3 点:检查 `check()` 断言是否可委托给 linter,若是则建议改用 `enforce()`。
- v2 常用命令:`npx vigiles compile` 和 `npx vigiles discover`。
- v1 文件校验:扫描所有 `###` 标题,每个标题必须带有以下之一——`**Enforced by:** \`linter/rule-name\``、`**Guidance only** — reason`、`<!-- vigiles-disable -->`。
- v1 文件校验:用汇总表格报告所有缺失标注的规则。
- 修复问题(每条):在项目 linter 配置中查找匹配的规则。
- 修复问题(每条):建议改为 `enforce("linter/rule")`(v2)或 `**Enforced by:** \`linter/rule\``(v1)。
- 修复问题(每条):若不存在对应 linter 规则,则建议 `guidance()`(v2)或 `**Guidance only**`(v1)。
- 修复问题(每条):在做出修改前先询问用户确认。
- 迁移建议:若项目为 v1 格式,建议迁移到 v2 specs 以获得类型安全,提示用户运行 `adopt-spec` 技能把 CLAUDE.md 转换为带类型的 .spec.ts 文件。
- 验证:v2 项目运行 `npx vigiles compile && npx vigiles check`;校验场景运行 `npx vigiles check`;报告验证结果。
适用边界 · 注意事项
- 项目根本没有规则/指令文件(无 CLAUDE.md、AGENTS.md、.cursorrules 或 *.spec.ts)时不适用。
- 未安装或无法使用 vigiles CLI(npx vigiles)时无法完成编译与校验。
- 只想新增规则内容、不关心强制执行分类与标注完整性时,不必使用本流程。