Flaky Test Triage

---
name: flaky-test-triage
description: Flaky 测试分诊：复现、隔离、归因、修复与证据保留
---

# Flaky 测试分诊

## 何时使用

当测试间歇失败、重跑才通过，或 CI 与本地结果不一致时使用。

## 检查清单

### 复现

- 记录失败命令、环境、提交与失败频率；
- 用固定种子、单线程/重复运行尝试稳定复现；
- 不用“重跑通过”作为修复。

### 隔离

- 检查共享可变数据、执行顺序、时钟、随机数、网络与文件系统；
- 检查异步等待是否使用可观察状态，而不是固定 sleep；
- 检查资源泄漏与未清理的全局状态。

### 归因

- 区分产品缺陷、测试缺陷、环境缺陷与基础设施抖动；
- 找到最小失败用例，而不是保留大范围集成测试；
- 记录修复前的失败证据与修复后的复测结果。

### 处理

- 无法立即修复时隔离并标注 owner、原因与期限；
- 不用全局重试掩盖不稳定；
- 修复后删除临时隔离标记。

## 输出格式

- 失败签名与复现命令；
- 归因分类与证据；
- 修复/隔离决定；
- 复测结果与剩余风险。

## 反模式

- 把 `sleep` 调大当作修复；
- 用重试成功证明稳定；
- 删除失败测试而不记录原因。