SuperAPI AI 工具集

completeness-validator

通用与其它

查看项目

更新于 10-16 09:53

技能介绍

用途:判断代码或工作是否真正完成,而非表面“完成”。主要能力包括多语言完成度校验、缺口检测(遗漏接线、未连接系统、模拟数据、占位实现)、生产就绪检查、集成验证、测试验证与规范符合性检查。它将完成度分为五级:表面、功能性、集成、生产、完全。

使用方式:采用三级验证系统。第一级为基于 AST 的静态分析,检测空函数、桩实现、导入解析失败、错误处理覆盖、类型安全,工具涵盖 eslint、@typescript-eslint/parser、pylint、ast、cargo check、clippy、go vet、staticcheck。第二级为运行时集成验证,检查服务启动、数据库连接、外部 API 调用、环境变量与健康检查,可用 Testcontainers、网络抓包与冒烟测试。第三级为生产就绪评审,检查可观测性、值班、安全、CI/CD、文档与合规。

命令示例:@completeness-validator check、@completeness-validator check --tier 1、@completeness-validator report、@completeness-validator confirm --depth perfectus --interactive。深度等级可选用 superficialis、functionalis、integratus、productio、perfectus。输出为完成度验证报告,列出通过项、关键缺口、警告与建议下一步。

适用场景:AI 声称完成但怀疑只完成 99% 时;接受“完成”代码前检查是否有模拟数据或未连接系统;在 CI/CD 中做自动化首轮验证;作为人工评审的检查清单。

限制:不能保证 100% 准确。AST 分析可发现空函数但发现不了逻辑错误;运行时测试只能验证基本连通性;PRR 门禁需人工判断合规性;多语言提示不能消除幻觉。其成功率与价格、平台等信息暂未提供。