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

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

@@ -1,80 +1,80 @@
----
-alwaysApply: false
-description: React 项目的测试规范，包括测试框架选型（Vitest + @testing-library/react）、文件约定、测试范围、编写规范与质量门禁。当编写测试或评审测试代码时读取此规则。
----
-
-# 测试规范（React）
-
-## 测试框架
-
-- 统一使用 **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: React 项目的测试规范，包括测试框架选型（Vitest + @testing-library/react）、文件约定、测试范围、编写规范与质量门禁。当编写测试或评审测试代码时读取此规则。
+---
+
+# 测试规范（React）
+
+## 测试框架
+
+- 统一使用 **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 必须附带测试用例。
+- 测试必须能独立运行，不依赖特定环境或执行顺序。

package/.agents/rules/profiles/react/13-/344/273/243/347/240/201/346/240/274/345/274/217/345/214/226/344/270/216/346/243/200/346/237/245.md

@@ -1,159 +1,159 @@
----
-alwaysApply: false
-description: React 项目的代码格式化与静态检查规范，包括 ESLint、Prettier 的工具链职责、统一配置规则与开发流程集成。当配置或调整 lint/format 工具时读取此规则。
----
-
-# 代码格式化与检查（React）
-
-## 工具链
-
-| 工具 | 职责 | 配置文件 |
-|------|------|----------|
-| **Prettier** | 代码格式化（缩进、引号、分号等） | `.prettierrc.json` |
-| **ESLint** | 代码质量与风格检查（未使用变量、潜在 bug 等） | `.eslintrc.cjs` / `.eslintrc.js` |
-| **Stylelint** | 样式文件检查（CSS/SCSS/Less 规范） | `.stylelintrc.json` |
-
-三者职责不重叠：Prettier 管格式，ESLint 管逻辑，Stylelint 管样式。
-
-## 配置来源
-
-- 项目根目录的 lint/format 配置文件由**规范库统一管理**
-- `install.sh init` 时自动部署到目标项目，`update` 时同步更新
-- 项目可在基础配置上**扩展**（如追加 i18n 插件），但不应修改基础规则
-
-## Prettier 统一规则
-
-| 配置项 | 值 | 说明 |
-|--------|-----|------|
-| `semi` | `true` | 语句末尾加分号 |
-| `tabWidth` | `2` | 缩进 2 空格 |
-| `singleQuote` | `true` | 使用单引号 |
-| `printWidth` | `100` | 单行最大宽度 |
-| `trailingComma` | `"es5"` | 对象/数组末尾加逗号（减少 diff 噪音） |
-| `endOfLine` | `"auto"` | 自动适配换行符 |
-| `arrowParens` | `"avoid"` | 单参数箭头函数省略括号 |
-| `proseWrap` | `"never"` | Markdown 不自动换行 |
-
-## ESLint 核心规则
-
-### 通用基础
-
-- 项目根据自身技术栈在 `extends` 中配置合适的共享规则集
-- 项目可追加插件（如 `@intlify/vue-i18n`、`eslint-plugin-import` 等）
-
-### Vue 项目
-
-```js
-// .eslintrc.cjs
-module.exports = {
-  root: true,
-  // 项目按需配置 extends（如 eslint:recommended、plugin:vue/vue3-recommended 等）
-};
-```
-
-### React 项目
-
-```js
-// .eslintrc.js
-module.exports = {
-  root: true,
-  settings: {
-    'import/resolver': {
-      alias: [['@', './src']],
-    },
-  },
-  // 项目按需配置 extends（如 eslint:recommended、plugin:react/recommended 等）
-};
-```
-
-## Stylelint 核心规则
-
-- 继承 `stylelint-config-standard` 基础规则
-- Vue 项目追加 `stylelint-config-html/vue` 和 `stylelint-config-recommended-vue`
-- 使用 `postcss-html` 作为自定义语法解析器（解析 `.vue` 文件中的 `<style>`）
-- 忽略与业务组件库冲突的规则（如 `no-descending-specificity`）
-
-## 开发流程集成
-
-### IDE 保存时自动格式化（推荐）
-
-项目可在 `.vscode/settings.json` 中配置：
-
-```json
-{
-  "editor.formatOnSave": true,
-  "editor.defaultFormatter": "esbenp.prettier-vscode",
-  "editor.codeActionsOnSave": {
-    "source.fixAll.eslint": "explicit",
-    "source.fixAll.stylelint": "explicit"
-  }
-}
-```
-
-### 提交前自动检查（husky + lint-staged）
-
-使用 `husky` 注册 Git hooks，`lint-staged` 只检查暂存文件：
-
-| 工具 | 职责 | 配置文件 |
-|------|------|----------|
-| husky | 注册 Git hooks（pre-commit、commit-msg） | `.husky/` |
-| lint-staged | 对暂存文件执行 lint/format | `.lintstagedrc` |
-| commitlint | 校验 commit message 格式 | `commitlint.config.js` |
-
-**部署前提**：上述 `.husky/`、`.lintstagedrc`、`commitlint.config.js` 仅在执行 `install.sh` / `install.ps1` 时**选择安装提交校验**（`--husky` 或交互选 Y）后才会复制到目标项目并配合 `husky install` 注册 Git hooks。若选择跳过提交校验（`--no-husky` 或交互选 N），则不会下发这些文件；仅安装 lint/format 时只会得到 ESLint、Prettier、Stylelint 等配置。
-
-**lint-staged 检查范围**：
-
-```json
-{
-  "src/**/*.{vue,less,scss,css}": [
-    "stylelint --fix"
-  ],
-  "src/**/*.{js,ts,jsx,tsx,json,vue}": [
-    "eslint --fix"
-  ]
-}
-```
-
-### Commit Message 规范（Conventional Commits）
-
-统一使用 [Conventional Commits](https://www.conventionalcommits.org/) 格式，由 commitlint 强制校验：
-
-```
-<type>(<scope>): <subject>
-```
-
-| type | 说明 |
-|------|------|
-| `feat` | 新功能 |
-| `fix` | 修复 bug |
-| `docs` | 文档变更 |
-| `style` | 代码格式（不影响逻辑） |
-| `refactor` | 重构（非新功能、非修复） |
-| `test` | 测试相关 |
-| `chore` | 构建、工具、依赖等杂项 |
-
-**示例**：
-
-```
-feat(order): 新增工单批量导出功能
-fix(auth): 修复 token 过期后未跳转登录页的问题
-docs(api): 补充资产库接口类型定义
-```
-
-- `scope` 可选，建议填写业务模块名
-- `subject` 使用中文，简明扼要
-
-## 忽略文件约定
-
-各工具的 ignore 文件遵循统一基线，至少忽略以下目录：
-
-```
-node_modules
-dist
-lib
-assets
-public
-```
-
-项目可根据实际情况追加特有的忽略路径。
+---
+alwaysApply: false
+description: React 项目的代码格式化与静态检查规范，包括 ESLint、Prettier 的工具链职责、统一配置规则与开发流程集成。当配置或调整 lint/format 工具时读取此规则。
+---
+
+# 代码格式化与检查（React）
+
+## 工具链
+
+| 工具 | 职责 | 配置文件 |
+|------|------|----------|
+| **Prettier** | 代码格式化（缩进、引号、分号等） | `.prettierrc.json` |
+| **ESLint** | 代码质量与风格检查（未使用变量、潜在 bug 等） | `.eslintrc.cjs` / `.eslintrc.js` |
+| **Stylelint** | 样式文件检查（CSS/SCSS/Less 规范） | `.stylelintrc.json` |
+
+三者职责不重叠：Prettier 管格式，ESLint 管逻辑，Stylelint 管样式。
+
+## 配置来源
+
+- 项目根目录的 lint/format 配置文件由**规范库统一管理**
+- `install.sh init` 时自动部署到目标项目，`update` 时同步更新
+- 项目可在基础配置上**扩展**（如追加 i18n 插件），但不应修改基础规则
+
+## Prettier 统一规则
+
+| 配置项 | 值 | 说明 |
+|--------|-----|------|
+| `semi` | `true` | 语句末尾加分号 |
+| `tabWidth` | `2` | 缩进 2 空格 |
+| `singleQuote` | `true` | 使用单引号 |
+| `printWidth` | `100` | 单行最大宽度 |
+| `trailingComma` | `"es5"` | 对象/数组末尾加逗号（减少 diff 噪音） |
+| `endOfLine` | `"auto"` | 自动适配换行符 |
+| `arrowParens` | `"avoid"` | 单参数箭头函数省略括号 |
+| `proseWrap` | `"never"` | Markdown 不自动换行 |
+
+## ESLint 核心规则
+
+### 通用基础
+
+- 项目根据自身技术栈在 `extends` 中配置合适的共享规则集
+- 项目可追加插件（如 `@intlify/vue-i18n`、`eslint-plugin-import` 等）
+
+### Vue 项目
+
+```js
+// .eslintrc.cjs
+module.exports = {
+  root: true,
+  // 项目按需配置 extends（如 eslint:recommended、plugin:vue/vue3-recommended 等）
+};
+```
+
+### React 项目
+
+```js
+// .eslintrc.js
+module.exports = {
+  root: true,
+  settings: {
+    'import/resolver': {
+      alias: [['@', './src']],
+    },
+  },
+  // 项目按需配置 extends（如 eslint:recommended、plugin:react/recommended 等）
+};
+```
+
+## Stylelint 核心规则
+
+- 继承 `stylelint-config-standard` 基础规则
+- Vue 项目追加 `stylelint-config-html/vue` 和 `stylelint-config-recommended-vue`
+- 使用 `postcss-html` 作为自定义语法解析器（解析 `.vue` 文件中的 `<style>`）
+- 忽略与业务组件库冲突的规则（如 `no-descending-specificity`）
+
+## 开发流程集成
+
+### IDE 保存时自动格式化（推荐）
+
+项目可在 `.vscode/settings.json` 中配置：
+
+```json
+{
+  "editor.formatOnSave": true,
+  "editor.defaultFormatter": "esbenp.prettier-vscode",
+  "editor.codeActionsOnSave": {
+    "source.fixAll.eslint": "explicit",
+    "source.fixAll.stylelint": "explicit"
+  }
+}
+```
+
+### 提交前自动检查（husky + lint-staged）
+
+使用 `husky` 注册 Git hooks，`lint-staged` 只检查暂存文件：
+
+| 工具 | 职责 | 配置文件 |
+|------|------|----------|
+| husky | 注册 Git hooks（pre-commit、commit-msg） | `.husky/` |
+| lint-staged | 对暂存文件执行 lint/format | `.lintstagedrc` |
+| commitlint | 校验 commit message 格式 | `commitlint.config.js` |
+
+**部署前提**：上述 `.husky/`、`.lintstagedrc`、`commitlint.config.js` 仅在执行 `install.sh` / `install.ps1` 时**选择安装提交校验**（`--husky` 或交互选 Y）后才会复制到目标项目并配合 `husky install` 注册 Git hooks。若选择跳过提交校验（`--no-husky` 或交互选 N），则不会下发这些文件；仅安装 lint/format 时只会得到 ESLint、Prettier、Stylelint 等配置。
+
+**lint-staged 检查范围**：
+
+```json
+{
+  "src/**/*.{vue,less,scss,css}": [
+    "stylelint --fix"
+  ],
+  "src/**/*.{js,ts,jsx,tsx,json,vue}": [
+    "eslint --fix"
+  ]
+}
+```
+
+### Commit Message 规范（Conventional Commits）
+
+统一使用 [Conventional Commits](https://www.conventionalcommits.org/) 格式，由 commitlint 强制校验：
+
+```
+<type>(<scope>): <subject>
+```
+
+| type | 说明 |
+|------|------|
+| `feat` | 新功能 |
+| `fix` | 修复 bug |
+| `docs` | 文档变更 |
+| `style` | 代码格式（不影响逻辑） |
+| `refactor` | 重构（非新功能、非修复） |
+| `test` | 测试相关 |
+| `chore` | 构建、工具、依赖等杂项 |
+
+**示例**：
+
+```
+feat(order): 新增工单批量导出功能
+fix(auth): 修复 token 过期后未跳转登录页的问题
+docs(api): 补充资产库接口类型定义
+```
+
+- `scope` 可选，建议填写业务模块名
+- `subject` 使用中文，简明扼要
+
+## 忽略文件约定
+
+各工具的 ignore 文件遵循统一基线，至少忽略以下目录：
+
+```
+node_modules
+dist
+lib
+assets
+public
+```
+
+项目可根据实际情况追加特有的忽略路径。

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

@@ -1,31 +1,31 @@
----
-alwaysApply: false
-description: Spring Boot 项目概述，描述项目定位、技术栈、模块结构与核心依赖。当了解项目背景或进行整体规划时读取此规则。
----
-
-# 项目概述（Spring Boot）
-
-> 本文件由 `project-init` 技能根据仓库实际情况生成，请勿手动覆盖自动生成的内容。
-
-## 项目定位
-
-<!-- 描述项目的业务定位与核心职责 -->
-
-## 技术栈
-
-| 层次 | 技术 |
-|------|------|
-| 框架 | Spring Boot |
-| 构建工具 | Maven / Gradle |
-| 数据访问 | MyBatis / JPA / Spring Data |
-| 数据库 | MySQL / PostgreSQL |
-| 缓存 | Redis（按需） |
-| 消息队列 | RabbitMQ / Kafka（按需） |
-
-## 模块结构
-
-<!-- 描述多模块结构（若适用） -->
-
-## 核心依赖
-
-<!-- 列出关键 starter 与第三方依赖 -->
+---
+alwaysApply: false
+description: Spring Boot 项目概述，描述项目定位、技术栈、模块结构与核心依赖。当了解项目背景或进行整体规划时读取此规则。
+---
+
+# 项目概述（Spring Boot）
+
+> 本文件由 `project-init` 技能根据仓库实际情况生成，请勿手动覆盖自动生成的内容。
+
+## 项目定位
+
+<!-- 描述项目的业务定位与核心职责 -->
+
+## 技术栈
+
+| 层次 | 技术 |
+|------|------|
+| 框架 | Spring Boot |
+| 构建工具 | Maven / Gradle |
+| 数据访问 | MyBatis / JPA / Spring Data |
+| 数据库 | MySQL / PostgreSQL |
+| 缓存 | Redis（按需） |
+| 消息队列 | RabbitMQ / Kafka（按需） |
+
+## 模块结构
+
+<!-- 描述多模块结构（若适用） -->
+
+## 核心依赖
+
+<!-- 列出关键 starter 与第三方依赖 -->

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

@@ -1,37 +1,37 @@
----
-alwaysApply: false
-description: Spring Boot 项目结构规范，包括多模块目录约定、包名规则、资源目录组织方式。当新建模块、包或文件时读取此规则。
----
-
-# 项目结构（Spring Boot）
-
-> 本文件由 `project-init` 技能根据仓库实际情况生成，请勿手动覆盖自动生成的内容。
-
-## 典型目录结构
-
-```text
-<root>/
-├── <module>-api/           # 对外接口定义（DTO、接口声明）
-├── <module>-service/       # 业务实现
-│   └── src/main/java/com/<org>/<module>/
-│       ├── controller/     # HTTP 控制器
-│       ├── service/        # 业务服务接口与实现
-│       ├── repository/     # 数据访问层
-│       ├── domain/         # 领域模型（Entity、VO）
-│       ├── dto/            # 数据传输对象
-│       ├── config/         # 配置类
-│       └── exception/      # 异常定义
-└── <module>-start/         # 启动模块（含 application.yml）
-```
-
-## 包命名规则
-
-- 顶层包：`com.<org>.<project>`
-- 按职责分层，禁止跨层直接调用（Controller → Service → Repository）
-- 禁止在 Controller 中直接操作 Repository
-
-## 资源目录
-
-- `src/main/resources/application.yml`：主配置
-- `src/main/resources/application-<env>.yml`：环境配置
-- `src/main/resources/mapper/`：MyBatis XML（如适用）
+---
+alwaysApply: false
+description: Spring Boot 项目结构规范，包括多模块目录约定、包名规则、资源目录组织方式。当新建模块、包或文件时读取此规则。
+---
+
+# 项目结构（Spring Boot）
+
+> 本文件由 `project-init` 技能根据仓库实际情况生成，请勿手动覆盖自动生成的内容。
+
+## 典型目录结构
+
+```text
+<root>/
+├── <module>-api/           # 对外接口定义（DTO、接口声明）
+├── <module>-service/       # 业务实现
+│   └── src/main/java/com/<org>/<module>/
+│       ├── controller/     # HTTP 控制器
+│       ├── service/        # 业务服务接口与实现
+│       ├── repository/     # 数据访问层
+│       ├── domain/         # 领域模型（Entity、VO）
+│       ├── dto/            # 数据传输对象
+│       ├── config/         # 配置类
+│       └── exception/      # 异常定义
+└── <module>-start/         # 启动模块（含 application.yml）
+```
+
+## 包命名规则
+
+- 顶层包：`com.<org>.<project>`
+- 按职责分层，禁止跨层直接调用（Controller → Service → Repository）
+- 禁止在 Controller 中直接操作 Repository
+
+## 资源目录
+
+- `src/main/resources/application.yml`：主配置
+- `src/main/resources/application-<env>.yml`：环境配置
+- `src/main/resources/mapper/`：MyBatis XML（如适用）