SuperAPI AI 工具集

quarantine-test

测试与质量

查看项目

更新于 11-03 23:38

技能介绍

quarantine-test 面向测试与质量保障场景,用于在测试出现不稳定(flaky)问题时留下结构化的记录,而不是直接跳过或放宽检查。

用途:当某个测试的失败原因尚不明确时,用它把该测试登记到隔离清单中,同时保留可追溯的责任归属和证据,确保问题不会被悄悄忽略。

主要能力:

  • 记录测试的精确文件路径与标题路径到 tests/quarantine.json。
  • 为条目登记责任人、原因或证据、首次出现时间戳,以及七天内的修复或删除截止期限。
  • 状态区分:investigating(调查中)与 known-failure(已知失败);使用 quarantined 状态时必须提供完整 SHA 和证据。
  • 要求记录复现步骤与验收标准。
  • 隔离条目不会豁免测试执行,也不会让质量门禁变为通过;断言与超时保持不变。
  • 已解决的条目应被移除,而不是在文档中追加历史。

使用方式:

  1. 阅读 docs/testing.md 中关于 known-flaky-tests 的说明,以及 scripts/quarantine.ts。
  2. 优先从根源修复;若因果关系不明确,可在同一 SHA 上重跑失败测试一次,重复失败即视为真实问题,跳过用例不能证明任何事。
  3. 将条目写入 tests/quarantine.json,包含上述必要信息。
  4. 执行 pnpm exec prettier --write tests/quarantine.json 格式化文件。
  5. 执行 pnpm exec vitest run tests/quarantine.test.ts 进行校验。

适用场景:持续集成中出现的偶发失败测试管理、需要明确责任人与修复期限的测试治理流程。

限制:资料未说明该工具的收费、价格、支持平台或具体效果;其他未提及的事实暂未提供。