用途：为代码编写、补齐、运行和优化测试，覆盖 Vitest 场景，也适用于组件逻辑、工具函数、状态管理和服务层的测试设计。核心准则是测试要证明行为，而不是机械复刻实现细节。
工作流：先读源码与现有测试，找出关键分支和依赖，判断更适合单元、集成还是更高层验证；再设计测试集，至少覆盖主流程、失败路径和边界条件，并确认哪些依赖需要 mock、哪些适合真实调用；然后实现测试，测试描述聚焦业务行为和预期结果，避免过度耦合内部实现；最后运行最相关的测试命令，失败时先解释根因，再决定改代码还是改测试。
关注点：测试命名是否说明行为；mock 是否掩盖了真正的集成风险；边界条件是否覆盖空值、异常和顺序问题；新功能是否补了回归保护。
项目特化提示：若仓库已有 tests/testSetup.ts 或全局 mock 入口，优先复用，不要在每个测试里重复造轮子；涉及前端逻辑时，优先考虑对 useI18n、路由和外部请求的可控 mock；写测试前先核对 package.json 中真实存在的测试命令与运行方式。
反模式：只测 happy path；用快照或内部实现断言替代关键业务断言；测试失败时直接改断言让它变绿。
交付前检查：覆盖了主流程、失败路径和边界场景；测试断言体现业务行为而非内部细节；已运行相关测试或明确说明未运行原因；如仍有测试缺口，已明确指出。