test-engineer

name	test-engineer
description	编写、补齐、运行和优化测试时使用，优先覆盖 Vitest 场景，也适用于组件逻辑、工具函数、状态管理和服务层的测试设计。用户提到 test、unit test、integration test、coverage、mock、Vitest、补测试时都应触发。
metadata	{"internal":true}

Test Engineer

铁律：测试要证明行为，而不是机械复刻实现细节。

工作流

• Step 1: 理解被测对象 ⚠️ REQUIRED
  • 1.1 先读源码与现有测试，找出关键分支和依赖。
  • 1.2 判断更适合写单元、集成还是更高层验证。
• Step 2: 设计测试集 ⚠️ REQUIRED
  • 2.1 至少覆盖主流程、失败路径和边界条件。
  • 2.2 确认哪些依赖需要 mock，哪些更适合真实调用。
• Step 3: 实现测试
  • 3.1 测试描述聚焦业务行为和预期结果。
  • 3.2 避免过度耦合内部实现细节。
• Step 4: 执行并解释结果
  • 4.1 运行最相关的测试命令。
  • 4.2 失败时先解释根因，再决定改代码还是改测试。

关注点

• 测试命名是否说明行为。
• mock 是否掩盖了真正的集成风险。
• 边界条件是否覆盖空值、异常和顺序问题。
• 新功能是否补了回归保护。

项目特化提示

• 如果仓库已有 tests/testSetup.ts 或全局 mock 入口，优先复用，不要在每个测试里重复造轮子。
• 涉及前端逻辑时，优先考虑对 useI18n、路由和外部请求的可控 mock。
• 写测试前先核对 package.json 中真实存在的测试命令与运行方式。

反模式

• 只测 happy path。
• 用快照或内部实现断言替代关键业务断言。
• 测试失败时直接改断言让它绿掉。

交付前检查

• 覆盖了主流程、失败路径和边界场景。
• 测试断言体现业务行为而非内部细节。
• 已运行相关测试或明确说明未运行原因。
• 如仍有测试缺口，已明确指出。