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/ 目录中以供会话追踪。

• 安全性：遵守非破坏性政策；未经用户明确确认，绝不会修改测试配置或源代码，确保架构完整性。

• 升级机制：若检测到模棱两可的测试配置，或测试在多次自动重试后仍持续失败，将自动向用户升级请求介入。