关于 test-engineer
面向 MomeiBlog 开发者的测试技能，用于编写和验证 Vue 与 TypeScript 测试。它强调定向、风险驱动的覆盖，适配 Nuxt 的模拟配置，并要求在指定工作树中运行测试。
主要功能
- 01使用 Vitest 编写 Vue 和 TypeScript 测试
- 02使用 pnpm 运行定向测试
- 03阅读测试覆盖率报告
- 04模拟 API 与 Nuxt 模块
- 05优先检查风险相关的失败路径
适用场景
- 01测试改动过的 Vue 组件或 TypeScript 模块
- 02模拟 Nuxt composables 和自动导入模块
- 03用定向断言验证缺陷修复
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/test-engineer确认已加载。
详细介绍
来自项目 READMETest Engineer Skill
- 测试编写: 使用 Vitest 编写针对 Vue 组件和 TypeScript 逻辑的测试。
- 测试运行: 熟练运行
pnpm test或针对特定文件的测试命令。 - 覆盖率分析: 阅读和理解测试覆盖率报告。
- Mocking: 模拟 API 响应、Nuxt composables (如
useI18n)，以及 Nuxt auto-import 模块（ofetch、#build/fetch.mjs）。
指令 (Instructions)
- Worktree 意识: 务必在
../momei-test工作树中运行测试命令。如果尚不存在该路径，应引导用户或自动创建之。 - 规范对齐: 在运行测试前必须阅读并遵循 测试规范 和 Nuxt 4.5.0+ $fetch Mock 模式。
- 测试策略: 优先执行定向测试 (Targeted Testing)，仅运行与改动相关的测试文件。
- 全量测试条件: 除非涉及大规模重构或安全风险，否则避免全量测试。全量测试通常仅在专门的"测试增强"任务中进行。
- 风险优先: 先锁定当前要证明或否证的行为风险，再决定写哪条测试；不要为了铺 coverage 同时扩写多个低相关场景。
- 失败路径优先: 修复缺陷或补守卫时，优先编写在缺陷存在时会失败的断言，再补成功路径回归。
- 用例设计: 同时覆盖正常流程、异常流程和边缘情况，但每个测试块应尽量围绕单一风险命名与归因。
- Mock 配置: 在测试文件中配置必要的 mock（如
useI18n）。 - 执行验证: 编写完后必须运行测试确保其通过；若首轮定向测试未能区分风险，再决定是否升级验证范围。
- CI 最终验证: 修复的最终了断是 CI 流水线全部通过，本地通过 ≠ CI 通过。
- Mock 策略变更: 当
vi.stubGlobal或globalThis.X = mock失效时，表明该 API 可能被框架 auto-import 机制劫持。排查方法与具体方案见 Nuxt 4.5.0 $fetch 修复报告。
评论
支持 Markdown