vitest

此技能为使用 Vitest 测试 TypeScript 应用程序提供了结构化的指导。它强调实用的测试哲学，将开发精力集中在高价值与高风险的代码路径上，而非追求无意义的覆盖率指标。此技能协助 AI 编码代理针对业务逻辑、数据转换、Zod Schema 与复杂的工具函数编写强韧的测试，同时提供模拟外部服务与处理异步操作的清晰模式。它通过标准化的文件结构、命名惯例与测试数据工厂等辅助函数，推广测试驱动开发 (TDD) 的工作流程。

• 利用 vi.mock 与 vi.spyOn 实现高效的 Mocking 策略，以隔离测试单元并验证服务互动。

• 提供测试异步函数的强大模式，包括错误处理、网络请求模拟与基于 Promise 的断言。

• 包含验证 Zod Schema 与复杂验证逻辑的范本，以防止数据完整性回归。

• 提供定义测试数据工厂的结构化指引，以保持测试套件的整洁与易维护性。

• 配置执行测试的标准 CLI 工作流程，包括监控模式 (Watch mode)、文件筛选与覆盖率报告生成。

• 在实作新功能或重构遗留模块时使用此技能，以确保核心稳定性。

• 优先针对验证函数、复杂业务逻辑以及 bug 成本较高的代码编写测试。

• 略过琐碎的 Getter、Setter 或透传函数 (pass-through functions) 的测试，以维持 CI/CD 管线的高效率。

• 务必将测试文件与原始码共置 (例如 source.ts 与 source.test.ts)，以提升项目的可发现性与维护性。

• 记得在每个测试周期中使用 beforeEach 与 vi.clearAllMocks 清除 Mock，以避免测试之间的相互干扰。