工程開發
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