test-engineer

# 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。 - 用快照或内部实现断言替代关键业务断言。 - 测试失败时直接改断言让它绿掉。 ## 交付前检查 - [ ] 覆盖了主流程、失败路径和边界场景。 - [ ] 测试断言体现业务行为而非内部细节。 - [ ] 已运行相关测试或明确说明未运行原因。 - [ ] 如仍有测试缺口，已明确指出。