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 选项聚焦于之前的失败测试。