用途:审计代码库质量,检测“松散代码”信号(描述中亦提及 vibe coding、isRecord 等)。
主要能力:先用搜索排除 generated、build、vendor、lock 等文件,统计宽泛的松散代码信号,按重复信号多少给文件排序形成热点,再检查排名靠前的文件后给出结论,并在修改前询问用户如何处理。使用 TEMPLATE.md 作为输出格式。
使用方式:用 rg 扫描。先采用资料给出的起始模式,再按仓库语言和目录缩小范围;另用统计命令按文件聚合出现次数并排序取前 20。
可关注的信号:isRecord、Record<string, unknown>、Record<string, any>;fallback、默认对象、return null/undefined;重复的 null/undefined 守卫、可选链、空值合并;非空断言;as any、宽泛 as Type、断言链、: any;脚本、配置、CLI、构建期或仅服务端文件之外的 node:* 导入;被吞掉的错误、泛化错误、console.error、console.warn;TODO、FIXME、HACK、temporary、workaround。
判断标准:边界代码解析外部 JSON、CMS、API、数据库、文件、环境变量、URL 或消息数据属合理;一次收窄、一次归一化并给出类型形状属合理;可选数据确实可选且不掩盖必要不变量属合理;node:* 仅留在服务端或构建期代码属合理。反之,在领域、UI 或业务逻辑中重复守卫、兜底或断言;把必需数据缺失变成空数组、默认对象、null 或 undefined;用类型逃逸替代运行时校验;node:* 可进入浏览器包或共享前端模块;错误处理丢失原因、上下文或用户可见失败,均属松散。
限制:资料未提供版本、价格、平台、安装方式或具体效果说明。