用途:从已有的手写 CLAUDE.md(或 AGENTS.md)出发,生成对应的 CLAUDE.md.spec.ts 类型化规格文件,属于非破坏性采纳路径。
主要能力与规则:保持忠实,原样保留每条规则、命令和散文段落,不臆造内容,规格应能编译回接近原文件;非破坏性,绝不修改原始 CLAUDE.md/AGENTS.md,只写新的 .spec.ts,也不自动编译覆盖原文件;不升级强制级别,guidance() 保持为 guidance(),升级到 enforce() 需另行选择;可逆,可用 vigiles eject <file> 随时把文件还原为纯手写 markdown;写入前先征得用户同意。
使用方式:先读取目标指令文件,检查 package.json 中是否有 vigiles,缺失时建议 npm install -D vigiles;解析 Commands、Key Files 映射、Rules(含 Enforced by: 或 Guidance only)和散文段落;生成 spec 后用 npm run build 和 npx vigiles compile CLAUDE.md.spec.ts 验证,用 npx vigiles lint 检查,再向用户展示结果并询问是否写入。可用 file()、cmd()、ref() 引用,带 Enforced by: linter 的规则转为 enforce(),code-review 类转为 guidance(),未标注规则加 TODO 注释,规则 ID 用标题的 kebab-case,保留 Why: 文本。重要限制:不得输出已弃用的 keyFiles 字段,原文件的 Key Files 映射不迁移为 keyFiles,需按迁移方案逐条处理或暂作为散文段落保留。
限制:未提供关于 vigiles 的具体收费、性能或其他平台支持等信息。