triage-ci-flake

此技能提供了一套嚴謹且強制性的工作流程，用於分類和調查 Payload CMS 程式碼庫中的 CI 測試失敗。專為工程師與維護人員設計，用於處理那些在 CI 環境中發生但通常在本地開發時能通過的間歇性或「不穩定」測試失敗。透過執行嚴格的隔離與環境復現步驟，此工具能協助釐清問題是源自暫時性的環境時間差、打包衝突，還是主分支中的真實回歸。

• 自動化復現管道，要求透過 Playwright 與 Vitest 在本地執行失敗的測試套件。

• 嚴格的伺服器管理政策，強制在執行測試前清理並驗證 3000 連接埠。

• 雙模式測試方法：評估標準開發環境與類生產打包狀態下的程式碼行為。

• 標準化記錄與識別工作流程，將 CI 失敗輸出對應至特定的套件名稱與測試描述符。

• 驗證優先方法論，要求即時執行命令而非僅依賴靜態日誌分析。

• 強制輸入包含套件名稱、特定測試描述以及來自失敗 GitHub Actions 或 CI 管線日誌的完整堆疊追蹤。

• 工作流程需要使用如 pnpm dev 與 pnpm prepare-run-test-against-prod 等 pnpm 腳本，以確保環境盡可能貼近生產環境。

• 使用者在啟動 E2E Playwright 測試前，必須使用 curl 驗證伺服器就緒狀態以避免競爭條件。

• 若無法在本地復現測試，將觸發特定的生產打包測試流程，以隔離建置過程或 vite 設定中的潛在問題。

• 此代理程式作為防護機制，確保開發者在未確認復現命令能在受控的本地執行個體中觸發失敗前，不會隨意提交修復建議。