测试创建

人工智能 社区

技能解读

当前原文的自动摘译,尚未人工审校。

我的能力

当你需要创建测试用例时,我会: 分析测试需求 - 确定测试范围、场景和 Mock 策略 生成测试文件 - 创建符合项目标准的完整测试文件 确保覆盖率 - 满足 80% 覆盖率要求 执行质量检查 - 验证测试代码质量

使用方式

使用格式:/test-create [测试类型] [目标文件或模块] 示例: /test-create mcp-tool "core/unified-server" /test-create cli-command "cli/commands/start" /test-create transport "transports/websocket-adapter"

mcp-tool - MCP 工具测试

测试重点:参数验证、API 调用、设备查找、错误处理 Mock 对象:外部服务、设备状态数据

service - 服务类测试

测试重点:业务逻辑、数据转换、异常处理 Mock 对象:外部 API、数据库连接

utility - 工具函数测试

测试重点:输入输出、边界值、类型安全 Mock 对象:通常无需 Mock

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
人工智能
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@shenjingnan · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
即装即用
是否需要外部接口密钥
不需要
兼容的系统
未声明(默认跨平台)
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

作者说明文件(原文) SKILL.md

# 测试创建技能

我是一个测试创建专家,专门为 xiaozhi-client 项目生成符合标准的测试用例。

## 我的能力

当你需要创建测试用例时,我会:

1. **分析测试需求** - 确定测试范围、场景和 Mock 策略
2. **生成测试文件** - 创建符合项目标准的完整测试文件
3. **确保覆盖率** - 满足 80% 覆盖率要求
4. **执行质量检查** - 验证测试代码质量

## 使用方式

使用格式:`/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 服务器

## 测试文件结构

```typescript
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、空字符串、空数组

## 测试执行命令

```bash
# 运行所有测试
pnpm test

# 运行特定测试文件
pnpm test src/server/{module}/{target}.test.ts

# 生成覆盖率报告
pnpm test:coverage
```

## 质量保证检查

```bash
pnpm typecheck      # TypeScript类型检查
pnpm lint            # 代码规范和格式检查
pnpm spellcheck     # 拼写检查
pnpm check:all       # 运行所有质量检查
```

## 测试最佳实践

### 测试命名

- 使用描述性的测试名称
- 采用中文描述
- 包含测试的具体场景和预期结果

### 测试结构

- 使用 AAA 模式:Arrange(准备)、Act(执行)、Assert(断言)
- 每个测试用例只验证一个行为
- 使用有意义的测试数据

### Mock 使用

- 只 Mock 外部依赖,不测试实现细节
- Mock 行为应该真实且一致
- 在测试后清理 Mock 状态

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。