工程開發
triage-ci-flake avatar

triage-ci-flake

針對 Payload CMS 專案中不穩定的 CI 測試失敗進行分類與重現的系統化流程,透過在地端執行特定測試套件來排查問題。

簡介

triage-ci-flake 技能為開發人員提供了一套嚴謹且標準化的方法,用於調查並解決在 CI 環境中發生、但在地端卻無法重現的不穩定測試(flaky tests)。這些不穩定因素通常源於 Payload CMS 中的時序差異、打包問題或環境特定的配置,常在 PR 合併至主分支後出現。本技能強制執行「先重現」原則,嚴禁僅憑日誌進行分析,要求執行實際的環境指令以確保發現的問題是可操作且可驗證的。

  • 自動從 CI 日誌中提取相關的測試套件名稱、檔案路徑及錯誤詳情。
  • 管理地端開發環境與模擬生產環境,以隔離故障原因。
  • 處理伺服器生命週期操作,包括透過 curl 進行連接埠衝突解決與伺服器就緒狀態檢查。
  • 透過直接的 CLI 指令,針對特定的 Playwright 和 Vitest 測試套件執行測試。
  • 在開發模式與正式打包模式下分別驗證行為,以區分程式碼層級錯誤與基礎設施或打包問題。
  • 為除錯提供清晰的分支邏輯:確定故障是由開發程式碼錯誤還是正式構建產物引起。

當測試被標記為不穩定、間歇性失敗,或 E2E/整合測試意外逾時時,應啟動此技能。輸入需求包括套件名稱、特定的測試描述以及 CI 日誌背景。預期產出是一個已驗證、可重現的失敗場景,讓開發人員能直接進行問題修復。請注意,此過程涉及透過 pnpm 建置和打包套件,過程較為耗時,請確保地端系統資源充足。嚴格遵守伺服器管理規則(特別是終止連接埠 3000 上的現有程序)對於在分類階段防止假陰性至關重要。

倉庫統計

Star 數
42,100
Fork 數
3,644
Open Issue 數
660
主要語言
TypeScript
預設分支
main
同步狀態
閒置
最近同步時間
2026年4月29日 上午03:34
在 GitHub 查看