SuperAPI AI 工具集

reality-check

测试与质量

查看项目

更新于 10-15 19:58

技能介绍

Reality Check 是一个代码诚实性审计技能,定位为“无妥协的代码审计”。它不修改代码,只暴露问题,目标是找出让代码库产生虚假信心的模式。

用途:审计目标路径(默认当前项目根目录),可整体运行,也可用 --focus 参数聚焦单一类别:mocks(mock/stub 滥用)、errors(错误处理)、tests(测试质量)、todos(隐藏债务)、health(健康检查深度);不传或 --focus all 则运行全部类别。

主要能力:检测六类问题——mock 与 stub 滥用(如 jest.mock、sinon.stub、unittest.mock.patch、gomock 过度使用且无集成测试)、假实现(硬编码返回值、NotImplementedError、空函数体)、损坏的错误处理(空 catch、catch 返回 null 或 success、未捕获的 Promise、@ts-ignore)、无意义测试(无断言、同义反复断言、仅检查存在性、被跳过的测试)、隐藏技术债(TODO/FIXME/HACK、注释掉的代码、@deprecated 无替代说明,并用 git blame 判断是否超过 90 天)、浅层健康检查(返回 200 却不检查数据库、外部 API、队列、磁盘、内存等依赖)。

使用方式:技能按步骤执行——识别项目类型(package.json、go.mod、requirements.txt、Cargo.toml 等)、定位测试文件、按类别用 Grep 匹配模式并读取上下文、交叉引用发现、按严重级别(critical/warning/minor/info)分类,最后生成 Markdown 报告,包含汇总表、逐条发现(文件位置、代码证据、问题、建议、工作量)以及一句结论。

适用场景:在合并前或发布前审查代码库,识别测试是否真正验证行为、健康检查是否真正验证依赖、错误处理是否掩盖失败。

限制:该技能只审计不修复;报告输出为英文;需要目标代码库可访问并支持 grep 与 git blame;具体安装方式、收费与平台支持暂未提供。