pandax 0.0.1

package/skills/pandax-frontend-api-mock/SKILL.md

@@ -0,0 +1,62 @@
+---
+name: "pandax-frontend-api-mock"
+category: "frontend"
+description: "规范 API 对接与 Mock 数据管理。Invoke when 新增接口请求、对接后端 API、编写 Mock 数据、或调整请求/响应拦截逻辑。"
+---
+
+# Pandax API 对接与 Mock 规范
+
+本 skill 用于规范前端与后端 API 的对接方式，以及本地 Mock 数据的组织管理。
+
+## 触发条件
+
+- 新增接口请求函数
+- 对接后端 API
+- 编写或修改 Mock 数据
+- 调整 axios/fetch 拦截器
+
+## 核心规则
+
+### 1. 请求层封装
+
+- 所有请求必须通过统一的请求客户端（如 `src/api/request.ts`）
+- 禁止在业务代码中直接使用 `axios.get` / `fetch`
+- 请求函数统一返回 Promise，错误统一由拦截器处理
+
+### 2. API 目录组织
+
+- 按业务模块划分文件，如 `src/api/user.ts`、`src/api/order.ts`
+- 每个函数名使用 `动词 + 名词`，如 `getUserList`、`createOrder`
+- 函数注释需包含接口路径、方法、主要字段说明
+
+### 3. 类型定义
+
+- 请求参数与响应数据必须使用 TypeScript 接口定义
+- 接口文件与 API 文件同目录或放在 `src/types/api/` 下
+- 禁止在业务代码中使用 `any` 接收接口返回值
+
+### 4. Mock 数据
+
+- Mock 服务使用 MSW 或项目统一方案
+- Mock 数据文件按模块放在 `src/mocks/` 或 `mock/` 下
+- Mock 响应结构必须与后端真实响应保持一致
+- 复杂字段需有注释说明业务含义
+
+### 5. 错误处理
+
+- 网络错误、超时、500 等统一提示"服务繁忙，请稍后再试"
+- 业务错误码（如 4001 参数错误）按后端约定提示具体信息
+- 401/403 统一跳转登录或无权限页面
+
+### 6. 加载与空态
+
+- 列表请求必须显示加载状态
+- 空数据必须展示空态组件，禁止空白无提示
+
+## 输出格式
+
+按以下结构给出建议：
+1. 当前实现的问题
+2. 规范的实现方式（附示例代码）
+3. 需要新增或调整的文件
+4. 是否需要补充类型定义或 Mock 数据