pytest-runner

pytest-runner 技能是一個專門的 AI 代理工作流程，旨在簡化 Python 測試套件的執行、管理與除錯。它為使用 pytest 框架進行測試提供了一套穩健且標準化的方法，確保在執行測試前環境已正確初始化、依賴項已驗證，並遵循測試配置。此技能適用於需要可靠且可重現的方式在開發環境或 CI/CD 流水線中執行單元、整合與功能測試的軟體工程師、品質保證人員及 DevOps 從業人員。

• 自動發現並執行符合命名模式（如 test_*.py 或 *_test.py）的 Python 測試檔案。

• 整合環境接地（Grounding）功能，確保在執行前虛擬環境（venv）已啟用且 pytest 已正確安裝。

• 進階執行能力，包括平行測試（pytest-xdist）、覆蓋率報告生成（pytest-cov）以及使用標記（markers，如 unit, slow）進行選擇性測試。

• 系統性的失敗分析與恢復協議，針對 ImportError、FixtureError 與 CollectionError 等錯誤進行分類，並提供引導式修復建議。

• 內建檢查點系統，利用 .aiwg/ 工作目錄持久化測試收集資料、結果歷史與覆蓋率報告，以進行長期效能追蹤。

• 支援標準配置檔案（如 pytest.ini 與 pyproject.toml），以維護團隊環境的一致性。

• 輸入：目標測試目錄或特定的檔案模式；有關標記或覆蓋率門檻的配置要求。

• 輸出：詳細的控制台輸出、結構化的 test_results.txt 日誌，以及基於終端機或 HTML 的覆蓋率摘要。

• 工作流程：該技能透過先進行環境接地、測試發現、根據使用者定義的選項執行測試，最後執行後續分析以擷取診斷資訊來運作。

• 約束條件：未經使用者批准，該技能明確拒絕修改測試配置，並會在偵測到多個目錄、模糊的覆蓋率閾值或不清楚的平行執行需求時尋求釐清，以降低幻覺風險。

• 最佳實踐：務必確認虛擬環境狀態；使用標記過濾測試範圍以加快迭代週期；在除錯過程中善用 --lf 與 --ff 選項聚焦於之前的失敗測試。