v3-admin-vite / rules

---
alwaysApply: true
---

# 项目开发规范

## 导入

- 使用路径别名 `@` 指向 `src` 目录
- 使用路径别名 `@@` 指向 `src/common` 目录

## 编码

- 编写整洁不冗余、可读性强的代码，始终提取共用逻辑
- 针对关键步骤和方法编写对开发者友好的注释
- 代码必须能够立即运行，包含所有必要的导入和依赖
- 尽量避免使用兼容性不好的 JS、CSS 语法，使用时必须提供相应的注释
- 优先参考项目已有代码的编码风格
- 优先使用项目内置的组件和工具，其次是已引入的第三方依赖，避免重新发明轮子
- 避免硬编码与魔法字符串的出现

## 代码检查

- 使用 ESLint 进行代码校验与格式化
- 禁用 Prettier 进行代码格式化

## 本地环境

- 使用 node 版本 20.19+ 或 22.12+ 或最新稳定版
- 包管理工具使用 pnpm 10+ 或最新稳定版

More agent context in un-pany/v3-admin-vite

11 other files this repository gives its agents.