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

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

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

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

@@ -1,46 +1,46 @@
----
-alwaysApply: false
-globs: ["**/*.tsx", "**/*.jsx", "**/components/**"]
-description: 项目的组件规范，包括组件目录结构、SCSS Modules 使用、组件层级规划（通用 vs 页面级）。当创建、修改、重写、重构或拆分组件，或涉及 .tsx/.jsx 文件时读取此规则。
----
-
-# 组件规范
-
-## 组件结构
-
-- 组件目录在 `src/components` 下，每个组件单独一个目录
-- 组件文件名为 `index.tsx`，样式文件为 `index.module.scss`
-- 所有组件必须导入到 `src/components/index.ts` 中集中导出
-- 组件必须使用 SCSS Modules，禁止使用全局样式
-- 交互组件库二次封装必须使用 Ant Design 组件
-- 组件必须使用清晰的 TS 类型定义，Props 接口必须明确
-- 使用 `classnames` 负责动态 class 管理
-
-如需查看创建组件的完整示例与拆分步骤，请使用技能文件：
-
-- `.agents/skills/create-component/SKILL.md`
-
-## 组件层级规划
-
-- 单个 `.tsx` 文件建议不超过 400 行（作为拆分的参考阈值）
-- 遵循单一职责原则，每个组件应有明确的职责边界
-- **页面级组件**：仅在当前页面使用 → 放在 `src/pages/<page>/components/`
-- **通用组件**：跨页面复用 → 提取到 `src/components/`
-
-## 组件放置决策树
-
-新增组件时，按以下流程判断放置位置：
-
-```
-组件需要在多个页面使用吗？
-├─ YES → 通用组件 → 放在 `src/components/<name>/`
-└─ NO → 仅在单页使用 → 放在 `src/pages/<page>/components/<name>/`
-```
-
-**示例**：
-
-- `ErrorBoundary`（多处使用）→ `src/components/error-boundary/`
-- `HomeHeader`（仅首页使用）→ `src/pages/home/components/header/`
-- `CraftSheetCard`（仅工艺单页面使用）→ `src/pages/craft-sheet/components/craft-sheet-card/`
-
-**约束**：`src/components/` 中的组件必须是真正通用的，业务耦合组件禁止放入。
+---
+alwaysApply: false
+globs: ["**/*.tsx", "**/*.jsx", "**/components/**"]
+description: 项目的组件规范，包括组件目录结构、SCSS Modules 使用、组件层级规划（通用 vs 页面级）。当创建、修改、重写、重构或拆分组件，或涉及 .tsx/.jsx 文件时读取此规则。
+---
+
+# 组件规范
+
+## 组件结构
+
+- 组件目录在 `src/components` 下，每个组件单独一个目录
+- 组件文件名为 `index.tsx`，样式文件为 `index.module.scss`
+- 所有组件必须导入到 `src/components/index.ts` 中集中导出
+- 组件必须使用 SCSS Modules，禁止使用全局样式
+- 交互组件库二次封装必须使用 Ant Design 组件
+- 组件必须使用清晰的 TS 类型定义，Props 接口必须明确
+- 使用 `classnames` 负责动态 class 管理
+
+如需查看创建组件的完整示例与拆分步骤，请使用技能文件：
+
+- `.agents/skills/create-component/SKILL.md`
+
+## 组件层级规划
+
+- 单个 `.tsx` 文件建议不超过 400 行（作为拆分的参考阈值）
+- 遵循单一职责原则，每个组件应有明确的职责边界
+- **页面级组件**：仅在当前页面使用 → 放在 `src/pages/<page>/components/`
+- **通用组件**：跨页面复用 → 提取到 `src/components/`
+
+## 组件放置决策树
+
+新增组件时，按以下流程判断放置位置：
+
+```
+组件需要在多个页面使用吗？
+├─ YES → 通用组件 → 放在 `src/components/<name>/`
+└─ NO → 仅在单页使用 → 放在 `src/pages/<page>/components/<name>/`
+```
+
+**示例**：
+
+- `ErrorBoundary`（多处使用）→ `src/components/error-boundary/`
+- `HomeHeader`（仅首页使用）→ `src/pages/home/components/header/`
+- `CraftSheetCard`（仅工艺单页面使用）→ `src/pages/craft-sheet/components/craft-sheet-card/`
+
+**约束**：`src/components/` 中的组件必须是真正通用的，业务耦合组件禁止放入。

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

@@ -1,67 +1,67 @@
----
-alwaysApply: false
-description: React 项目的 API 规范，包括接口目录结构、请求封装、函数命名约定、类型定义、错误处理原则。当新增、修改、重构或重写接口时读取此规则。
----
-
-# API 规范（React）
-
-## 目录结构
-
-```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: React 项目的 API 规范，包括接口目录结构、请求封装、函数命名约定、类型定义、错误处理原则。当新增、修改、重构或重写接口时读取此规则。
+---
+
+# API 规范（React）
+
+## 目录结构
+
+```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` 等错误提示：
+
+- 接口错误由请求配置统一处理，业务代码只需处理成功逻辑
+- 前端表单验证错误和业务逻辑检查错误可以保留
+- 成功提示可以保留（业务逻辑的成功反馈）

package/.agents/rules/profiles/react/06-/350/267/257/347/224/261/350/247/204/350/214/203.md

@@ -1,54 +1,54 @@
----
-alwaysApply: false
-description: 项目的路由规范，包括路由目录结构、模块配置、懒加载与路由集中管理原则。当新增、修改页面或配置路由时读取此规则。
----
-
-# 路由规范（NON-NEGOTIABLE）
-
-## 路由结构
-
-- 路由配置统一在 `src/router/` 目录下管理
-- 页面组件统一在 `src/pages/` 目录下，使用 `kebab-case` 命名
-- 路由按业务模块拆分到 `src/router/modules/` 目录
-
-```
-src/router/
-├── index.ts           # 创建路由实例、注册全局守卫
-└── modules/           # 按业务模块拆分路由配置
-    ├── dashboard.ts
-    ├── user-manage.ts
-    └── settings.ts
-```
-
-- 入口文件：`src/router/index.ts`
-- 模块文件：`src/router/modules/<module-name>.ts`，文件名使用 `kebab-case`
-
-## 懒加载（NON-NEGOTIABLE）
-
-所有页面级路由必须使用 `React.lazy` 实现懒加载：
-
-```typescript
-// src/router/modules/user-manage.ts
-import { lazy } from 'react'
-
-const UserManage = lazy(() => import('@/pages/user-manage'))
-
-const routes = [
-  {
-    path: '/user-manage',
-    element: <UserManage />,
-    meta: { title: '用户管理', requiresAuth: true },
-  },
-]
-
-export default routes
-```
-
-- 禁止在路由配置中静态导入页面组件
-- 布局组件（`src/layouts/`）允许静态导入
-
-## 路由与菜单规范（NON-NEGOTIABLE）
-
-- **禁止多处维护路由**：路由配置集中在 `src/router/modules/` 管理，禁止散落在其他目录
-- **避免重复注册**：同一页面组件只允许被一条路由引用
-- **路由命名唯一**：每条路由的标识必须全局唯一
+---
+alwaysApply: false
+description: 项目的路由规范，包括路由目录结构、模块配置、懒加载与路由集中管理原则。当新增、修改页面或配置路由时读取此规则。
+---
+
+# 路由规范（NON-NEGOTIABLE）
+
+## 路由结构
+
+- 路由配置统一在 `src/router/` 目录下管理
+- 页面组件统一在 `src/pages/` 目录下，使用 `kebab-case` 命名
+- 路由按业务模块拆分到 `src/router/modules/` 目录
+
+```
+src/router/
+├── index.ts           # 创建路由实例、注册全局守卫
+└── modules/           # 按业务模块拆分路由配置
+    ├── dashboard.ts
+    ├── user-manage.ts
+    └── settings.ts
+```
+
+- 入口文件：`src/router/index.ts`
+- 模块文件：`src/router/modules/<module-name>.ts`，文件名使用 `kebab-case`
+
+## 懒加载（NON-NEGOTIABLE）
+
+所有页面级路由必须使用 `React.lazy` 实现懒加载：
+
+```typescript
+// src/router/modules/user-manage.ts
+import { lazy } from 'react'
+
+const UserManage = lazy(() => import('@/pages/user-manage'))
+
+const routes = [
+  {
+    path: '/user-manage',
+    element: <UserManage />,
+    meta: { title: '用户管理', requiresAuth: true },
+  },
+]
+
+export default routes
+```
+
+- 禁止在路由配置中静态导入页面组件
+- 布局组件（`src/layouts/`）允许静态导入
+
+## 路由与菜单规范（NON-NEGOTIABLE）
+
+- **禁止多处维护路由**：路由配置集中在 `src/router/modules/` 管理，禁止散落在其他目录
+- **避免重复注册**：同一页面组件只允许被一条路由引用
+- **路由命名唯一**：每条路由的标识必须全局唯一