Vitest测试模式Skill 用法详解

Vitest测试模式Skill：让 TypeScript 单元测试、模拟与浏览器模式测试一次上手

• 技能定位清晰：这是一个专注于 Vitest 测试模式的技能，覆盖单元测试、模拟测试、间谍测试和浏览器模式测试，面向 TypeScript 项目的测试实践。
• 开箱即用的知识库：从安装配置、核心概念、代码示例到最佳实践、常见陷阱、CI/CD 集成，形成完整的测试知识链条。
• 按需触发：技能声明为不可由用户直接调用（user-invocable: false），由 AI 在识别到「需要 Vitest 测试模式」时自动参考，减少无效干扰。
• 以文件读写与命令执行为基础：可用工具包括 Read、Write、Edit、Bash、Glob、Grep，便于在真实代码库中读取现有测试、生成用例、运行测试命令。
• 适合团队长期落地：包含团队标准、入职流程、代码审查清单与故障排除指南，可作为团队测试规范的参考底稿。

该技能叫什么？如何一键安装 AI 技能提升开发效率？

技能中文名：Vitest测试模式Skill 技能英文名：vitest-testing-patterns 技能ID：13891

它解决的问题很具体：在 TypeScript 项目里写测试时，开发者常常卡在「怎么组织测试文件」「Mock 怎么写才不污染其他用例」「间谍函数该在什么时候还原」「浏览器模式测试怎么配置」这类模式性问题上。这个技能把 Vitest 的测试模式、配置策略、代码示例和最佳实践沉淀成一份可被 AI 直接引用的知识资产，让 AI 在帮你写测试时不再泛泛而谈，而是给出符合 Vitest 习惯的写法。

关于「一键安装」，需要说明的是：技能详情中声明了 user-invocable: false，意味着它不是那种由用户手动输入命令触发的技能，而是由 AI 在对话中按需参考的能力模块。因此安装思路是「把技能导入你的 AI 技能环境，并确认 AI 能在测试类任务中引用它」，而不是执行某条测试命令。

通用安装思路与步骤如下（具体命令、入口与目录结构以官方说明为准）：

1. 确认安装前提：你的 AI 编程环境支持技能（Skill）机制，且已具备读取技能描述文件的能力；项目中最好已有或计划引入 Vitest 作为测试框架。
2. 导入技能包：通过技能市场、技能管理面板或本地技能目录导入 vitest-testing-patterns 技能，技能ID 为 13891，可据此在技能列表中核对是否为目标技能。
3. 确认工具授权：该技能声明的可用工具为 Read、Write、Edit、Bash、Glob、Grep。若你的环境需要逐项授权，请至少确保读取类（Read、Glob、Grep）与写入类（Write、Edit）工具可用，Bash 用于运行测试命令。
4. 验证是否生效：在对话中提出一个明确的测试类请求，例如「帮我为这个工具函数写一组 Vitest 单元测试，并说明如何用间谍函数验证回调被调用」。若回答中出现 Vitest 风格的测试结构、模拟与间谍用法，说明技能已被正确参考。
5. 验证失败的处理：若回答仍是通用测试建议，检查技能是否处于启用状态、项目上下文是否被正确加载，并尝试把问题描述得更贴近「Vitest 测试模式」这一触发场景。

需要特别提醒：由于该技能不可由用户直接调用，你不要期待有一个 /vitest-testing-patterns 之类的显式命令；它的价值在于「隐式增强」，即在你处理测试任务时自动补齐模式知识。

该技能的主要功能和特点

• 覆盖四类测试模式：单元测试、模拟测试（Mock）、间谍测试（Spy）、浏览器模式测试，基本对应 Vitest 日常使用的核心场景。
• 提供完整的配置视角：包括基础安装、配置文件设置、项目结构组织、团队协作设置与 CI/CD 集成准备，避免「只会写用例、不会配项目」的断层。
• 给出多组 TypeScript 代码示例：涵盖基础设置、配置对象应用、高级模式、工具集成、错误处理、性能优化、测试写法与生产就绪实现，示例虽为骨架式，但可作为向 AI 追问具体实现的锚点。
• 沉淀最佳实践清单：遵循约定、适当配置、验证输入、优雅处理错误、文档化决策、彻底测试、优化性能、维护安全、保持更新、监控生产，共十条，可直接作为团队评审口径。
• 列举常见陷阱：错误配置、缺少错误处理、性能差、测试不足、安全漏洞、紧耦合、忽略警告、过时依赖、没有监控、标准不一致，帮助在写测试前避开高频坑。
• 包含高级主题：自定义插件与扩展、行为修改、性能调优与并行执行、CI/CD 质量门、故障排除路径。
• 面向团队落地：提供标准建立、入职流程、代码审查清单（正确性、性能、安全性、可维护性）等组织级内容。

和普通工具相比，它强在「模式」而非「语法」：语法查文档即可，而模式决定了测试是否可维护、是否稳定、是否会被团队成员一致地写出来。

如何使用该技能？

以下是推荐的协作式使用流程，按步骤执行即可获得较稳定的产出：

1. 明确任务边界。先告诉 AI 你要测什么，例如「我要为一个负责金额格式化的函数写 Vitest 单元测试，函数位于 src/utils/money.ts」。边界越清晰，技能中的模式越容易被精准匹配。
2. 让它先读代码，再写测试。该技能具备 Read、Glob、Grep 能力，可让 AI 先定位实现与已有测试文件，避免凭空编造函数签名。示例指令：「先读取 src/utils/money.ts 与现有 __tests__ 目录，再按项目既有风格补测试」。
3. 指定测试类型。明确你要的是单元测试、模拟测试、间谍测试还是浏览器模式测试。例如：「用间谍函数验证 onChange 回调被调用的次数与参数」。
4. 约定输出内容。建议要求输出三部分：测试文件代码、所需配置改动、运行命令。示例输出说明：测试文件放在与被测文件约定的目录下，配置改动指向 Vitest 配置文件，运行命令用于执行该文件。
5. 让它执行并核对结果。在获得 Bash 授权的前提下，让 AI 运行测试命令并读取失败信息，再基于失败信息迭代。若环境不允许执行，则要求它给出可复现的命令与预期输出。
6. 补齐非功能要求。例如：「为这组测试补充错误路径用例，并说明如何避免 Mock 在用例之间互相污染」。
7. 沉淀为团队规范。把最终采纳的写法与最佳实践条目整理成团队文档，形成可复用的测试约定。

输入示例（可直接参考）：

请按 Vitest 测试模式，为 formatMoney 写单元测试。要求：覆盖整数、小数、负数、非法输入四种情况；对非法输入使用模拟测试替代真实依赖；用间谍函数验证内部日志函数被调用；最后给出运行命令与文件放置位置建议。

输出说明：预期得到一份结构化测试文件、一段配置说明、一条运行命令，以及对「为什么这样写」的简短解释——这正是该技能「模式 + 实践」双线输出的体现。

同类型竞品对比分析

方案名称	定位	核心功能	安装/使用门槛	适用场景	优势与不足
Vitest测试模式Skill（本技能）	AI 侧测试模式知识增强	单元测试、模拟测试、间谍测试、浏览器模式测试，配置与最佳实践	需接入支持技能机制的 AI 环境，无需额外运行时依赖	让 AI 帮你写、改、评审 Vitest 测试	优势是模式完整、贴合 Vitest 生态、含团队实践；不足是示例偏骨架，需结合真实代码追问细节
Vitest 官方文档	权威参考手册	API、配置项、迁移指南的完整说明	免费查阅，零安装	查具体 API 行为与配置字段	优势是权威详尽；不足是偏查阅型，不直接产出贴合你项目的测试代码
Jest 及其生态	通用 JavaScript 测试框架	断言、Mock、快照、覆盖率	需安装依赖并配置，生态成熟	存量项目、非 Vite 构建链路	优势是资料多、社区大；不足是与 Vite/TypeScript 项目的原生契合度不如 Vitest，配置迁移有成本
AI 通用编程助手（未接入该技能）	通用代码生成	可写任意框架的测试	门槛低，但结果依赖提示质量	零散、简单的测试补充	优势是随手可用；不足是容易写出非 Vitest 习惯的写法，Mock 与间谍用法不统一

选型建议：如果你已经在使用 Vitest 或计划迁移到 Vite 技术栈，本技能与官方文档搭配使用效率最高；如果是历史 Jest 项目，先评估迁移收益，再决定是否引入。

该技能的典型应用场景与实际体验情况

场景一：新项目搭建测试基线。 角色为前端负责人，痛点是「测试目录怎么分、配置放哪、CI 怎么卡质量门」没有统一答案。使用方式是让 AI 依据技能中的安装配置、项目结构与 CI/CD 集成内容，输出一份初始化清单。实际体验：上手难度低，配置项归类清晰；注意技能不提供具体版本号与命令，涉及版本与命令时以官方说明为准。

场景二：为存量函数补单元测试。 角色为业务开发，痛点是老代码缺测试、不敢改。使用方式是让 AI 先用 Grep 定位引用、再按单元测试模式补用例，并覆盖错误路径。实际体验：效果取决于代码可读性，若函数副作用多，需要先让 AI 拆出纯逻辑；建议一次只补一个模块，避免用例膨胀后难以审查。

场景三：Mock 与间谍测试的规范化。 角色为测试工程师，痛点是 Mock 在用例之间互相污染、间谍函数忘记还原导致串扰。使用方式是要求 AI 按技能中的错误处理与清理阶段要求，明确每个用例的还原动作。实际体验：这是该技能最有价值的部分，能把「隐形坑」显性化为检查项；注意务必在评审中确认清理逻辑真的存在。

场景四：浏览器模式测试与团队培训。 角色为团队技术负责人，痛点是浏览器模式测试配置复杂、新人上手慢。使用方式是结合技能的浏览器模式测试覆盖与入职流程、代码审查清单，形成培训材料。实际体验：作为教学底稿结构完整，但示例需替换为团队真实代码，否则新人难以迁移。

该技能能为用户带来的价值

• 提升效率：把「查文档—试写法—踩坑—返工」的循环压缩为一次结构化产出，测试文件的初稿几乎可以直接进入评审。
• 降低门槛：模拟测试与间谍测试是 Vitest 中最容易写错的部分，技能以模式化方式给出写法和清理要求，让经验不足的开发者也能产出可维护的测试。
• 统一团队口径：十项最佳实践、常见陷阱清单与代码审查清单，可直接转化为团队规范，减少「每个人写一种风格」的协作损耗。
• 降低长期维护成本：强调配置一致性与错误处理、避免紧耦合、保持依赖更新，这些都在减少未来测试失效与调试时间。
• 可量化的收益方向：可从「单个模块补测试所需时间」「测试评审返工次数」「CI 中测试失败的排查时长」三个指标观察改善，具体数值因团队基线而异。

常见问题 FAQ

Q1：这个技能怎么安装？需要付费吗？ 按前文的通用步骤，在支持技能机制的 AI 环境中导入技能（技能ID 13891），确认启用并在测试类任务中验证是否被引用即可。费用与授权方式取决于你所使用的技能平台，请以官方说明为准。

Q2：为什么我输入命令调用不了它？ 因为该技能声明为 user-invocable: false，它不由用户显式调用，而是由 AI 在识别到 Vitest 测试相关需求时自动参考。你只需把测试需求描述清楚，无需记命令。

Q3：它和直接查 Vitest 官方文档有什么区别？ 官方文档解决「这个 API 是什么」，本技能解决「这类测试该怎么组织」。前者是查阅，后者是模式与决策，两者搭配使用效果最好；涉及具体版本、命令与配置字段时，仍应以官方说明为准。

Q4：适合谁用？ 适合使用 TypeScript 与 Vitest 的前端/全栈开发者、需要建立测试规范的团队负责人，以及正在从其他测试框架迁移到 Vitest 的团队。若项目完全不用 Vitest，收益有限。

Q5：和 Jest 方案怎么选？ 已在 Vite 技术栈或追求与 TypeScript 更原生契合的项目，优先 Vitest 并配合本技能；存量 Jest 项目若迁移成本高，可先保持现状，评估迁移收益后再决定。