SuperAPI AI 工具集

conformetry-validate

通用与其它

查看项目

更新于 10-16 03:12

技能介绍

用途:检查生成代码(实例)与其来源模板之间的一致性,报告差异并给出修复建议。核心规则是实例必须携带模板声明的全部内容,实例额外添加的内容不算差异,因此修复通常是补全缺失项,而不是删除多余内容;生成文件内部可自由实现,函数体不参与比较。

主要能力:按项目或整个工作区运行校验,支持语言过滤、模板过滤和一次性 glob 覆盖;输出评分摘要、逐文件差异及建议修复;区分缺失文件/目录、缺失声明或注释、无法推断占位符、未匹配实例、歧义实例等差异类型;支持 JSON 输出与自定义配置。

使用方式:使用 Nx 时运行 nx run <project>:conformetry-validate 或 nx run-many --targets=conformetry-validate;无 Nx 时使用命令行宿主 conformetry validate,可加 --templates 与 --languages 过滤,例如 conformetry validate --templates nestjs-service-module --languages typescript。诊断归属问题可用 conformetry templates --instances <路径> 和 conformetry instances。

适用场景:生成代码后、编辑生成文件后、声称实现完成前运行,作为生成代码是否仍符合标准的门禁。

限制:没有自动修复或写入模式,唯一改变结果的标志是 --threshold;重新生成会无条件覆盖,无存在性检查、合并或冲突检测。阈值默认 1(完全匹配),降低阈值只是允许漂移而非隐藏差异。带标签的实例组无法被命令行宿主定位,需改用 Nx 目标或传入 --instances。缺少 Python 解释器会作为差异报告而非崩溃。第二次运行可能报告新差异,属于最小匹配模板要求满足后更大模板要求浮现,并非回归。