Menu
Triflow 代码审查规范。对当前代码变更或指定文件/模块进行全面合规性检查，覆盖后端 Java、Web 前端、App 移动端的命名、架构、类型安全、数据库、API 等规范。使用此 skill 审查代码是否符合项目约定。
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
| name | code-review |
| description | Triflow 代码审查规范。对当前代码变更或指定文件/模块进行全面合规性检查，覆盖后端 Java、Web 前端、App 移动端的命名、架构、类型安全、数据库、API 等规范。使用此 skill 审查代码是否符合项目约定。 |
使用此 Skill 对代码进行合规性审查。按以下清单逐项检查，报告不符合项并给出修复建议。
git diff 变更kebab-case（Vue 组件、TS 文件）或 PascalCase（Java 类）camelCase，常量使用 UPPER_SNAKE_CASEPascalCase（如 UserVO、UserQueryDTO）console.log 遗留（生产代码）feat: / fix: / refactor: 等）.env、.idea/、node_modules/）提交BaseApiApiResultQueryWrapper（查询逻辑下放到 Mapper）default 方法 + Lambda 表达式）User::getUsername），无 xxxTableDef 静态字段eq(field, value, condition)）PageQuery，使用 buildPage() + paginateAs@Table 使用模块前缀（如 sys_user），无 t_ 前缀@author 和 @since 标签@see 指向枚举类，枚举实现 BaseEnum 接口@Schema 注解（description 必填，推荐 example）@AutoMapper(target = Entity.class) 定义转换MapStructUtils.convert()，无 BeanUtils / Hutool / 手写 ConvertStrictTypeMapping）Assert 断言工具，无 if (x == null) throw new ... 模式BusinessException / AlertsException / ClientException@RequiredArgsConstructor + private final 构造器注入，无 @Autowiredcn.hutool.*），使用 Apache Commons@Tag、@Operation、@Schema@OperationLog 注解标注操作日志模块sys_、cms_、ord_ 等），无 t_ 前缀tenant_id、dept_id、create_by、create_time、update_by、update_time、deletedis_ 前缀snake_case，主键为 id（BIGINT AUTO_INCREMENT）uk_xxx，普通索引 idx_xxxutf8mb4，排序规则 utf8mb4_unicode_ci@SaCheckPermission 或 @SaCheckRoleLoginUtils.getLoginUser()/public/ 标识<script setup lang="ts">withDefaults 定义kebab-case.vueany 类型（包括 catch(error) 也需正确类型化）import type { ... }api/modules/ 下，类型与函数在同一文件#/ 别名（= web-admin/src/）@vben/xxx 导入../../..）defineStore + 箭头函数）storeToRefs()，无直接解构$reset 方法.block__element--modifier）t() 函数useXxx 命名，定义 Options 和 Return 接口#/components/ 和 CHARTER.md）/base/ 模块前缀VITE_SERVER_BASEURL（无 /base 后缀）<script setup lang="ts">wd-xxx）组件<wd-toast /> 组件kebab-case.vuev-if 而非 v-show#ifdef / #endif 条件编译backdrop-filter、gap、aspect-ratio、@font-facerpx（自适应），边框/小图标用 pxenv(safe-area-inset-bottom)persist 配置uni.getStorageSync / uni.setStorageSyncstoreToRefs()z-paging 组件SwitchKey 枚举 + getSwitchStatus()，无硬编码开关键@error 处理和 lazy-loadwx.login() + code 换 token，无废弃的 getUserInfo open-typecustom-class 而非 class（外部样式传递）scroll-view 有明确高度设置<button> 已重置默认样式# 代码审查报告
**审查范围**: [文件/目录/PR]
**审查时间**: [日期]
## 概要
| 严重度 | 数量 |
|--------|------|
| Error | X |
| Warning| X |
| Info | X |
## Error（必须修复）
### E1: [问题标题]
- **文件**: `path/to/file.java:42`
- **规则**: [违反的规则编号，如 2.2]
- **问题**: [具体描述]
- **修复**: [建议的修复方式]
## Warning（建议修复）
### W1: [问题标题]
...
## Info（改进建议）
### I1: [问题标题]
...
## 通过项
- [x] 分层架构正确
- [x] 命名规范符合
- ...
# 后端
cd triflow-server
mvn compile # 编译检查（含 MapStruct 类型校验）
mvn checkstyle:check # 代码风格检查（如已配置）
# Web 前端
cd triflow-web
pnpm lint # ESLint + Prettier
pnpm type-check # TypeScript 类型检查
# App 移动端
cd triflow-app
pnpm lint # ESLint
pnpm type-check # TypeScript 类型检查
Triflow App 移动端开发规范。包括 UniApp + Wot Design Uni + Alova 请求、API 路径前缀、z-paging 分页、UnoCSS 样式、跨端兼容性等项目约定。在编写或修改 triflow-app 代码时必须遵循。
Triflow 后端 Java 开发规范。包括 MyBatis-Flex 查询、实体与 DTO/VO 定义、分层架构、数据库命名、异常处理、数据转换等项目约定。在编写或修改 triflow-server 代码时必须遵循。
Triflow Web 前端开发规范。包括 Vue 3.5 + Element Plus + TypeScript 组件编写、API 类型定义、Pinia 状态管理、VXE Table、样式规范等项目约定。在编写或修改 triflow-web 代码时必须遵循。