@gong-ym/ai-spec-auto 0.2.3

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

@@ -0,0 +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 必须附带测试用例。
+- 测试必须能独立运行，不依赖特定环境或执行顺序。

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

@@ -0,0 +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
+```
+
+项目可根据实际情况追加特有的忽略路径。

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

@@ -0,0 +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 与第三方依赖 -->

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

@@ -0,0 +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（如适用）

package/.agents/rules/profiles/springboot/04-/345/210/206/345/261/202/350/247/204/350/214/203.md

@@ -0,0 +1,33 @@
+---
+alwaysApply: false
+description: Spring Boot 项目的分层规范，包括 Controller / Service / Repository 职责边界、禁止跨层直接调用的约束。当新增或修改业务代码时读取此规则。
+---
+
+# 分层规范（Spring Boot）
+
+## 分层职责
+
+| 层次 | 职责 | 禁止事项 |
+|------|------|----------|
+| Controller | 接收 HTTP 请求、参数校验、调用 Service、返回响应 | 禁止包含业务逻辑、禁止直接调用 Repository |
+| Service | 业务逻辑编排、事务管理、跨模块调用 | 禁止直接处理 HTTP 请求 / 响应对象 |
+| Repository | 数据访问、SQL / ORM 操作 | 禁止包含业务逻辑 |
+| Domain / Entity | 领域模型定义 | 禁止依赖 Service 或 Repository |
+| DTO | 数据传输对象，用于跨层传递 | 禁止包含业务逻辑 |
+
+## 调用规则（NON-NEGOTIABLE）
+
+- Controller 只调用 Service，不直接调用 Repository
+- Service 调用 Repository 或其它 Service（同层可调用）
+- Repository 只负责数据操作，不引用 Service
+
+## 事务管理
+
+- 事务注解 `@Transactional` 加在 Service 层
+- 只读操作使用 `@Transactional(readOnly = true)` 提升性能
+- 跨 Service 的复杂事务需明确传播行为（`REQUIRED` / `REQUIRES_NEW`）
+
+## 接口与实现分离
+
+- Service 层优先定义接口（`XxxService`），由 `XxxServiceImpl` 实现
+- 单实现场景下可酌情省略接口，但需团队统一约定

package/.agents/rules/profiles/springboot/05-/346/216/245/345/217/243/344/270/216/345/245/221/347/272/246/350/247/204/350/214/203.md

@@ -0,0 +1,51 @@
+---
+alwaysApply: false
+description: Spring Boot 项目的接口与契约规范，包括 RESTful 接口设计、统一响应体、版本控制与参数校验约定。当新增或修改 HTTP 接口时读取此规则。
+---
+
+# 接口与契约规范（Spring Boot）
+
+## RESTful 设计原则
+
+| 操作 | HTTP 方法 | URI 示例 |
+|------|-----------|----------|
+| 查询列表 | GET | `/api/v1/orders` |
+| 查询详情 | GET | `/api/v1/orders/{id}` |
+| 创建 | POST | `/api/v1/orders` |
+| 更新（全量） | PUT | `/api/v1/orders/{id}` |
+| 更新（部分） | PATCH | `/api/v1/orders/{id}` |
+| 删除 | DELETE | `/api/v1/orders/{id}` |
+
+## 统一响应体（NON-NEGOTIABLE）
+
+所有接口必须返回统一的响应结构：
+
+```java
+public class Result<T> {
+    private int code;       // 状态码，成功为 0 或 200
+    private String message; // 描述信息
+    private T data;         // 业务数据
+}
+```
+
+- 不允许直接返回裸数据，必须包装成统一响应体
+- 异常响应同样遵循此格式
+
+## API 版本控制
+
+- URI 路径版本：`/api/v1/`、`/api/v2/`
+- 新版本接口不应破坏已有版本的兼容性
+
+## 参数校验
+
+- 使用 JSR-303/380（`@Valid`、`@Validated`）进行请求参数校验
+- Controller 层统一触发校验，不在 Service 层重复校验入参格式
+- 自定义校验注解放在 `common` 模块的 `validation` 包
+
+## DTO 命名约定
+
+| 场景 | 命名 | 示例 |
+|------|------|------|
+| 请求参数 | `XxxRequest` / `XxxReqDTO` | `CreateOrderRequest` |
+| 响应数据 | `XxxResponse` / `XxxRespDTO` | `OrderDetailResponse` |
+| 查询条件 | `XxxQuery` | `OrderListQuery` |

package/.agents/rules/profiles/springboot/06-/346/225/260/346/215/256/350/256/277/351/227/256/350/247/204/350/214/203.md

@@ -0,0 +1,34 @@
+---
+alwaysApply: false
+description: Spring Boot 项目的数据访问规范，包括 ORM 框架选型约定、Repository 命名、SQL 管理与事务边界。当编写数据访问层代码时读取此规则。
+---
+
+# 数据访问规范（Spring Boot）
+
+## ORM 框架约定
+
+- 项目统一使用团队约定的 ORM 框架（MyBatis / JPA / Spring Data），禁止混用
+- MyBatis 项目：SQL 写在 XML 中（`src/main/resources/mapper/`），禁止直接在注解里写复杂 SQL
+- JPA 项目：简单查询使用 Repository 方法命名，复杂查询使用 `@Query` 或 Specification
+
+## Repository 命名
+
+- 接口命名：`XxxMapper`（MyBatis）或 `XxxRepository`（JPA）
+- 每个实体对应一个 Mapper / Repository，禁止跨实体混合操作
+
+## 分页查询
+
+- 统一使用框架提供的分页机制（MyBatis-Plus `Page`、Spring Data `Pageable`）
+- 禁止手写 `LIMIT offset, size` 做内存分页
+
+## SQL 安全
+
+- 禁止字符串拼接构造 SQL（防 SQL 注入）
+- 动态 SQL 使用框架提供的条件拼接（`<if>`、`Criteria`）
+- 批量操作使用框架批量接口，禁止循环单条操作
+
+## 实体设计
+
+- 主键统一通过框架生成策略管理（雪花 ID、自增、UUID 按项目选一）
+- 审计字段（创建时间、更新时间、创建人、更新人）统一由基类或 `@EntityListeners` 自动填充
+- 逻辑删除字段统一命名（如 `is_deleted`），不做物理删除

package/.agents/rules/profiles/springboot/07-/351/205/215/347/275/256/344/270/216/350/277/220/350/241/214/346/227/266/350/247/204/350/214/203.md

@@ -0,0 +1,38 @@
+---
+alwaysApply: false
+description: Spring Boot 项目的配置与运行时规范，包括配置文件分层、环境隔离、敏感配置管理与 Bean 生命周期约定。当新增或修改配置时读取此规则。
+---
+
+# 配置与运行时规范（Spring Boot）
+
+## 配置文件分层
+
+```text
+src/main/resources/
+├── application.yml          # 公共配置（不含敏感信息）
+├── application-dev.yml      # 开发环境
+├── application-test.yml     # 测试环境
+├── application-prod.yml     # 生产环境
+└── bootstrap.yml            # 配置中心加载（如使用）
+```
+
+- 通过 `spring.profiles.active` 激活环境配置
+- 公共配置放 `application.yml`，环境差异放对应的 profile 文件
+
+## 敏感配置管理（NON-NEGOTIABLE）
+
+- 数据库密码、中间件密码、第三方 API 密钥禁止写入 Git
+- 生产敏感配置通过配置中心（Nacos / Apollo）或环境变量注入
+- 本地开发可使用 `.env` 文件（已加入 `.gitignore`）存储敏感值
+
+## 配置类约定
+
+- 自定义配置使用 `@ConfigurationProperties` 而非多处 `@Value`
+- 配置类放在 `config/` 包，命名为 `XxxProperties` 或 `XxxConfig`
+- 配置校验：在 `@ConfigurationProperties` 类上使用 `@Validated` 及 JSR-303 注解
+
+## Bean 生命周期
+
+- 使用构造函数注入（而非字段注入），便于测试与不变性保证
+- 避免循环依赖；若存在，优先通过重构消除，而非使用 `@Lazy`
+- `ApplicationRunner` / `CommandLineRunner` 仅用于应用启动后的一次性初始化

package/.agents/rules/profiles/springboot/09-/345/274/202/345/270/270/344/270/216/346/227/245/345/277/227/350/247/204/350/214/203.md

@@ -0,0 +1,48 @@
+---
+alwaysApply: false
+description: Spring Boot 项目的异常与日志规范，包括全局异常处理、自定义异常体系、日志级别与结构化日志约定。当编写异常处理或日志相关代码时读取此规则。
+---
+
+# 异常与日志规范（Spring Boot）
+
+## 异常体系
+
+- 定义统一的业务异常基类（如 `BusinessException`）
+- 不同业务模块可扩展自己的子类（如 `OrderNotFoundException`）
+- 禁止直接抛出 `RuntimeException` 或 `Exception`，必须使用有语义的异常类型
+
+## 全局异常处理（NON-NEGOTIABLE）
+
+- 使用 `@RestControllerAdvice` + `@ExceptionHandler` 统一捕获异常
+- 全局处理器返回统一响应体（参考接口契约规范）
+- 以下异常必须全局处理：
+  - `BusinessException` 及其子类
+  - `MethodArgumentNotValidException`（参数校验失败）
+  - `HttpMessageNotReadableException`（请求体解析失败）
+  - 兜底 `Exception`（避免泄露堆栈信息到响应中）
+
+## 日志规范
+
+- 使用 `SLF4J` + `Logback` 或 `Log4j2`，禁止直接使用 `System.out.println`
+- 通过 `@Slf4j`（Lombok）或手动 `LoggerFactory.getLogger` 获取 Logger
+- 生产环境禁止 DEBUG 日志；开发/测试环境可开启
+
+### 日志级别使用场景
+
+| 级别 | 适用场景 |
+|------|----------|
+| ERROR | 系统异常、不可预期错误、需立即处理的问题 |
+| WARN | 可恢复的业务异常、配置缺失但有兜底 |
+| INFO | 关键业务操作节点（订单创建、支付完成等） |
+| DEBUG | 开发调试信息，生产禁止输出 |
+
+### 结构化日志
+
+- 关键操作日志包含：操作类型、业务 ID、操作人、耗时
+- 推荐使用 MDC 注入 traceId / requestId，便于链路追踪
+
+## 禁止事项
+
+- 禁止在 catch 块中吞掉异常（即 catch 后不记录、不抛出）
+- 禁止将异常堆栈直接返回给客户端
+- 禁止在循环内大量打印日志（性能风险）

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

@@ -0,0 +1,43 @@
+---
+alwaysApply: false
+description: Spring Boot 项目的测试规范，包括测试框架（JUnit 5 + Mockito + Spring Boot Test）、测试分层策略、测试文件约定与质量门禁。当编写测试或评审测试代码时读取此规则。
+---
+
+# 测试规范（Spring Boot）
+
+## 测试框架
+
+- 统一使用 **JUnit 5**（`@ExtendWith(SpringExtension.class)` 或 `@SpringBootTest`）
+- Mock 框架：**Mockito**（`@MockBean`、`@Mock`、`@InjectMocks`）
+- 断言库：**AssertJ**（推荐）或 JUnit 5 原生 `Assertions`
+
+## 测试分层策略
+
+| 层次 | 注解 | 范围 | 说明 |
+|------|------|------|------|
+| 单元测试 | 无 Spring 上下文 | Service / 工具类 | 使用 Mockito 模拟依赖，运行最快 |
+| 切片测试 | `@WebMvcTest`、`@DataJpaTest` | Controller / Repository | 只加载对应层的 Spring 上下文 |
+| 集成测试 | `@SpringBootTest` | 全链路 | 加载完整上下文，速度慢，按需使用 |
+
+## 测试文件约定
+
+| 项目 | 约定 |
+|------|------|
+| 文件位置 | `src/test/java/<same-package-as-source>/` |
+| 文件命名 | `XxxTest.java`（单元测试）、`XxxIT.java`（集成测试） |
+| 测试配置 | `src/test/resources/application-test.yml` |
+
+## 编写规范
+
+- 测试方法命名使用中文或英文描述，表达预期行为而非实现步骤
+- 遵循 **Arrange-Act-Assert** 模式
+- 每个测试方法只验证一个行为点
+- 测试应互相独立，不依赖执行顺序
+- 使用 `@TestPropertySource` 或测试配置文件覆盖生产配置
+
+## 质量门禁（NON-NEGOTIABLE）
+
+- 所有 Service 层核心业务逻辑必须有单元测试覆盖
+- `@SpringBootTest` 集成测试按需使用，不要求全覆盖
+- 测试必须能独立运行，不依赖外部真实服务（使用 Mock 或嵌入式数据库）
+- 新增工具类必须附带测试用例

package/.agents/rules/profiles/springboot/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

@@ -0,0 +1,48 @@
+---
+alwaysApply: false
+description: Spring Boot 项目的代码格式化与静态检查规范，包括 Checkstyle、SpotBugs、Google Java Format 等工具链职责与配置约定。当配置或调整代码检查工具时读取此规则。
+---
+
+# 代码格式化与检查（Spring Boot）
+
+## 工具链
+
+| 工具 | 职责 | 配置文件 |
+|------|------|----------|
+| **Google Java Format** / **Spotless** | Java 代码格式化（缩进、括号等） | `pom.xml` / `build.gradle` 中的插件配置 |
+| **Checkstyle** | 代码风格检查（命名、注释等） | `checkstyle.xml` |
+| **SpotBugs** | 静态分析（潜在 bug 检测） | `spotbugs-exclude.xml` |
+
+## 格式化规则
+
+- 统一使用项目约定的 Java 格式化风格（Google Style 或 Alibaba Java Style）
+- 缩进：4 个空格，禁止使用 Tab
+- 单行最大宽度：120 字符
+- 所有 `import` 按字母顺序排列，禁止 wildcard import（`import java.util.*`）
+
+## Checkstyle 核心规则
+
+- 类、方法、字段命名遵循 Java 命名约定
+- 公共类和公共方法必须有 Javadoc 注释
+- 禁止空 catch 块（必须有注释说明忽略原因）
+
+## Maven / Gradle 集成
+
+```xml
+<!-- Maven 示例：Spotless 格式化插件 -->
+<plugin>
+  <groupId>com.diffplug.spotless</groupId>
+  <artifactId>spotless-maven-plugin</artifactId>
+  <configuration>
+    <java>
+      <googleJavaFormat/>
+    </java>
+  </configuration>
+</plugin>
+```
+
+## 开发流程集成
+
+- 提交前通过 Maven/Gradle 的 `verify` 阶段执行 Checkstyle 和 SpotBugs
+- IDE 推荐安装 Checkstyle 插件，实时提示规范问题
+- CI 流水线必须包含 `checkstyle:check` 步骤，失败则阻断合并

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

@@ -0,0 +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