技能介绍

要解决的问题

CI 流水线里，一些 pytest 用例本身不稳定——可能在并发负载下偶发超时、依赖外部资源时随机失败，或在本地能过但线上环境触发边界条件。这类 flaky tests 一旦在 PR 合并前冒头，就会让构建变红，工程师不得不手动重跑整个套件，等待十几分钟只为确认某个用例是否只是临时抖动。更糟的是，如果没人盯着，这些偶发失败可能反复阻塞合并，拖慢交付节奏。

核心能力与工作方式

该技能通过 pytest-rerunfailures 插件为测试运行注入受控的有限重试规则。它不追求无限重跑，而是设定明确的重试边界：当某个用例失败时，插件会在当前会话内自动重新执行该用例（而非整个套件），直到达到预设的重试上限或最终稳定通过。代理层在此过程中可以捕获每次重试的结果，并基于最终状态——无论是成功还是持续失败——给出准确的测试报告。

具体执行时，技能依赖以下关键步骤：

在 pytest 启动参数中启用 --reruns 及可选的 --reruns-delay，控制最大重试次数与等待间隔
插件拦截失败用例，在隔离上下文中重新运行，避免污染其他测试的状态
重试耗尽后，原始失败信息会被完整保留并上报，不会因自动重跑而被掩盖
代理据此判断：是真实的回归缺陷，还是需要排查环境稳定性

适用边界与注意事项

此方案适用于已确认存在间歇性失败的用例，而非替代对确定性 bug 的修复。重试机制不能替代良好的测试隔离设计——如果用例间存在共享状态或外部依赖，重跑本身可能引入新的不确定性。此外，pytest-rerunfailures 对硬崩溃（hard crashes）的恢复能力有限，只能从特定类型的进程中断中恢复。使用前需确保环境满足 Python 3.10+、pytest 8.1+ 的先决条件，并理解重试次数不宜设置过高，以免延长 CI 时长掩盖真实问题。