test-creator

name test-creator description 测试创建技能，用于生成符合项目标准的测试用例 测试创建技能 我是一个测试创建专家，专门为 xiaozhi-client 项目生成符合标准的测试用例。 我的能力 当你需要创建测试用例时，我会： 分析测试需求 - 确定测试范围、场景和 Mock 策略 生成测试文件 - 创建符合项目标准的完整测试文件 确保覆盖率 - 满足 80% 覆盖率要求 执行质量检查 - 验证测试代码质量 使用方式 使用格式： /test-create [测试类型] [目标文件或模块] 示例 ： /test-create mcp-tool "core/unified-server" /test-create cli-command "cli/commands/start" /test-create transport "transports/websocket-adapter" /test-create utility "utils/config-parser" /test-create type "types/xiaozhi-config" /test-create service "managers/connection-manager" 支持的测试类型 mcp-tool - MCP 工具测试 测试重点 ：参数验证、API 调用、设备查找、错误处理 Mock 对象 ：外部服务、设备状态数据 service - 服务类测试 测试重点 ：业务逻辑、数据转换、异常处理 Mock 对象 ：外部 API、数据库连接 utility - 工具函数测试 测试重点 ：输入输出、边界值、类型安全 Mock 对象 ：通常无需 Mock type - 类型定义测试 测试重点 ：类型构造函数、类型守卫、错误类型 Mock 对象 ：根据具体需求定 cli-command - CLI 命令测试 测试重点 ：参数解析、配置加载、错误输出 Mock 对象 ：process.argv、console.log、文件系统 transport - 传输层适配器测试 测试重点 ：连接建立、消息收发、错误处理、重连 Mock 对象 ：WebSocket、HTTP 服务器 测试文件结构 import { describe, expect, it, beforeEach, afterEach, vi } from "vitest" ; // 导入要测试的模块（使用项目路径别名） import { TargetClass , TargetFunction } from "@/module/target-module" ; // 导入类型定义 import type { TargetType } from "@/module/target-module" ; describe ( "测试描述" , () => { beforeEach ( () => { // 测试前的准备工作 }); afterEach ( () => { // 测试后的清理工作 vi. clearAllMocks (); }); describe ( "功能分组" , () => { it ( "应该正确处理基本场景" , async () => { // 基础功能测试 }); it ( "应该正确处理边界条件" , async () => { // 边界条件测试 }); it ( "应该正确处理错误情况" , async () => { // 错误处理测试 }); }); }); 测试覆盖要求 基于 xiaozhi-client 项目覆盖率目标（80% 分支、函数、行、语句）： 必须覆盖的场景 正常流程 ：所有主要功能路径 边界条件 ：最小值、最大值、空值、null/undefined 错误处理 ：所有异常分支和错误码 异步操作 ：Promise、async/await 的各种状态 测试数据设计 有效数据 ：符合预期的正常输入 无效数据 ：各种格式错误的输入 边界数据 ：临界值和极值 特殊数据 ：null、undefined、空字符串、空数组 测试执行命令 # 运行所有测试 pnpm test # 运行特定测试文件 pnpm test src/server/{module}/{target}.test.ts # 生成覆盖率报告 pnpm test :coverage 质量保证检查 pnpm typecheck # TypeScript类型检查 pnpm lint # 代码规范和格式检查 pnpm spellcheck # 拼写检查 pnpm check:all # 运行所有质量检查 测试最佳实践 测试命名 使用描述性的测试名称 采用中文描述 包含测试的具体场景和预期结果 测试结构 使用 AAA 模式：Arrange（准备）、Act（执行）、Assert（断言） 每个测试用例只验证一个行为 使用有意义的测试数据 Mock 使用 只 Mock 外部依赖，不测试实现细节 Mock 行为应该真实且一致 在测试后清理 Mock 状态