pytest-runner

pytest-runner 技能是專為 Python 開發人員與 QA 工程師設計的代理工作流程，提供穩健、安全且可重複的測試套件執行介面。它透過「基礎檢查優先」的架構，確保 Python 虛擬環境、依賴庫與 pytest 配置在執行測試前皆已就緒，從而避免環境誤差及導入錯誤。

• 智慧測試發現：自動識別符合命名規則的測試檔案，並在執行前顯示測試集收集結果。

• 安全導向執行：整合環境檢查（如自動啟動虛擬環境），確保測試在正確的上下文中進行。

• 全面覆蓋率報告：支援自動產生終端與 HTML 格式的覆蓋率報告，協助識別未測試的程式碼路徑。

• 失敗分析與恢復：捕獲測試輸出，記錄失敗並映射至標準 Pytest 錯誤類型（如 ImportError, FixtureError 等）。

• 彈性配置管理：原生支援標記 (markers)、過濾關鍵字與平行測試執行，無需手動修改腳本。

• 處理不確定性：針對多重測試目錄或不明確的閾值設定，設有明確的溝通與確認機制。

• 適用於使用 pytest、pytest-xdist 及 coverage.py 進行測試的 Python 開發團隊。

• 最佳應用場景包括 CI/CD 管線的本地驗證、單元測試、整合測試與回歸測試。

• 需確保專案內包含 pytest.ini 或 pyproject.toml 設定檔。

• 執行時會優先確認虛擬環境及必要套件是否安裝。

• 輸入：測試目錄路徑、測試標記或錯誤分析需求。

• 輸出：測試結果紀錄、覆蓋率摘要報告與錯誤診斷分析。

• 遵循嚴格的架構規範，確保測試執行與應用程式碼結構之間的關注點分離。