@gong-ym/ai-spec-auto 0.2.14 → 0.2.15

package/.agents/rules/profiles/vue/01-/351/241/271/347/233/256/346/246/202/350/277/260.md

@@ -1,47 +1,47 @@
----
-alwaysApply: false
-description: 项目定位与技术栈概览。当需要了解项目背景、使用的技术栈时读取此规则。
----
-
-# 项目概述
-
-## 项目定位
-
-一个基于 Vue 3 + TypeScript 的单页应用（SPA）。
-
-> **与 JavaScript 存量项目的关系**：本文件默认描述团队推荐的 **Vue + TypeScript**。若 `package.json` 的 `dependencies` / `devDependencies` 中**未**声明 `typescript`，以「初始化项目规范」技能生成的 **01-项目概述.md** 为准，并遵循 **02-编码规范** 中的 JavaScript 小节。
-
-## 技术栈
-
-| 领域 | 技术 | 说明 |
-|------|------|------|
-| UI 框架 | Vue ^3.5 | 强制使用 Composition API + `<script setup>` |
-| 类型系统 | TypeScript 5.x | 推荐；新代码优先 TS。纯 JS 项目见 02-编码规范 |
-| 构建工具 | Vite 6.x | 开发与生产构建 |
-| 路由管理 | Vue Router ^4.5 | - |
-| 状态管理 | Pinia ^3.0 | 统一使用，禁止 Vuex 或其他方案 |
-| 组件库 | Element Plus ^2.9 | 所有交互 UI 优先基于 Element Plus 封装（可按项目替换） |
-| 样式方案 | SCSS Modules / Scoped Style | 推荐 CSS Modules，允许 `<style scoped>` |
-| HTTP 请求 | axios ^1.7 | 统一封装请求实例 |
-| 工具函数 | VueUse ^12.0 | 编写 composable 前，优先查找 VueUse 是否已提供 |
-| 通用工具 | lodash-es 4.17.21 | 编写工具函数前，优先考虑 lodash 已有实现 |
-| 时间工具 | dayjs 1.11.x | 涉及日期时间的处理统一用 dayjs |
-
-## 技术约束
-
-- Vue 组件**必须**使用 `<script setup>`，禁止 Options API。**TypeScript 项目**使用 `lang="ts"`；**JavaScript 项目**无 `lang` 或 `lang="js"`，类型与 JSDoc 见 02-编码规范
-- **TypeScript 项目**：禁止 `any`，Props、Emits、API 响应须有明确类型。**JavaScript 项目**：见 02 中 JavaScript 与 JSDoc 约定
-- 新增依赖前必须评估 bundle size 影响，优先使用 tree-shakable 的 ESM 包
-- 所有第三方组件库的二次封装必须基于项目指定组件库（默认 Element Plus）
-
-## 开发规范
-
-- 包管理器：统一使用 pnpm
-- 代码格式化：ESLint + Prettier，提交前自动格式化
-- Git 提交：遵循 Conventional Commits 规范
-- 路径别名：`@/` 指向 `src/` 目录
-
-## 浏览器兼容性
-
-- 支持现代浏览器（Chrome / Firefox / Safari / Edge 最近两个主版本）
-- 不支持 IE 11
+---
+alwaysApply: false
+description: 项目定位与技术栈概览。当需要了解项目背景、使用的技术栈时读取此规则。
+---
+
+# 项目概述
+
+## 项目定位
+
+一个基于 Vue 3 + TypeScript 的单页应用（SPA）。
+
+> **与 JavaScript 存量项目的关系**：本文件默认描述团队推荐的 **Vue + TypeScript**。若 `package.json` 的 `dependencies` / `devDependencies` 中**未**声明 `typescript`，以「初始化项目规范」技能生成的 **01-项目概述.md** 为准，并遵循 **02-编码规范** 中的 JavaScript 小节。
+
+## 技术栈
+
+| 领域 | 技术 | 说明 |
+|------|------|------|
+| UI 框架 | Vue ^3.5 | 强制使用 Composition API + `<script setup>` |
+| 类型系统 | TypeScript 5.x | 推荐；新代码优先 TS。纯 JS 项目见 02-编码规范 |
+| 构建工具 | Vite 6.x | 开发与生产构建 |
+| 路由管理 | Vue Router ^4.5 | - |
+| 状态管理 | Pinia ^3.0 | 统一使用，禁止 Vuex 或其他方案 |
+| 组件库 | Element Plus ^2.9 | 所有交互 UI 优先基于 Element Plus 封装（可按项目替换） |
+| 样式方案 | SCSS Modules / Scoped Style | 推荐 CSS Modules，允许 `<style scoped>` |
+| HTTP 请求 | axios ^1.7 | 统一封装请求实例 |
+| 工具函数 | VueUse ^12.0 | 编写 composable 前，优先查找 VueUse 是否已提供 |
+| 通用工具 | lodash-es 4.17.21 | 编写工具函数前，优先考虑 lodash 已有实现 |
+| 时间工具 | dayjs 1.11.x | 涉及日期时间的处理统一用 dayjs |
+
+## 技术约束
+
+- Vue 组件**必须**使用 `<script setup>`，禁止 Options API。**TypeScript 项目**使用 `lang="ts"`；**JavaScript 项目**无 `lang` 或 `lang="js"`，类型与 JSDoc 见 02-编码规范
+- **TypeScript 项目**：禁止 `any`，Props、Emits、API 响应须有明确类型。**JavaScript 项目**：见 02 中 JavaScript 与 JSDoc 约定
+- 新增依赖前必须评估 bundle size 影响，优先使用 tree-shakable 的 ESM 包
+- 所有第三方组件库的二次封装必须基于项目指定组件库（默认 Element Plus）
+
+## 开发规范
+
+- 包管理器：统一使用 pnpm
+- 代码格式化：ESLint + Prettier，提交前自动格式化
+- Git 提交：遵循 Conventional Commits 规范
+- 路径别名：`@/` 指向 `src/` 目录
+
+## 浏览器兼容性
+
+- 支持现代浏览器（Chrome / Firefox / Safari / Edge 最近两个主版本）
+- 不支持 IE 11

package/.agents/rules/profiles/vue/03-/351/241/271/347/233/256/347/273/223/346/236/204.md

@@ -1,106 +1,106 @@
----
-alwaysApply: false
-description: 项目的目录结构规范，定义了 src 目录下各目录的用途与约束（禁止新建非标准目录）。当需要确定代码应放在哪个目录时读取此规则。
----
-
-# 项目结构（NON-NEGOTIABLE）
-
-## 目录结构
-
-```
-src/
-├── api/           # 接口封装，按业务模块划分
-├── assets/        # 静态资源，按模块分子目录（如 login/、icon/、common/）
-├── components/    # 可复用 UI 组件
-├── composables/   # 组合式函数（useXxx）
-├── config/        # 配置文件（如 requestConfig.ts）
-├── constants/     # 业务常量、枚举
-├── directives/    # 自定义指令（如 vFocus.ts）
-├── layouts/       # 布局组件（DefaultLayout、BlankLayout 等）
-├── libs/          # 独立封装模块（如 crypto、富文本适配等较重的功能模块）
-├── mock/          # Mock 数据，按业务模块划分
-├── router/        # 路由配置与导航守卫（modules/ 按模块拆分）
-├── store/         # Pinia store
-│   └── modules/   # 按业务模块划分，每个模块含 index.ts + type.ts
-├── styles/        # 全局样式、变量、mixins
-├── types/         # 全局类型声明与 DTO
-├── utils/         # 通用工具函数
-├── views/         # 页面视图
-├── App.vue        # 根组件
-└── main.ts / main.js   # 入口文件（以仓库实际为准）
-```
-
-## 结构约束（禁止在 src 下新建非标准目录）
-
-| 类型 | 目录 | 规范 |
-|------|------|------|
-| 接口 | `src/api/` | 按模块划分，每个模块含请求函数；类型定义放 `src/api/types/` |
-| 静态资源 | `src/assets/<module>/` | 按模块分子目录，如 `login/`、`icon/`、`common/` |
-| 组件 | `src/components/` | 每个组件独立目录，包含 `index.vue` |
-| 组合式函数 | `src/composables/` | `useXxx.ts` 命名，纯逻辑复用 |
-| 配置 | `src/config/` | 配置文件，如 `requestConfig.ts` |
-| 常量 | `src/constants/` | 按模块划分，所有模块导出到 `index.ts` |
-| 自定义指令 | `src/directives/` | `vXxx.ts` 命名，如 `vFocus.ts` |
-| 脚本模块 | `src/libs/` | 独立封装的较重功能模块，每个模块 `<lib-name>/index.ts` |
-| Mock | `src/mock/` | Mock 数据，按业务模块划分 `<module>.ts` |
-| 页面 | `src/views/` | 每个页面独立目录，使用 `kebab-case` 命名 |
-| 路由 | `src/router/modules/` | 按业务模块拆分路由配置，每个模块一个 `.ts` 文件 |
-| 状态 | `src/store/modules/` | 按业务模块划分子目录，每个含 `index.ts` + `type.ts`，暴露 `useXxxStore` |
-| 全局样式 | `src/styles/` | 全局样式、变量、mixins |
-| 全局类型 | `src/types/` | 全局共享类型与 DTO，模块私有类型就近放置 |
-| 工具 | `src/utils/` | 轻量工具函数，按功能模块划分，统一导出 |
-
-## 页面目录内的组件放置规则
-
-页面专用组件放在 `src/views/<page>/components/` 目录：
-
-```
-src/views/<page>/
-  ├─ components/           # 仅供当前页面使用的子组件
-  │   └─ SomeWidget/
-  │       ├─ index.vue
-  │       └─ types.ts
-  ├─ index.vue             # 页面主组件
-  └─ style.module.scss     # 页面样式（可选）
-```
-
-**判断标准**：
-
-- 通用组件：多处复用、业务无关 → `src/components/`
-- 页面级组件：仅单页使用 → 页面目录下的 `components/`
-
-**约束**：`src/components/` 只存放通用组件，禁止将仅单页使用的组件放入。
-
-## Mock 数据策略
-
-当后端接口未完成时：
-
-### 目录结构
-
-```
-src/
-  ├─ mock/
-  │   └─ <module>.ts        # mock 数据文件，按业务模块划分
-  ├─ api/
-  │   └─ <module>.ts        # 请求函数（调用 mock 数据或真实接口）
-  └─ types/
-      └─ <module>.ts        # 全局类型定义
-```
-
-### 原则
-
-1. Mock 数据：创建 `src/mock/<module>.ts`，存放模拟数据
-2. 接口文件：创建 `src/api/<module>.ts`，包含请求函数（开发阶段可引用 mock）
-3. 类型定义：使用 `src/types/<module>.ts`（单文件），不创建目录
-4. 状态管理：不创建独立 Pinia store，必要时使用组件内 `ref`/`reactive`
-5. 优先级：UI 还原度优先于功能完整
-
-### 禁止
-
-- 禁止创建复杂的 mock 数据结构
-- 禁止创建独立的 store（接口未完成时）
-- 禁止预留过多扩展字段
-
-## 脚本与入口扩展名
-
-上表与目录树中的 `.ts`、`.tsx` 为 TypeScript 示例。**纯 JavaScript 项目**将对应文件改为 `.js` / `.jsx`（如 `main.js`、`router/modules/*.js`）。入口、路由、API、Mock、`types` 等路径须与 `src/` 实际一致；使用「初始化项目规范」技能时以扫描结果为准。
+---
+alwaysApply: false
+description: 项目的目录结构规范，定义了 src 目录下各目录的用途与约束（禁止新建非标准目录）。当需要确定代码应放在哪个目录时读取此规则。
+---
+
+# 项目结构（NON-NEGOTIABLE）
+
+## 目录结构
+
+```
+src/
+├── api/           # 接口封装，按业务模块划分
+├── assets/        # 静态资源，按模块分子目录（如 login/、icon/、common/）
+├── components/    # 可复用 UI 组件
+├── composables/   # 组合式函数（useXxx）
+├── config/        # 配置文件（如 requestConfig.ts）
+├── constants/     # 业务常量、枚举
+├── directives/    # 自定义指令（如 vFocus.ts）
+├── layouts/       # 布局组件（DefaultLayout、BlankLayout 等）
+├── libs/          # 独立封装模块（如 crypto、富文本适配等较重的功能模块）
+├── mock/          # Mock 数据，按业务模块划分
+├── router/        # 路由配置与导航守卫（modules/ 按模块拆分）
+├── store/         # Pinia store
+│   └── modules/   # 按业务模块划分，每个模块含 index.ts + type.ts
+├── styles/        # 全局样式、变量、mixins
+├── types/         # 全局类型声明与 DTO
+├── utils/         # 通用工具函数
+├── views/         # 页面视图
+├── App.vue        # 根组件
+└── main.ts / main.js   # 入口文件（以仓库实际为准）
+```
+
+## 结构约束（禁止在 src 下新建非标准目录）
+
+| 类型 | 目录 | 规范 |
+|------|------|------|
+| 接口 | `src/api/` | 按模块划分，每个模块含请求函数；类型定义放 `src/api/types/` |
+| 静态资源 | `src/assets/<module>/` | 按模块分子目录，如 `login/`、`icon/`、`common/` |
+| 组件 | `src/components/` | 每个组件独立目录，包含 `index.vue` |
+| 组合式函数 | `src/composables/` | `useXxx.ts` 命名，纯逻辑复用 |
+| 配置 | `src/config/` | 配置文件，如 `requestConfig.ts` |
+| 常量 | `src/constants/` | 按模块划分，所有模块导出到 `index.ts` |
+| 自定义指令 | `src/directives/` | `vXxx.ts` 命名，如 `vFocus.ts` |
+| 脚本模块 | `src/libs/` | 独立封装的较重功能模块，每个模块 `<lib-name>/index.ts` |
+| Mock | `src/mock/` | Mock 数据，按业务模块划分 `<module>.ts` |
+| 页面 | `src/views/` | 每个页面独立目录，使用 `kebab-case` 命名 |
+| 路由 | `src/router/modules/` | 按业务模块拆分路由配置，每个模块一个 `.ts` 文件 |
+| 状态 | `src/store/modules/` | 按业务模块划分子目录，每个含 `index.ts` + `type.ts`，暴露 `useXxxStore` |
+| 全局样式 | `src/styles/` | 全局样式、变量、mixins |
+| 全局类型 | `src/types/` | 全局共享类型与 DTO，模块私有类型就近放置 |
+| 工具 | `src/utils/` | 轻量工具函数，按功能模块划分，统一导出 |
+
+## 页面目录内的组件放置规则
+
+页面专用组件放在 `src/views/<page>/components/` 目录：
+
+```
+src/views/<page>/
+  ├─ components/           # 仅供当前页面使用的子组件
+  │   └─ SomeWidget/
+  │       ├─ index.vue
+  │       └─ types.ts
+  ├─ index.vue             # 页面主组件
+  └─ style.module.scss     # 页面样式（可选）
+```
+
+**判断标准**：
+
+- 通用组件：多处复用、业务无关 → `src/components/`
+- 页面级组件：仅单页使用 → 页面目录下的 `components/`
+
+**约束**：`src/components/` 只存放通用组件，禁止将仅单页使用的组件放入。
+
+## Mock 数据策略
+
+当后端接口未完成时：
+
+### 目录结构
+
+```
+src/
+  ├─ mock/
+  │   └─ <module>.ts        # mock 数据文件，按业务模块划分
+  ├─ api/
+  │   └─ <module>.ts        # 请求函数（调用 mock 数据或真实接口）
+  └─ types/
+      └─ <module>.ts        # 全局类型定义
+```
+
+### 原则
+
+1. Mock 数据：创建 `src/mock/<module>.ts`，存放模拟数据
+2. 接口文件：创建 `src/api/<module>.ts`，包含请求函数（开发阶段可引用 mock）
+3. 类型定义：使用 `src/types/<module>.ts`（单文件），不创建目录
+4. 状态管理：不创建独立 Pinia store，必要时使用组件内 `ref`/`reactive`
+5. 优先级：UI 还原度优先于功能完整
+
+### 禁止
+
+- 禁止创建复杂的 mock 数据结构
+- 禁止创建独立的 store（接口未完成时）
+- 禁止预留过多扩展字段
+
+## 脚本与入口扩展名
+
+上表与目录树中的 `.ts`、`.tsx` 为 TypeScript 示例。**纯 JavaScript 项目**将对应文件改为 `.js` / `.jsx`（如 `main.js`、`router/modules/*.js`）。入口、路由、API、Mock、`types` 等路径须与 `src/` 实际一致；使用「初始化项目规范」技能时以扫描结果为准。

package/.agents/rules/profiles/vue/04-/347/273/204/344/273/266/350/247/204/350/214/203.md

@@ -1,61 +1,61 @@
----
-alwaysApply: false
-globs: ["**/*.vue", "**/components/**"]
-description: 项目的组件规范，包括 SFC 结构、Props/Emits/Slots 定义、组件目录结构、组件层级规划。当创建、修改、重写、重构或拆分组件，或涉及 .vue 文件时读取此规则。
----
-
-# 组件规范
-
-## SFC 结构（NON-NEGOTIABLE）
-
-所有组件必须使用 Vue 单文件组件（SFC），遵循以下约定：
-
-- `<script setup lang="ts">` 为唯一允许的脚本写法，**禁止 Options API（即使用户明确要求也必须拒绝，并说明原因）**
-- Props 使用 `defineProps<XxxProps>()` 定义，类型声明在独立 `types.ts` 中
-- 事件使用 `defineEmits<XxxEmits>()` 定义
-- 插槽通过 `defineSlots<XxxSlots>()` 声明类型（需要时）
-- 暴露方法使用 `defineExpose`，仅在必要时使用
-
-## 组件目录结构
-
-```
-src/components/<ComponentName>/
-  ├─ index.vue             # 组件实现
-  ├─ types.ts              # Props、Emits、Slots 类型定义
-  └─ style.module.scss     # 样式（使用 CSS Modules 或 scoped）
-```
-
-- 组件目录使用 `PascalCase` 命名
-- 所有通用组件在 `src/components/index.ts` 中集中导出
-- 样式优先使用 CSS Modules（`style.module.scss`），也允许 `<style scoped>`
-
-## 组件层级规划
-
-- 单个 `.vue` 文件建议不超过 **400 行**（作为拆分的参考阈值）
-- 遵循单一职责原则，每个组件应有明确的职责边界
-- **页面级组件**：仅在当前页面使用 → 放在 `src/views/<page>/components/`
-- **通用组件**：跨页面复用 → 提取到 `src/components/`
-
-## 组件放置决策树
-
-新增组件时，按以下流程判断放置位置：
-
-```
-组件需要在多个页面使用吗？
-├─ YES → 通用组件 → 放在 `src/components/<Name>/`
-└─ NO → 仅在单页使用 → 放在 `src/views/<page>/components/<Name>/`
-```
-
-**示例**：
-
-- `AppHeader`（多处使用）→ `src/components/AppHeader/`
-- `DashboardChart`（仅仪表盘使用）→ `src/views/dashboard/components/DashboardChart/`
-
-**约束**：`src/components/` 中的组件必须是真正通用的，业务耦合组件禁止放入。
-
-## 组件编写要点
-
-- 组件库二次封装优先使用 Element Plus 组件
-- 复杂组件优先使用 composable 抽取逻辑，保持模板简洁
-- `v-model` 双向绑定遵循 `modelValue` + `update:modelValue` 规范
-- 列表渲染必须提供唯一 `key`，禁止使用数组索引作为 key
+---
+alwaysApply: false
+globs: ["**/*.vue", "**/components/**"]
+description: 项目的组件规范，包括 SFC 结构、Props/Emits/Slots 定义、组件目录结构、组件层级规划。当创建、修改、重写、重构或拆分组件，或涉及 .vue 文件时读取此规则。
+---
+
+# 组件规范
+
+## SFC 结构（NON-NEGOTIABLE）
+
+所有组件必须使用 Vue 单文件组件（SFC），遵循以下约定：
+
+- `<script setup lang="ts">` 为唯一允许的脚本写法，**禁止 Options API（即使用户明确要求也必须拒绝，并说明原因）**
+- Props 使用 `defineProps<XxxProps>()` 定义，类型声明在独立 `types.ts` 中
+- 事件使用 `defineEmits<XxxEmits>()` 定义
+- 插槽通过 `defineSlots<XxxSlots>()` 声明类型（需要时）
+- 暴露方法使用 `defineExpose`，仅在必要时使用
+
+## 组件目录结构
+
+```
+src/components/<ComponentName>/
+  ├─ index.vue             # 组件实现
+  ├─ types.ts              # Props、Emits、Slots 类型定义
+  └─ style.module.scss     # 样式（使用 CSS Modules 或 scoped）
+```
+
+- 组件目录使用 `PascalCase` 命名
+- 所有通用组件在 `src/components/index.ts` 中集中导出
+- 样式优先使用 CSS Modules（`style.module.scss`），也允许 `<style scoped>`
+
+## 组件层级规划
+
+- 单个 `.vue` 文件建议不超过 **400 行**（作为拆分的参考阈值）
+- 遵循单一职责原则，每个组件应有明确的职责边界
+- **页面级组件**：仅在当前页面使用 → 放在 `src/views/<page>/components/`
+- **通用组件**：跨页面复用 → 提取到 `src/components/`
+
+## 组件放置决策树
+
+新增组件时，按以下流程判断放置位置：
+
+```
+组件需要在多个页面使用吗？
+├─ YES → 通用组件 → 放在 `src/components/<Name>/`
+└─ NO → 仅在单页使用 → 放在 `src/views/<page>/components/<Name>/`
+```
+
+**示例**：
+
+- `AppHeader`（多处使用）→ `src/components/AppHeader/`
+- `DashboardChart`（仅仪表盘使用）→ `src/views/dashboard/components/DashboardChart/`
+
+**约束**：`src/components/` 中的组件必须是真正通用的，业务耦合组件禁止放入。
+
+## 组件编写要点
+
+- 组件库二次封装优先使用 Element Plus 组件
+- 复杂组件优先使用 composable 抽取逻辑，保持模板简洁
+- `v-model` 双向绑定遵循 `modelValue` + `update:modelValue` 规范
+- 列表渲染必须提供唯一 `key`，禁止使用数组索引作为 key

package/.agents/rules/profiles/vue/05-API/350/247/204/350/214/203.md

@@ -1,67 +1,67 @@
----
-alwaysApply: false
-description: Vue 项目的 API 规范，包括接口目录结构、请求封装、函数命名约定、类型定义、错误处理原则。当新增、修改、重构或重写接口时读取此规则。
----
-
-# API 规范（Vue）
-
-## 目录结构
-
-```text
-src/
-├── api/                    # 接口请求函数
-│   ├── login.ts
-│   ├── order.ts
-│   └── types/              # 请求/响应类型定义
-│       ├── login.ts
-│       └── order.ts
-└── config/
-    └── requestConfig.ts    # 请求全局配置
-```
-
-- 所有接口请求函数集中在 `src/api/<name>.ts` 中，按业务模块拆分文件
-- 请求/响应类型定义放在 `src/api/types/<name>.ts` 中
-- 禁止在组件、页面、store 中直接调用 `request`，必须通过 `src/api/` 下的函数
-
-## 接口请求规范
-
-- 使用 `@koi-design/vix-tools` 的 `request` 发起请求
-- 请求全局配置（超时、成功码、鉴权失败处理等）集中在 `src/config/requestConfig.ts`
-- 应用入口通过 `request.init(requestConfig)` 完成初始化
-
-```ts
-import { request } from '@koi-design/vix-tools';
-
-export function getOrderListApi(data: GetOrderListParams): Promise<GetOrderListResult> {
-  return request({
-    url: '/api/order/page',
-    method: 'post',
-    data,
-  });
-}
-```
-
-如需查看完整示例与落地步骤，请使用技能文件：
-
-- `.agents/skills/create-api/SKILL.md`
-
-## 接口函数命名（NON-NEGOTIABLE）
-
-| 操作 | 命名规则 | 示例 |
-|------|----------|------|
-| 获取列表 | getXxxListApi | `getOrderListApi` |
-| 获取详情 | getXxxDetailApi | `getOrderDetailApi` |
-| 创建 | createXxxApi | `createOrderApi` |
-| 更新 | updateXxxApi | `updateOrderApi` |
-| 删除 | deleteXxxApi | `deleteOrderApi` |
-
-- 统一使用 `Api` 后缀，区分接口函数与业务函数
-- **禁止**使用 `fetch` 前缀或匈牙利命名法
-
-## 接口错误处理（NON-NEGOTIABLE）
-
-`requestConfig` 中的 `API_RESPONSE_TRANSFER_METHOD` 和 `API_RESPONSE_ERROR_METHOD` 已统一处理接口错误，业务代码中**禁止重复添加** `message.error` 等错误提示：
-
-- 接口错误由请求配置统一处理，业务代码只需处理成功逻辑
-- 前端表单验证错误和业务逻辑检查错误可以保留
-- 成功提示可以保留（业务逻辑的成功反馈）
+---
+alwaysApply: false
+description: Vue 项目的 API 规范，包括接口目录结构、请求封装、函数命名约定、类型定义、错误处理原则。当新增、修改、重构或重写接口时读取此规则。
+---
+
+# API 规范（Vue）
+
+## 目录结构
+
+```text
+src/
+├── api/                    # 接口请求函数
+│   ├── login.ts
+│   ├── order.ts
+│   └── types/              # 请求/响应类型定义
+│       ├── login.ts
+│       └── order.ts
+└── config/
+    └── requestConfig.ts    # 请求全局配置
+```
+
+- 所有接口请求函数集中在 `src/api/<name>.ts` 中，按业务模块拆分文件
+- 请求/响应类型定义放在 `src/api/types/<name>.ts` 中
+- 禁止在组件、页面、store 中直接调用 `request`，必须通过 `src/api/` 下的函数
+
+## 接口请求规范
+
+- 使用 `@koi-design/vix-tools` 的 `request` 发起请求
+- 请求全局配置（超时、成功码、鉴权失败处理等）集中在 `src/config/requestConfig.ts`
+- 应用入口通过 `request.init(requestConfig)` 完成初始化
+
+```ts
+import { request } from '@koi-design/vix-tools';
+
+export function getOrderListApi(data: GetOrderListParams): Promise<GetOrderListResult> {
+  return request({
+    url: '/api/order/page',
+    method: 'post',
+    data,
+  });
+}
+```
+
+如需查看完整示例与落地步骤，请使用技能文件：
+
+- `.agents/skills/create-api/SKILL.md`
+
+## 接口函数命名（NON-NEGOTIABLE）
+
+| 操作 | 命名规则 | 示例 |
+|------|----------|------|
+| 获取列表 | getXxxListApi | `getOrderListApi` |
+| 获取详情 | getXxxDetailApi | `getOrderDetailApi` |
+| 创建 | createXxxApi | `createOrderApi` |
+| 更新 | updateXxxApi | `updateOrderApi` |
+| 删除 | deleteXxxApi | `deleteOrderApi` |
+
+- 统一使用 `Api` 后缀，区分接口函数与业务函数
+- **禁止**使用 `fetch` 前缀或匈牙利命名法
+
+## 接口错误处理（NON-NEGOTIABLE）
+
+`requestConfig` 中的 `API_RESPONSE_TRANSFER_METHOD` 和 `API_RESPONSE_ERROR_METHOD` 已统一处理接口错误，业务代码中**禁止重复添加** `message.error` 等错误提示：
+
+- 接口错误由请求配置统一处理，业务代码只需处理成功逻辑
+- 前端表单验证错误和业务逻辑检查错误可以保留
+- 成功提示可以保留（业务逻辑的成功反馈）