code-standards.md

来自 cli/templates/level-3/

---
name: code-standards
description: >
  编码规范守卫。任何代码生成请求时自动参考。
  确保生成的代码符合项目约定的类型安全、错误处理和命名规范。
---

# 编码规范

生成代码前强制检查以下规则：

## TypeScript
- 所有函数必须有完整类型注解，禁止 any
- 使用 named export，禁止 default export
- 优先使用 interface 定义对象类型，type 用于联合/交叉类型

## API Route
- 所有输入用 zod schema 校验
- 统一响应格式：`{ data, error, meta }`
- 错误使用 AppError 类，不裸 throw Error

## React 组件
- 函数式组件 + hooks，Props 定义为独立 type
- 状态管理优先级：useState → useReducer → Zustand → Server State
- 列表渲染必须有稳定的 key

## 文件结构
- 单文件不超过 300 行，超出则拆分
- 文件命名 kebab-case，组件 PascalCase
- 新增代码优先参考项目中已有的同类实现

IMPORTANT：这些规则在任何代码生成时自动参考，不需要用户手动调用。