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

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

@@ -1,69 +1,69 @@
----
-alwaysApply: false
-description: 项目的路由规范，包括路由配置结构、懒加载、导航守卫、路由 meta 定义。当新增、修改页面或配置路由时读取此规则。
----
-
-# 路由规范（NON-NEGOTIABLE）
-
-## 路由结构
-
-- 路由配置统一在 `src/router/` 目录下管理
-- 页面视图统一在 `src/views/` 目录下，使用 `kebab-case` 命名
-- 每个页面目录包含 `index.vue` 作为入口组件
-- 路由按业务模块拆分到 `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）
-
-所有页面级路由必须使用动态导入实现懒加载：
-
-```typescript
-{
-  path: '/dashboard',
-  name: 'Dashboard',
-  component: () => import('@/views/dashboard/index.vue'),
-  meta: { title: '仪表盘', requiresAuth: true },
-}
-```
-
-- 禁止在路由配置中静态导入页面组件
-- 布局组件（`src/layouts/`）允许静态导入
-
-## 路由 Meta 规范
-
-路由 `meta` 字段用于声明页面元信息，统一类型声明：
-
-```typescript
-declare module 'vue-router' {
-  interface RouteMeta {
-    title?: string
-    requiresAuth?: boolean
-    roles?: string[]
-    keepAlive?: boolean
-    hidden?: boolean
-  }
-}
-```
-
-## 导航守卫
-
-- 全局前置守卫在 `src/router/index.ts` 中注册，负责鉴权与页面标题设置
-- 禁止在组件内使用 `beforeRouteEnter` 处理鉴权逻辑，鉴权统一收敛到全局守卫
-- 组件级守卫（`onBeforeRouteLeave` 等）仅用于页面离开确认等局部场景
-
-## 约束
-
-- **禁止多处维护路由**：路由配置集中在 `src/router/modules/` 管理，禁止散落在其他目录
-- **避免重复注册**：同一页面组件只允许被一条路由引用
-- **路由命名唯一**：每条路由的 `name` 必须全局唯一
+---
+alwaysApply: false
+description: 项目的路由规范，包括路由配置结构、懒加载、导航守卫、路由 meta 定义。当新增、修改页面或配置路由时读取此规则。
+---
+
+# 路由规范（NON-NEGOTIABLE）
+
+## 路由结构
+
+- 路由配置统一在 `src/router/` 目录下管理
+- 页面视图统一在 `src/views/` 目录下，使用 `kebab-case` 命名
+- 每个页面目录包含 `index.vue` 作为入口组件
+- 路由按业务模块拆分到 `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）
+
+所有页面级路由必须使用动态导入实现懒加载：
+
+```typescript
+{
+  path: '/dashboard',
+  name: 'Dashboard',
+  component: () => import('@/views/dashboard/index.vue'),
+  meta: { title: '仪表盘', requiresAuth: true },
+}
+```
+
+- 禁止在路由配置中静态导入页面组件
+- 布局组件（`src/layouts/`）允许静态导入
+
+## 路由 Meta 规范
+
+路由 `meta` 字段用于声明页面元信息，统一类型声明：
+
+```typescript
+declare module 'vue-router' {
+  interface RouteMeta {
+    title?: string
+    requiresAuth?: boolean
+    roles?: string[]
+    keepAlive?: boolean
+    hidden?: boolean
+  }
+}
+```
+
+## 导航守卫
+
+- 全局前置守卫在 `src/router/index.ts` 中注册，负责鉴权与页面标题设置
+- 禁止在组件内使用 `beforeRouteEnter` 处理鉴权逻辑，鉴权统一收敛到全局守卫
+- 组件级守卫（`onBeforeRouteLeave` 等）仅用于页面离开确认等局部场景
+
+## 约束
+
+- **禁止多处维护路由**：路由配置集中在 `src/router/modules/` 管理，禁止散落在其他目录
+- **避免重复注册**：同一页面组件只允许被一条路由引用
+- **路由命名唯一**：每条路由的 `name` 必须全局唯一

package/.agents/rules/profiles/vue/07-/347/212/266/346/200/201/347/256/241/347/220/206.md

@@ -1,93 +1,93 @@
----
-alwaysApply: false
-description: 项目的状态管理规范，使用 Pinia 进行全局状态管理。当新增、修改或重构状态管理时读取此规则。
----
-
-# 状态管理规范（NON-NEGOTIABLE）
-
-## 基础规范
-
-- 状态管理必须使用 **Pinia**
-- 所有 store 文件必须放在 `src/store/modules/` 目录下，按业务模块划分子目录
-- **禁止在 `src` 下新建其他目录存放 store**
-- 禁止使用 Vuex 或其他状态管理方案
-
-## 目录结构
-
-```
-src/store/
-├── index.ts                    # 创建 Pinia 实例、统一导出
-└── modules/
-    ├── user/
-    │   ├── index.ts            # useUserStore
-    │   └── type.ts             # UserInfo 等类型定义
-    ├── app/
-    │   ├── index.ts            # useAppStore（主题、语言等全局配置）
-    │   └── type.ts
-    └── permission/
-        ├── index.ts            # usePermissionStore
-        └── type.ts
-```
-
-- 每个业务模块独立一个目录，目录名使用 `kebab-case`
-- 目录内必须包含 `index.ts`（store 定义）和 `type.ts`（类型定义）
-- `src/store/index.ts` 负责创建 Pinia 实例和统一导出所有 store
-
-## Store 编写规范
-
-- 统一使用 **Setup Store**（组合式语法），禁止 Options Store
-- 每个 store 暴露 `useXxxStore` 命名的函数
-- Store 中不要直接耦合具体 UI 组件，只存纯数据与业务行为
-
-```typescript
-// src/store/modules/user/type.ts
-export interface UserInfo {
-  id: string
-  name: string
-  avatar: string
-  roles: string[]
-}
-```
-
-```typescript
-// src/store/modules/user/index.ts
-import { ref, computed } from 'vue'
-import { defineStore } from 'pinia'
-import type { UserInfo } from './type'
-
-export const useUserStore = defineStore('user', () => {
-  const userInfo = ref<UserInfo | null>(null)
-  const isLoggedIn = computed(() => !!userInfo.value)
-
-  async function fetchUser() {
-    userInfo.value = await getUserInfo()
-  }
-
-  function resetUser() {
-    userInfo.value = null
-  }
-
-  return { userInfo, isLoggedIn, fetchUser, resetUser }
-})
-```
-
-## 在组件中使用
-
-解构响应式状态时必须使用 `storeToRefs`，保持响应性；Action 方法直接从 store 实例解构：
-
-```typescript
-const userStore = useUserStore()
-const { userInfo, isLoggedIn } = storeToRefs(userStore)
-const { fetchUser } = userStore
-```
-
-## 持久化
-
-当状态需要跨页面刷新保留时，使用 `pinia-plugin-persistedstate`，在 `defineStore` 第三个参数中配置 `persist: true`。
-
-## Store 拆分原则
-
-- 按业务领域拆分，每个模块单独一个目录
-- 禁止创建巨型 store，单个 store 的 `index.ts` 不超过 **200 行**
-- Store 之间可以相互引用，但禁止循环依赖
-- 模块私有类型放在模块目录下的 `type.ts`，全局共享类型放在 `src/types/`
+---
+alwaysApply: false
+description: 项目的状态管理规范，使用 Pinia 进行全局状态管理。当新增、修改或重构状态管理时读取此规则。
+---
+
+# 状态管理规范（NON-NEGOTIABLE）
+
+## 基础规范
+
+- 状态管理必须使用 **Pinia**
+- 所有 store 文件必须放在 `src/store/modules/` 目录下，按业务模块划分子目录
+- **禁止在 `src` 下新建其他目录存放 store**
+- 禁止使用 Vuex 或其他状态管理方案
+
+## 目录结构
+
+```
+src/store/
+├── index.ts                    # 创建 Pinia 实例、统一导出
+└── modules/
+    ├── user/
+    │   ├── index.ts            # useUserStore
+    │   └── type.ts             # UserInfo 等类型定义
+    ├── app/
+    │   ├── index.ts            # useAppStore（主题、语言等全局配置）
+    │   └── type.ts
+    └── permission/
+        ├── index.ts            # usePermissionStore
+        └── type.ts
+```
+
+- 每个业务模块独立一个目录，目录名使用 `kebab-case`
+- 目录内必须包含 `index.ts`（store 定义）和 `type.ts`（类型定义）
+- `src/store/index.ts` 负责创建 Pinia 实例和统一导出所有 store
+
+## Store 编写规范
+
+- 统一使用 **Setup Store**（组合式语法），禁止 Options Store
+- 每个 store 暴露 `useXxxStore` 命名的函数
+- Store 中不要直接耦合具体 UI 组件，只存纯数据与业务行为
+
+```typescript
+// src/store/modules/user/type.ts
+export interface UserInfo {
+  id: string
+  name: string
+  avatar: string
+  roles: string[]
+}
+```
+
+```typescript
+// src/store/modules/user/index.ts
+import { ref, computed } from 'vue'
+import { defineStore } from 'pinia'
+import type { UserInfo } from './type'
+
+export const useUserStore = defineStore('user', () => {
+  const userInfo = ref<UserInfo | null>(null)
+  const isLoggedIn = computed(() => !!userInfo.value)
+
+  async function fetchUser() {
+    userInfo.value = await getUserInfo()
+  }
+
+  function resetUser() {
+    userInfo.value = null
+  }
+
+  return { userInfo, isLoggedIn, fetchUser, resetUser }
+})
+```
+
+## 在组件中使用
+
+解构响应式状态时必须使用 `storeToRefs`，保持响应性；Action 方法直接从 store 实例解构：
+
+```typescript
+const userStore = useUserStore()
+const { userInfo, isLoggedIn } = storeToRefs(userStore)
+const { fetchUser } = userStore
+```
+
+## 持久化
+
+当状态需要跨页面刷新保留时，使用 `pinia-plugin-persistedstate`，在 `defineStore` 第三个参数中配置 `persist: true`。
+
+## Store 拆分原则
+
+- 按业务领域拆分，每个模块单独一个目录
+- 禁止创建巨型 store，单个 store 的 `index.ts` 不超过 **200 行**
+- Store 之间可以相互引用，但禁止循环依赖
+- 模块私有类型放在模块目录下的 `type.ts`，全局共享类型放在 `src/types/`

package/.agents/rules/profiles/vue/09-/346/240/267/345/274/217/350/247/204/350/214/203.md

@@ -1,67 +1,67 @@
----
-alwaysApply: false
-globs: ["**/*.vue", "**/*.scss", "**/*.css"]
-description: 项目的样式规范，包括 Scoped/CSS Modules 使用、主题 CSS 变量、暗色模式支持。当编写、修改组件样式或主题适配，或涉及 .vue/.scss/.css 文件时读取此规则。
----
-
-# 样式规范
-
-## 基础原则
-
-- 组件样式采用 **CSS Modules**（`style.module.scss`）或 `<style scoped>`
-- CSS Modules 优先于 scoped，需要动态 class 时使用 `$style` 或 `:class` 绑定
-- 禁止使用无作用域的全局样式（`<style>` 不加 `scoped` 或 `module`）
-- 全局样式仅允许在 `src/styles/` 目录中定义（变量、reset、mixins）
-
-## 主题色 CSS 变量（NON-NEGOTIABLE）
-
-自定义样式**必须**使用主题色 CSS 变量，**严格禁止**硬编码颜色值：
-
-```scss
-// ✅ 正确
-.card {
-  color: var(--color-text-primary);
-  background-color: var(--color-bg-container);
-  border: 1px solid var(--color-border);
-}
-
-// ❌ 错误
-.card {
-  color: #333;
-  background-color: #fff;
-}
-```
-
-### 推荐变量命名
-
-| 用途 | 变量名 | 说明 |
-|------|--------|------|
-| 主色 | `--color-primary` | 品牌主色 |
-| 文字 | `--color-text-primary` | 主要文字颜色 |
-| 文字次要 | `--color-text-secondary` | 次要文字颜色 |
-| 背景 | `--color-bg-container` | 容器背景色 |
-| 背景页面 | `--color-bg-page` | 页面级背景色 |
-| 边框 | `--color-border` | 默认边框色 |
-| 成功 | `--color-success` | 成功状态色 |
-| 警告 | `--color-warning` | 警告状态色 |
-| 错误 | `--color-error` | 错误状态色 |
-
-变量定义集中在 `src/styles/variables.scss`，通过 `:root` 和 `[data-theme="dark"]` 声明浅色与暗色值。
-
-## 暗色/浅色模式
-
-- 主题切换通过切换根元素的 `data-theme` 属性实现
-- 所有颜色值必须通过 CSS 变量引用，确保主题切换时自动适配
-- 组件库主题覆盖在 `src/styles/element-overrides.scss` 中统一管理
-
-## 设计稿颜色提取
-
-| 属性 | 含义 | CSS 对应 |
-|------|------|----------|
-| `fill` | 背景色 | `background-color` |
-| `stroke` | 边框色 | `border-color` |
-| `background_blur` | 毛玻璃 | `backdrop-filter: blur()` |
-| `shadow` | 阴影 | `box-shadow` |
-| `cornerRadius` | 圆角 | `border-radius` |
-
-**注意**：带有透明度的颜色需要转换为 RGBA 格式。例如 `#13131c73` 中 `73` 是透明度（十六进制），转换为十进制约 0.45。
+---
+alwaysApply: false
+globs: ["**/*.vue", "**/*.scss", "**/*.css"]
+description: 项目的样式规范，包括 Scoped/CSS Modules 使用、主题 CSS 变量、暗色模式支持。当编写、修改组件样式或主题适配，或涉及 .vue/.scss/.css 文件时读取此规则。
+---
+
+# 样式规范
+
+## 基础原则
+
+- 组件样式采用 **CSS Modules**（`style.module.scss`）或 `<style scoped>`
+- CSS Modules 优先于 scoped，需要动态 class 时使用 `$style` 或 `:class` 绑定
+- 禁止使用无作用域的全局样式（`<style>` 不加 `scoped` 或 `module`）
+- 全局样式仅允许在 `src/styles/` 目录中定义（变量、reset、mixins）
+
+## 主题色 CSS 变量（NON-NEGOTIABLE）
+
+自定义样式**必须**使用主题色 CSS 变量，**严格禁止**硬编码颜色值：
+
+```scss
+// ✅ 正确
+.card {
+  color: var(--color-text-primary);
+  background-color: var(--color-bg-container);
+  border: 1px solid var(--color-border);
+}
+
+// ❌ 错误
+.card {
+  color: #333;
+  background-color: #fff;
+}
+```
+
+### 推荐变量命名
+
+| 用途 | 变量名 | 说明 |
+|------|--------|------|
+| 主色 | `--color-primary` | 品牌主色 |
+| 文字 | `--color-text-primary` | 主要文字颜色 |
+| 文字次要 | `--color-text-secondary` | 次要文字颜色 |
+| 背景 | `--color-bg-container` | 容器背景色 |
+| 背景页面 | `--color-bg-page` | 页面级背景色 |
+| 边框 | `--color-border` | 默认边框色 |
+| 成功 | `--color-success` | 成功状态色 |
+| 警告 | `--color-warning` | 警告状态色 |
+| 错误 | `--color-error` | 错误状态色 |
+
+变量定义集中在 `src/styles/variables.scss`，通过 `:root` 和 `[data-theme="dark"]` 声明浅色与暗色值。
+
+## 暗色/浅色模式
+
+- 主题切换通过切换根元素的 `data-theme` 属性实现
+- 所有颜色值必须通过 CSS 变量引用，确保主题切换时自动适配
+- 组件库主题覆盖在 `src/styles/element-overrides.scss` 中统一管理
+
+## 设计稿颜色提取
+
+| 属性 | 含义 | CSS 对应 |
+|------|------|----------|
+| `fill` | 背景色 | `background-color` |
+| `stroke` | 边框色 | `border-color` |
+| `background_blur` | 毛玻璃 | `backdrop-filter: blur()` |
+| `shadow` | 阴影 | `box-shadow` |
+| `cornerRadius` | 圆角 | `border-radius` |
+
+**注意**：带有透明度的颜色需要转换为 RGBA 格式。例如 `#13131c73` 中 `73` 是透明度（十六进制），转换为十进制约 0.45。

package/.agents/rules/profiles/vue/11-/346/265/213/350/257/225/350/247/204/350/214/203.md

@@ -1,80 +1,80 @@
----
-alwaysApply: false
-description: Vue 项目的测试规范，包括测试框架选型（Vitest + @vue/test-utils）、文件约定、测试范围、编写规范与质量门禁。当编写测试或评审测试代码时读取此规则。
----
-
-# 测试规范（Vue）
-
-## 测试框架
-
-- 统一使用 **Vitest** 作为测试运行器（与 Vite 生态原生集成，兼容 Jest API）
-- 组件测试库：
-  - Vue：`@vue/test-utils`
-  - React：`@testing-library/react`
-- 页面元素定位统一使用 `data-testid` 属性，禁止依赖 CSS class 或 DOM 结构
-
-## 测试文件约定
-
-| 项目 | 约定 |
-|------|------|
-| 文件位置 | 与源文件同目录 |
-| 文件命名 | `<name>.test.ts` / `<name>.spec.ts` 或 `<name>.test.js` / `<name>.spec.js`（与源文件扩展名一致） |
-| 组件测试 | `<name>.test.tsx` / `<name>.test.jsx`（React）/ `<name>.test.ts` 或 `<name>.test.js`（Vue） |
-| 公共 Mock / 工具 | `tests/` 或 `src/__tests__/helpers/` |
-| 测试配置 | 项目根目录 `vitest.config.ts` 或 `vitest.config.js` |
-
-```text
-src/utils/
-├── formatDate.ts
-└── formatDate.test.ts       # 与源文件同目录
-```
-
-## 测试范围
-
-| 级别 | 说明 | 要求 |
-|------|------|------|
-| 必须测试 | 工具函数、Store 逻辑、复杂业务计算、数据转换 | 新增时必须附带测试 |
-| 建议测试 | 关键用户交互流程的组件测试、表单验证逻辑 | 核心页面推荐覆盖 |
-| 不要测试 | 组件内部实现细节、第三方库本身、纯 UI 展示 | 避免脆弱测试 |
-
-## 编写规范
-
-### 测试描述
-
-- `describe` 和 `it` / `test` 的描述使用中文（与 08-通用约束一致）
-- 描述应表达预期行为，而非实现步骤
-
-```ts
-describe('formatDate', () => {
-  it('应将时间戳转换为 YYYY-MM-DD 格式', () => {
-    expect(formatDate(1700000000000)).toBe('2023-11-15');
-  });
-
-  it('传入无效值时应返回空字符串', () => {
-    expect(formatDate(null)).toBe('');
-  });
-});
-```
-
-### 编写模式
-
-- 遵循 **Arrange-Act-Assert**（准备-执行-断言）模式
-- 测试行为而非实现：关注输入输出，不断言内部状态
-- 每个 `it` 只验证一个行为点
-- Mock 外部依赖（API、定时器），不 Mock 被测模块内部
-
-### 禁止模式
-
-| 禁止项 | 原因 |
-|--------|------|
-| 测试依赖执行顺序 | 测试应互相独立，可单独运行 |
-| 快照测试滥用 | 仅用于关键 UI 结构，禁止对大段 HTML 做快照 |
-| 硬编码延时（`setTimeout`） | 使用 `vi.useFakeTimers()` 或 `waitFor` |
-
-## 质量门禁（NON-NEGOTIABLE）
-
-- **TypeScript 项目**：必须通过 **`tsc --noEmit`**（或项目等价类型检查脚本）。
-- **纯 JavaScript 项目**：不强制 `tsc`；以 **ESLint**（及团队约定的检查脚本）为零 error 准绳。
-- 所有项目必须通过 **ESLint 检查**（零 error）。
-- 新增工具函数和 Store 必须附带测试用例。
-- 测试必须能独立运行，不依赖特定环境或执行顺序。
+---
+alwaysApply: false
+description: Vue 项目的测试规范，包括测试框架选型（Vitest + @vue/test-utils）、文件约定、测试范围、编写规范与质量门禁。当编写测试或评审测试代码时读取此规则。
+---
+
+# 测试规范（Vue）
+
+## 测试框架
+
+- 统一使用 **Vitest** 作为测试运行器（与 Vite 生态原生集成，兼容 Jest API）
+- 组件测试库：
+  - Vue：`@vue/test-utils`
+  - React：`@testing-library/react`
+- 页面元素定位统一使用 `data-testid` 属性，禁止依赖 CSS class 或 DOM 结构
+
+## 测试文件约定
+
+| 项目 | 约定 |
+|------|------|
+| 文件位置 | 与源文件同目录 |
+| 文件命名 | `<name>.test.ts` / `<name>.spec.ts` 或 `<name>.test.js` / `<name>.spec.js`（与源文件扩展名一致） |
+| 组件测试 | `<name>.test.tsx` / `<name>.test.jsx`（React）/ `<name>.test.ts` 或 `<name>.test.js`（Vue） |
+| 公共 Mock / 工具 | `tests/` 或 `src/__tests__/helpers/` |
+| 测试配置 | 项目根目录 `vitest.config.ts` 或 `vitest.config.js` |
+
+```text
+src/utils/
+├── formatDate.ts
+└── formatDate.test.ts       # 与源文件同目录
+```
+
+## 测试范围
+
+| 级别 | 说明 | 要求 |
+|------|------|------|
+| 必须测试 | 工具函数、Store 逻辑、复杂业务计算、数据转换 | 新增时必须附带测试 |
+| 建议测试 | 关键用户交互流程的组件测试、表单验证逻辑 | 核心页面推荐覆盖 |
+| 不要测试 | 组件内部实现细节、第三方库本身、纯 UI 展示 | 避免脆弱测试 |
+
+## 编写规范
+
+### 测试描述
+
+- `describe` 和 `it` / `test` 的描述使用中文（与 08-通用约束一致）
+- 描述应表达预期行为，而非实现步骤
+
+```ts
+describe('formatDate', () => {
+  it('应将时间戳转换为 YYYY-MM-DD 格式', () => {
+    expect(formatDate(1700000000000)).toBe('2023-11-15');
+  });
+
+  it('传入无效值时应返回空字符串', () => {
+    expect(formatDate(null)).toBe('');
+  });
+});
+```
+
+### 编写模式
+
+- 遵循 **Arrange-Act-Assert**（准备-执行-断言）模式
+- 测试行为而非实现：关注输入输出，不断言内部状态
+- 每个 `it` 只验证一个行为点
+- Mock 外部依赖（API、定时器），不 Mock 被测模块内部
+
+### 禁止模式
+
+| 禁止项 | 原因 |
+|--------|------|
+| 测试依赖执行顺序 | 测试应互相独立，可单独运行 |
+| 快照测试滥用 | 仅用于关键 UI 结构，禁止对大段 HTML 做快照 |
+| 硬编码延时（`setTimeout`） | 使用 `vi.useFakeTimers()` 或 `waitFor` |
+
+## 质量门禁（NON-NEGOTIABLE）
+
+- **TypeScript 项目**：必须通过 **`tsc --noEmit`**（或项目等价类型检查脚本）。
+- **纯 JavaScript 项目**：不强制 `tsc`；以 **ESLint**（及团队约定的检查脚本）为零 error 准绳。
+- 所有项目必须通过 **ESLint 检查**（零 error）。
+- 新增工具函数和 Store 必须附带测试用例。
+- 测试必须能独立运行，不依赖特定环境或执行顺序。