🎨 更新 TypeScript 开发规范，优化描述并添加数组类型定义和类型注解示例

.trae/skills/typescript-standards/SKILL.md

@@ -1,10 +1,12 @@
 ---
 name: "typescript-standards"
-description: "TypeScript 开发规范，包含 Enum 定义和 TSDoc 注释规范。编写 TypeScript 代码时调用此技能。"
+description: "TypeScript 开发规范，与 ESLint 配置保持一致。包含类型定义、数组语法、类型注解等规范。"
 ---
 
 # TypeScript 开发规范
 
+> 本规范与项目 ESLint 配置保持一致，编写 TypeScript 代码时必须遵守。
+
 ## 目录结构
 
 ```
@@ -27,20 +29,136 @@ src/enum/<Module>.ts               # 枚举常量 (.ts)
 
 ## 核心规则
 
-1. **禁止原生 enum** - 使用 `const` 对象模式
-2. **使用 `<const>` 断言** - 确保 readonly
-3. **类型派生** - `(typeof Type)[keyof typeof Type]`
-4. **JSDoc 注释** - 必须包含 `@since`，枚举还需 `@see`
-5. **聚合导出** - 相关枚举分组在 default export 对象中
+### 1. 数组类型定义
 
-## 类型注解
+**使用 `Array<T>` 语法，禁止使用 `T[]`**
+
+```typescript
+// ✅ 正确
+const list: Array<string> = [];
+const matrix: Array<Array<number>> = [];
+
+// ❌ 错误
+const list: string[] = [];
+const matrix: number[][] = [];
+```
+
+### 2. 类型注解与断言
+
+**优先使用类型注解 `: Type`，必要时使用 `<Type>` 断言，禁止使用 `as Type`**
+
+```typescript
+// ✅ 正确 - 优先使用类型注解
+const value: string = someValue;
+const count: number = getCount();
+const result: string = getValue();
+
+// ✅ 正确 - 必要时使用类型断言（如 DOM 元素、类型不匹配）
+const el: HTMLInputElement = <HTMLInputElement>document.getElementById('id');
+const data = <MyDataType>unknownValue;
+
+// ✅ 正确 - 函数参数和返回值
+function getUser(id: number): UserProfile {
+  return { id, name: "User" };
+}
+
+// ❌ 错误 - as 断言风格
+const value = someValue as string;
+const result = getValue() as string;
+
+// ❌ 错误 - 缺少类型注解
+function getUser(id): UserProfile {
+  return { id, name: "User" };
+}
+```
+
+### 3. 禁止原生 enum
+
+**使用 `const` 对象模式，使用 `<const>` 断言确保 readonly**
+
+```typescript
+// ✅ 正确
+const GameServerEnum = <const>{
+  CN_GF01: "cn_gf01",
+  CN_QD01: "cn_qd01",
+};
+
+type GameServerEnumType = (typeof GameServerEnum)[keyof typeof GameServerEnum];
+
+// ❌ 错误
+enum GameServerEnum {
+  CN_GF01 = "cn_gf01",
+  CN_QD01 = "cn_qd01",
+}
+```
+
+### 4. 类型定义
+
+**优先使用 `type` 而非 `interface`**
+
+```typescript
+// ✅ 正确
+type UserProfile = {
+  id: number;
+  name: string;
+};
+
+// ❌ 错误
+interface UserProfile {
+  id: number;
+  name: string;
+}
+```
+
+### 5. 类型注解规范
 
 - 函数参数和返回值必须显式类型注解
-- 优先用 `type` 而非 `interface`
-- 用 `unknown` 而非 `any`
-- 避免类型断言 (`as`)
+- 使用 `unknown` 而非 `any`
+- `ref` 泛型必须显式声明
+
+```typescript
+// ✅ 正确
+const count = ref<number>(0);
+const list = ref<Array<string>>([]);
+const isDone = ref<boolean>(false);
+
+function getUser(id: number): UserProfile {
+  return { id, name: "User" };
+}
+
+// ❌ 错误
+const count = ref(0); // 缺少泛型
+const list: string[] = ref([]); // 使用 [] 而非 Array
+
+function getUser(id): UserProfile { // 缺少参数类型
+  return { id, name: "User" };
+}
+```
+
+### 6. JSDoc 注释
+
+- 所有导出函数必须包含 `@since` 标签
+- 枚举常量需要 `@see` 标签
+
+```typescript
+/**
+ * 获取角色信息
+ * @since Beta v0.9.6
+ * @param id - 角色 ID
+ */
+function getCharacter(id: number): Character;
+```
+
+## ESLint 规则对应
+
+| 规则 | ESLint 配置 | 语法要求 |
+|------|------------|---------|
+| 数组类型 | `@typescript-eslint/array-type` | `Array<T>` |
+| 类型断言 | `@typescript-eslint/consistent-type-assertions` | `<Type>` |
+| 类型定义 | `@typescript-eslint/consistent-type-definitions` | `type` |
+| 导入顺序 | `import/order` | 分组排序 |
 
 ## 详细规范
 
 - Enum 定义：见 [enum.md](./enum.md)
-- TSDoc 注释：见 [tsdoc.md](./tsdoc.md)
+- TSDoc 注释：见 [tsdoc.md](./tsdoc.md)