用途：在 TypeScript 项目中处理 Vitest 相关任务，包括编写、运行或调试单元测试与组件测试、mock、测试工具和覆盖率。适用于 Node、bun、React/Next.js 以及 Effect 项目。
主要能力：围绕仓库既有的测试契约工作，涉及仓库配置、projects、setup、导入与全局变量、环境、别名、测试文件位置和清理逻辑。可处理组件、异步、fixture、快照、tag、浏览器模式等问题，也可处理模块、定时器、spy、全局边界等 mock 场景，以及 projects、迁移、覆盖率、reporter 选择等配置问题，并排查挂起、测试发现、解析和 flaky 状态。
使用方式：先定义行为或回归点，测试可观察的公开结果；mock 系统边界而非被测行为本身；遵循本地 fixture 与清理归属。在 Effect 仓库中使用既有的 @effect/vitest 约定，如 it.effect、Layers、TestClock，而非通用替代方案。修复 bug 时，条件允许下先复现失败再依赖通过结果。测试变更时先运行针对改动行为的最窄既有命令，仅当共享 setup 或契约变化时才运行受影响包的测试套件；仅当不存在项目脚本或配方时才使用 nlx vitest run。可复用已通过的结果，直到有新编辑、失败或未解决问题需要再次运行。
限制与注意：不要默认添加 globals、jsdom、覆盖率、新 setup 或浏览器模式。完成条件为在仓库配置下有一个有意义的聚焦测试通过，并为测试变更提供简洁的命令与结果证据；只读解释则需提供配置或 API 证据。不要仅为满足变更流程而添加或运行测试。有红转绿证据时使用 ### 🧪 Regression covered，否则使用 ### 🧪 Tests verified。