工程开发
triage-ci-flake
用于调查 Payload CMS 仓库中 CI 不稳定测试失败的系统性分类与复现工作流程。
简介
此技能提供了一套严谨且强制性的工作流程,用于分类和调查 Payload CMS 代码库中的 CI 测试失败。专为工程师与维护人员设计,用于处理那些在 CI 环境中发生但通常在本地开发时能通过的间歇性或“不稳定”测试失败。通过执行严格的隔离与环境复现步骤,此工具能协助厘清问题是源自暂时性的环境时间差、打包冲突,还是主分支中的真实回归。
-
自动化复现管道,要求通过 Playwright 与 Vitest 在本地执行失败的测试套件。
-
严格的服务器管理政策,强制在执行测试前清理并验证 3000 端口。
-
双模式测试方法:评估标准开发环境与类生产打包状态下的代码行为。
-
标准化记录与识别工作流程,将 CI 失败输出对应至特定的套件名称与测试描述符。
-
验证优先方法论,要求即时执行命令而非仅依赖静态日志分析。
-
强制输入包含套件名称、特定测试描述以及来自失败 GitHub Actions 或 CI 管线日志的完整堆栈跟踪。
-
工作流程需要使用如 pnpm dev 与 pnpm prepare-run-test-against-prod 等 pnpm 脚本,以确保环境尽可能贴近生产环境。
-
使用者在启动 E2E Playwright 测试前,必须使用 curl 验证服务器就绪状态以避免竞争条件。
-
若无法在本地复现测试,将触发特定的生产打包测试流程,以隔离构建过程或 vite 配置中的潜在问题。
-
此代理程序作为防护机制,确保开发者在未确认复现命令能在受控的本地实例中触发失败前,不会随意提交修复建议。
仓库统计
- Star 数
- 42,106
- Fork 数
- 3,643
- Open Issue 数
- 661
- 主要语言
- TypeScript
- 默认分支
- main
- 同步状态
- 空闲
- 最近同步时间
- 2026年4月29日 12:59