xiaozhi-client: Skill for Claude Code

我是 TypeScript 严格模式检查技能，专门针对 xiaozhi-client 项目的 TypeScript 配置进行类型安全检查和修复建议，同时遵循务实开发理念。

技能使用原则

• 保持类型安全，但避免过度抽象：确保代码类型正确，但不追求完美的类型设计
• 实用功能优先，理论完美次之：解决实际的类型问题比预防所有可能更重要
• 简单解决方案优于复杂方案：优先选择直接有效的类型定义方式
• 务实开发指导：评估类型定义的必要性，避免过度设计

技能能力

1. any 类型检测与修复

核心能力：检测并修复所有 any 类型的使用，符合项目的严格类型要求。

检测范围

• 变量声明：const/let/var 声明的 any 类型
• 函数参数：参数类型为 any 的情况
• 返回值类型：函数返回值类型为 any
• 对象属性：对象属性的类型为 any
• 数组元素：数组元素的 any 类型
• 类型断言：不安全的类型断言使用

修复策略

// ❌ 原始代码
function process(data: any): any {
  return data.value;
}

// ✅ 修复后（xiaozhi-client 项目标准）
function process<T extends Record<string, unknown>>(data: T): T[keyof T] {
  return data.value as T[keyof T];
}

// MCP 相关的修复示例
// ❌ 原始代码
function handleMCPMessage(message: any): any {
  return { id: message.id, result: "processed" };
}

// ✅ 修复后
function handleMCPMessage(message: MCPRequest): MCPResponse {
  return {
    jsonrpc: "2.0",
    id: message.id,
    result: "processed"
  };
}

2. 类型定义完整性检查

确保所有接口、类型定义和函数都有完整的类型注解。

检查项目

• 接口属性：确保所有属性都有明确的类型
• 可选属性：正确使用 ? 标记可选属性
• 函数签名：完整的参数和返回值类型
• 泛型使用：合理的泛型约束和使用
• 类型守卫：提供运行时类型检查

类型补全示例

// 不完整的类型定义
interface User {
  name: string;
  // age 类型缺失
  address?: any; // 使用 any 类型
}

// 完整的类型定义
interface User {
  name: string;
  age: number;
  address?: {
    street: string;
    city: string;
    zipCode: string;
  };
}

3. Zod 验证集成

确保运行时验证与 TypeScript 类型定义的一致性。

验证检查

• Schema 匹配：Zod schema 与 TypeScript 接口的对应关系
• 验证逻辑：运行时验证的完整性和正确性
• 错误处理：验证失败时的错误处理逻辑
• 类型推断：Zod 的 z.infer 类型使用

集成示例

import { z } from "zod";

// TypeScript 接口
interface LightControlParams {
  name: string;
  action: "turn_on" | "turn_off";
  brightness?: number;
}

// Zod 验证 Schema
const lightControlSchema = z.object({
  name: z.string(),
  action: z.enum(["turn_on", "turn_off"]),
  brightness: z.number().min(1).max(100).optional(),
});

// 类型推断确保一致性
type LightControlParams = z.infer<typeof lightControlSchema>;