SuperAPI AI 工具集

demock

测试与质量

查看项目

更新于 11-09 16:50

技能介绍

用途:demock 用于检查真实代码路径上是否混入了测试替身、被吞掉的失败或未完成的占位实现,目标是让成功意味着工作确实发生,失败能带着原因暴露出来。检查范围由使用者指定,可以是文件、目录、diff 或刚做的改动,工具不会自行挑选目标。

主要能力:先用仓库的测试目录、文件命名规则和测试配置区分真实路径与测试路径;真实路径指从入口(构建产物、导出、handler、CLI)经导入与调用可达的代码,包括依赖注入或注册表接入的部分。然后运行自带脚本列出候选,输出文件、行号、类型和证据文本,支持 JSON 输出,退出码 0 表示无候选、3 表示有候选、2 表示用法错误。若仓库已有带吞失败规则的 linter(如 ruff BLE、S110、S112,ESLint no-empty,Go errcheck),可用仓库自身脚本或已安装的二进制运行并加入候选,不安装新工具。

使用方式:从技能文件夹运行 node scripts.mjs <paths...> [--test-glob <glob>]... [--json],按仓库约定为额外测试路径添加 --test-glob。候选按四类判断:测试替身出现在真实路径上;虚假成功,如捕获异常后转为成功、调用方无法分辨的回退、在权限/花费/删除/计数等关卡上缺少密钥或依赖时仍放行的逻辑;占位实现,即真实路径可达的未完成代码;有意设计,如运行时选择实现的接缝、调用方可见的降级、默认关闭的离线模式或被生产构建排除的代码。无法确认可达时标记为未验证。对前三类提出真实依赖或诚实失败的建议,关卡类建议拒绝。

适用场景:在提交或评审前核查真实路径可靠性,排查被 mock 掩盖的依赖,发现失败被悄悄吞掉的位置,识别未完成的占位实现。

限制:不扩大范围;测试内的替身不处理;边界处记录日志后重新抛出视为诚实失败,保留不动;修复不能用一个假实现替换另一个假实现;任何修改都需使用者批准,且每项修复先写一个失败的测试;没有发现时不改动任何文件。术语沿用 Gerard Meszaros 的测试替身分类和 Martin Fowler 的《Mocks Aren't Stubs》。