技能 Quality

测试

测试金字塔、框架(Vitest、Playwright、bats)、mock 规则、针对原生 SQL 的实时冒烟测试门禁。在编写或审查测试时使用。

概述

测试是一项参考技能,供开发者和审查者在编写或审查测试时加载。它定义了测试金字塔、各层推荐的框架,以及防止测试变得脆弱或具有误导性的严格 mock 规则。

测试金字塔

  1. 单元测试(70%)——在隔离环境中测试单个函数和类。mock 所有外部依赖。它们构成基础,并提供最快的反馈循环。
  2. 集成测试(20%)——测试模块、服务和数据库之间的交互。验证各组件能否正确协同工作。在可行的情况下使用真实数据库连接。
  3. E2E 测试(10%)——端到端测试关键用户流程。这些测试的编写和维护成本最高,因此应聚焦于价值最高的路径。

推荐框架

  • 后端——Jest、Mocha 或 Vitest
  • 前端——Vitest 配合 React Testing Library 进行组件测试
  • E2E——Playwright(首选)或 Cypress 用于浏览器自动化

Mock 规则

  • mock 外部 API(Stripe、AWS、第三方服务)——绝不在测试中访问真实服务
  • 在单元测试中 mock 数据库调用——仅在集成测试中使用真实数据库
  • 使用依赖注入,使 mock 更简单、更明确
  • 绝不要 mock 你实际正在测试的对象 — 如果缺陷类别存在于真实集成中(错误的客户端、schema 或方言),mock 测试会通过,而生产环境会失败
  • 适配器路径 fixture — mapper 测试应让原始数据库行 fixture 经过真实 mapper,绝不使用手工构建的输出对象
  • 对于精确的授权、执行、修订或消耗证明,断言直接证明相等,并通过实际运行器添加缺失/错误证明的对照

高级测试门禁

  • 实时冒烟测试门禁 — 对原生 SQL、跨数据源代码、迁移以及队列/webhook 代码强制执行。mock 无法捕获那些编译干净但在运行时命中错误数据库的错误客户端查询。针对真实目标数据源运行查询并记录结果。
  • 实时 Docker 冒烟测试 — 对跨容器 HTTP/RPC 调用、卷挂载配置以及容器内文件系统路径强制执行。241 个单元测试可以通过,而 3 个独立的运行时缺陷隐藏在 exec 位、主机名和 SSL 配置中。
  • 静默失败检测 — 针对出错时仍以 0 退出的子进程(LLM CLI、云工具)。解析结构化输出,而不是检查退出码。在包装器内部抛出错误,而不是在下游。
  • 规范 Lint 测试 — 对 commands/*.md 中的 markdown 散文契约进行正则断言。防止命令规范出现静默回归。
  • Shell 脚本测试(bats-core) — 对 bash 脚本(安装器、同步、部署)执行红绿纪律。通过 BATS_TEST_TMPDIR + HOME 重定向实现隔离。fixture 构建器模式、SUCCESS 标记模式、针对破坏性标志的健全性防护测试。
  • 部署后冒烟门禁 — 当部署更改运行时用户时,在切换 cron/systemd 之前以新用户运行一个完整周期。验证外部工具认证路径和文件 I/O 权限。
  • 交付路径保真度 — 打包、安装、升级和回滚的冒烟证据必须来自真实交付路径。
  • TDD 纪律 — 在生产代码之前先写失败测试的 RED-GREEN-REFACTOR,从各自的片段加载。
  • 遗留失败分诊 — 对继承的红色测试套件分为三类:过期删除、可修复补丁、重述内容。
  • 并发模式 — 提供者扇出和共享资源获取/释放;托管修复将安全回归与所有者进度测试配对。

入口技能会为每个子问题路由到一个支持片段(live-smoke-gates.md、silent-failure-detection.md、bats-and-spec-lint.md、tdd-discipline.md、triaging-legacy-failures.md、concurrency-patterns.md),以便 agent 只加载所需门禁。

使用时机

在编写代码时(TDD 循环:写测试、实现、重构)由 /dr-do 加载,在审查测试覆盖率和质量时由 /dr-qa 加载。这是一项无模型的参考技能 — 继承自调用它的 agent。