vitest-runner

vitest-runner 技能是一套專門的代理工作流程，旨在利用 Vitest 框架為 Node.js 環境提供全面的測試生命週期管理。它為執行測試套件、確保環境基礎配置以及進行失敗診斷提供了一個標準化介面。此技能專為開發人員與品質保證工程師設計，協助其建立可預測、可重現的測試流程，直接整合至開發工作中，在最大限度減少人工干預的同時，最大化測試結果與代碼品質的可見度。

• 以多種模式執行測試套件：包含單次執行、監控模式（watch mode）以及平行執行，以優化執行效能。

• 執行環境驗證，包含檢查 Node.js 版本、確認 package.json 內的相依性，以及檢查 vitest.config.ts 等配置文件的存在。

• 產生與處理代碼覆蓋率報告，協助評估代碼健康度並識別未測試的邏輯區塊。

• 具備整合式失敗分析協定，可捕捉 stdout/stderr、提取特定的斷言錯誤（AssertionError），並根據常見失敗類型（如模組解析錯誤、語法錯誤或逾時）提供診斷步驟。

• 自動掃描 *.test.ts 與 *.spec.ts 檔案格式，簡化測試探索流程，減少尋找相關測試檔案的阻力。

• 透過 CLI 選項（如 --grep 模式、--bail 與 --update 快照）支援細粒度的執行控制。

• 先決條件：需具備已安裝 Vitest 的 Node.js 專案。請在呼叫前確保 node_modules 已更新。

• 輸入：此技能操作測試檔案與配置設定。使用者應明確表達對於覆蓋率要求或特定測試子集的意圖。

• 輸出：提供格式化的 CLI 輸出、測試摘要報告，並將持久化數據儲存於 .aiwg/working/checkpoints/vitest-runner/ 目錄中以供會話追蹤。

• 安全性：遵守非破壞性政策；未經使用者明確確認，絕不會修改測試配置或原始碼，確保架構完整性。

• 升級機制：若偵測到模稜兩可的測試配置，或測試在多次自動重試後仍持續失敗，將自動向使用者升級請求介入。