ai-engineering-init 1.7.0 → 1.8.0

package/.claude/hooks/skill-forced-eval.js

@@ -3,9 +3,8 @@
  * UserPromptSubmit Hook - 强制技能评估 (跨平台版本)
  * 功能: 开发场景下，将 Skills 激活率从约 25% 提升到 90% 以上
  *
- * 适配项目: leniu (纯后端项目)
+ * 适配: 通用后端项目
  * 架构: 三层架构 (Controller → Service → Mapper)
- * 包名: org.dromara.*
  */
 
 const fs = require('fs');
@@ -62,21 +61,18 @@ const instructions = `## 强制技能激活流程（必须执行）
 
 针对用户问题，列出匹配的技能：\`技能名: 理由\`，无匹配则写"无匹配技能"
 
-可用技能（纯后端项目）：
+可用技能（后端项目）：
 - crud-development: CRUD/业务模块/Entity/Service/Controller 开发
 - api-development: API设计/RESTful/接口规范
 - database-ops: 数据库/SQL/建表/字典/菜单
-- backend-annotations: 注解/@RateLimiter/@DataScope
-- utils-toolkit: 工具类/StringUtils/MapstructUtils
-- file-oss-management: 文件上传/OSS/云存储/MinIO
-- ai-langchain4j: AI/大模型/ChatGPT/DeepSeek
-- media-processing: 图片处理/二维码/水印/Excel
+- backend-annotations: 注解/限流/防重复/脱敏/加密
+- utils-toolkit: 工具类/对象转换/字符串/集合/日期
+- file-oss-management: 文件上传/OSS/云存储
 - bug-detective: Bug/报错/异常/不工作
-- mysql-debug: 查数据库/查表/执行SQL/查记录/mysql查询/数据库排查/验证数据/数据库调试/db查询
-- error-handler: 异常处理/ServiceException
+- error-handler: 异常处理/全局异常/业务异常
 - performance-doctor: 性能/慢查询/优化/缓存
-- data-permission: 数据权限/@DataPermission/DataScope/行级权限
-- security-guard: 安全/Sa-Token/认证授权/加密
+- data-permission: 数据权限/行级权限/数据隔离
+- security-guard: 安全/认证授权/加密/XSS/SQL注入防护
 - architecture-design: 架构/模块划分/重构
 - code-patterns: 规范/禁止/命名/Git提交
 - project-navigator: 项目结构/文件在哪/定位
@@ -86,57 +82,45 @@ const instructions = `## 强制技能激活流程（必须执行）
 - brainstorm: 头脑风暴/创意/方案设计
 - collaborating-with-codex: Codex协作/多模型/算法分析
 - collaborating-with-gemini: Gemini协作/前端原型/UI设计
-- codex-code-review: 代码审查/review/代码检查/code review/审查代码/检查代码/代码质量
-- workflow-engine: 工作流/审批流/Flowable/流程
+- codex-code-review: 代码审查/review/代码检查/code review
+- workflow-engine: 工作流/审批流/流程引擎
 - test-development: 测试/单元测试/@Test/JUnit5/Mockito
-- json-serialization: JSON/序列化/反序列化/JsonUtils/日期格式/BigDecimal/精度/类型转换
-- redis-cache: Redis/缓存/@Cacheable/@CacheEvict/RedisUtils/分布式锁/RLock/限流
-- scheduled-jobs: 定时任务/SnailJob/@Scheduled/@JobExecutor/任务调度/重试机制
-- add-skill: 添加技能/创建技能/新技能/技能开发/写技能
-- banana-image: 生成图片/AI图片/产品图/海报/缩略图/4K/高清/制作图片
-- websocket-sse: WebSocket/SSE/实时推送/消息通知/在线状态/双向通信/实时通信
-- sms-mail: 短信/邮件/SMS/验证码/通知/SMS4j/MailUtils/邮件发送/短信发送
-- social-login: 第三方登录/微信登录/QQ登录/OAuth/OAuth2/JustAuth/社交登录/扫码登录/授权登录
-- tenant-management: 多租户/租户隔离/TenantEntity/TenantHelper/租户ID/tenantId/跨租户/动态租户/SaaS
-- leniu-java-amount-handling: 金额处理/分转元/元转分/Long金额/money/fen/BigDecimal金额/金额字段
-- leniu-java-concurrent: 并发/CompletableFuture/线程池/ThreadPool/并发安全/异步处理/synchronized
-- leniu-java-entity: Entity实体类/VO视图对象/DTO数据传输/Param参数类/@TableName/@TableField/审计字段/字段映射
-- leniu-java-export: 导出/Excel导出/异步导出/分页导出/@ExcelProperty/exportApi/数据导出
-- leniu-java-logging: 日志/@Slf4j/log.info/log.error/log.debug/日志级别/logback/日志格式
-- leniu-java-mq: 消息队列/MQ/MqUtil/@MqConsumer/延迟消息/消息重试/事务消息
-- leniu-java-mybatis: MyBatis/MyBatisPlus/Mapper/LambdaQueryWrapper/XML映射/动态SQL/BaseMapper/@Select/resultMap
-- leniu-java-report-query-param: 报表查询入参/Param类/分页参数/时间范围查询/ReportBaseParam/exportCols
-- leniu-java-task: 定时任务/XXL-Job/@XxlJob/TenantLoader/任务调度/分布式定时
-- leniu-java-total-line: 合计行/totalLine/报表合计/SUM合计/ReportBaseTotalVO/合计查询
-- leniu-report-customization: 定制报表/汇总报表/report_order_info/report_order_detail/report_account_flow/退款汇总/消费金额统计/订单报表/流水报表
-- leniu-report-standard-customization: 标准版报表/core-report/report_refund/report_refund_detail/经营分析/营业额分析/用户活跃度/菜品排行/操作员统计/账户日结/钱包消费汇总/商户消费汇总/ReportOrderConsumeService/ReportAccountConsumeService
-- leniu-customization-location: 定制开发/定制代码位置/Dz前缀/leniu-yunshitang/dz_表名/定制仓库/覆盖Service/@Primary/迁移core文件/定制开始/定制结束/net.xnzn.yunshitang/wuhanxiehe定制/bootstrap-ext
-- leniu-crud-development: CRUD/增删改查/新建模块/Business层/Service/Mapper/Controller/分页查询/LeRequest/PageDTO/PageVO/事务管理
-- leniu-database-ops: 数据库/SQL/建表/双库/商户库/系统库/审计字段/crby/crtime/del_flag
-- leniu-utils-toolkit: 工具类/BeanUtil/StrUtil/CollUtil/ObjectUtil/RedisUtil/JacksonUtil/LeBeanUtil
-- leniu-error-handler: 异常处理/LeException/全局异常/参数校验/错误码/I18n/国际化/throw
-- leniu-backend-annotations: @RequiresAuthentication/@RequiresGuest/@Validated/@NotNull/@Api/@ApiOperation/@ApiModelProperty/分组校验/InsertGroup/UpdateGroup
-- leniu-api-development: API接口/Controller/RESTful/LeResult/LeResponse/LeRequest/接口开发/路由前缀
-- leniu-brainstorm: 头脑风暴/方案设计/怎么设计/创意探索/功能规划/可行性分析
-- leniu-architecture-design: 架构设计/双库架构/商户库/系统库/pigx框架/四层架构/模块划分/Business层
-- leniu-code-patterns: 代码禁令/代码规范/命名规范/代码风格/Git提交规范/包结构/禁止写法/审计字段规范/delFlag/crby
-- leniu-data-permission: 多租户/数据权限/@UseSystem/Executors.doInTenant/readInSystem/TenantContextHolder/MERCHANT-ID/双库隔离/数据源切换
-- leniu-redis-cache: Redis/缓存/RedisUtil/分布式锁/RLock/getLock/setNx/ZSet/限流/缓存击穿
-- leniu-security-guard: 安全认证/SQL注入防护/XSS防护/数据脱敏/SM4加密/接口安全/限流
-- loki-log-query: 查日志/traceId/链路追踪/Loki/日志查询/线上日志/生产日志/错误日志/异常堆栈/日志排查
-- leniu-mealtime: 餐次/mealtime/mealtimeType/早餐/午餐/晚餐/下午茶/夜宵/AllocMealtimeTypeEnum
-- leniu-marketing-price-rule-customizer: 营销计费/计价规则/RulePriceHandler/RulePriceEnum/折扣规则/满减规则/限额规则/补贴规则
-- leniu-marketing-recharge-rule-customizer: 营销充值/充值规则/RuleRechargeHandler/RuleRechargeEnum/满赠规则/充值赠送/管理费规则
-- openspec-new-change: 新建变更/开始新功能/opsx:new/openspec new/创建变更
-- openspec-ff-change: 快速推进/快速生成所有制品/opsx:ff/openspec ff/fast-forward
-- openspec-apply-change: 实现任务/开始实现/opsx:apply/openspec apply/执行变更
-- openspec-continue-change: 继续变更/创建下一个制品/opsx:continue/openspec continue
-- openspec-archive-change: 归档变更/完成变更/opsx:archive/openspec archive/归档
-- openspec-bulk-archive-change: 批量归档/批量完成/opsx:bulk-archive/批量变更
-- openspec-explore: 探索模式/思维伙伴/opsx:explore/openspec explore/探索问题
-- openspec-onboard: 新手引导/学习工作流/opsx:onboard/openspec onboard/入门教程
-- openspec-sync-specs: 同步规格/同步spec/opsx:sync/openspec sync/delta同步
-- openspec-verify-change: 验证变更/检查实现/opsx:verify/openspec verify/验证规格
+- json-serialization: JSON/序列化/反序列化/日期格式/BigDecimal/精度
+- redis-cache: Redis/缓存/@Cacheable/分布式锁/限流
+- scheduled-jobs: 定时任务/@Scheduled/Quartz/XXL-Job/任务调度
+- add-skill: 添加技能/创建技能/新技能/技能开发
+- banana-image: 生成图片/AI图片/产品图/海报/缩略图
+- websocket-sse: WebSocket/SSE/实时推送/消息通知/双向通信
+- sms-mail: 短信/邮件/SMS/验证码/通知
+- social-login: 第三方登录/OAuth/OAuth2/社交登录/授权登录
+- tenant-management: 多租户/租户隔离/SaaS/数据隔离
+- openspec-new-change: 新建变更/开始新功能/opsx:new/openspec new
+- openspec-ff-change: 快速推进/opsx:ff/openspec ff/fast-forward
+- openspec-apply-change: 实现任务/opsx:apply/openspec apply
+- openspec-continue-change: 继续变更/opsx:continue/openspec continue
+- openspec-archive-change: 归档变更/opsx:archive/openspec archive
+- openspec-bulk-archive-change: 批量归档/opsx:bulk-archive
+- openspec-explore: 探索模式/opsx:explore/openspec explore
+- openspec-onboard: 新手引导/opsx:onboard/openspec onboard
+- openspec-sync-specs: 同步规格/opsx:sync/openspec sync
+- openspec-verify-change: 验证变更/opsx:verify/openspec verify
+- ui-pc: 前端组件/Element UI/页面开发
+- store-pc: Vuex/状态管理/store模块
+- mysql-debug: MySQL调试/查数据库/执行SQL/数据库排查
+- loki-log-query: Loki日志/日志查询/线上日志排查
+- yunxiao-task-management: 云效任务/任务管理/需求管理
+- crud: 快速CRUD生成/脚手架
+- dev: 开发新功能/功能开发流程
+- check: 代码检查/规范检查
+- start: 项目启动/初始化/开始
+- next: 下一步/继续/接下来做什么
+- progress: 进度查看/当前状态
+- sync: 同步/代码同步
+- sync-back-merge: 回合并/sync back merge/主分支同步
+- init-docs: 初始化文档/项目文档生成
+- add-todo: 添加待办/TODO/任务添加
+- update-status: 更新状态/状态变更
+- skill-creator: 创建技能模板/技能脚手架/skill scaffold
 
 ### 步骤 2 - 激活（逐个调用，等待每个完成）
 

package/.claude/settings.json

@@ -37,5 +37,14 @@
       }
     ]
   },
-  "mcpServers": {}
+  "mcpServers": {
+    "sequential-thinking": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
+    },
+    "context7": {
+      "command": "npx",
+      "args": ["-y", "@upstash/context7-mcp"]
+    }
+  }
 }

package/.claude/skills/api-development/SKILL.md

@@ -1,20 +1,19 @@
 ---
 name: api-development
 description: |
-  后端 API 接口设计规范。基于三层架构的 RESTful API 开发指南。
+  后端 API 接口设计规范。基于 Spring Boot 的 RESTful API 开发指南。
 
   触发场景：
   - 设计 RESTful API 接口
   - 编写 Controller 层代码
-  - 配置接口权限、日志、防重复提交注解
+  - 配置接口权限、日志注解
   - 接口返回值类型选择
   - 数据验证和参数校验
 
   触发词：API、接口、RESTful、Controller、GetMapping、PostMapping、权限注解、日志注解、分页查询、接口规范
 
   注意：
-  - 本项目是三层架构：Controller -> Service -> Mapper
-  - 参考 java-controller 技能获取更详细的 Controller 层规范
+  - 参考项目实际架构层次选择合适的分层模式
 ---
 
 # API 接口设计规范
@@ -23,22 +22,22 @@ description: |
 
 | 原则 | 说明 |
 |------|------|
-| 统一入口 | 所有接口使用 POST 或 RESTful 风格 |
+| RESTful 风格 | 使用标准 HTTP 方法表达语义 |
 | 认证保护 | 所有业务接口必须添加认证注解 |
 | 参数校验 | 使用分组校验区分新增/修改场景 |
 | 统一响应 | 使用统一的响应格式包装返回数据 |
 
 ### HTTP 方法规范
 
-| 操作 | 方法 | 路径 |
-|------|------|------|
-| 列表查询 | POST/GET | `/query` 或 `/list` |
-| 获取详情 | POST/GET | `/{id}` 或 `/detail` |
-| 新增 | POST | `/add` |
-| 修改 | POST/PUT | `/update` |
-| 删除 | POST/DELETE | `/delete` 或 `/batch/delete` |
+| 操作 | 方法 | 路径示例 |
+|------|------|---------|
+| 列表查询 | GET | `/list` 或 `/page` |
+| 获取详情 | GET | `/{id}` |
+| 新增 | POST | `/` 或 `/add` |
+| 修改 | PUT | `/` 或 `/update` |
+| 删除 | DELETE | `/{ids}` |
 | 导出 | POST | `/export` |
-| 导入 | POST | `/import-excel` |
+| 导入 | POST | `/import` |
 
 ---
 
@@ -47,65 +46,106 @@ description: |
 ```java
 @Slf4j
 @RestController
-@RequiresAuthentication
-@RequestMapping("/module/feature")
-@Api(value = "模块/功能", tags = "模块/功能")
+@RequiredArgsConstructor
+@RequestMapping("/api/v1/[模块]/[功能]")
 public class XxxController {
 
-    @Resource @Lazy
-    private XxxService xxxService;
+    private final XxxService xxxService;
 
-    @PostMapping("/add")
-    @ApiOperation(value = "功能描述-新增")
-    public Long add(@Validated(InsertGroup.class) @RequestBody LeRequest<XxxDTO> request) {
-        return xxxService.add(request.getContent());
+    /**
+     * 分页查询
+     */
+    @GetMapping("/page")
+    public Result<PageResult<XxxVO>> page(XxxQueryDTO query) {
+        return Result.ok(xxxService.pageList(query));
     }
 
-    @PostMapping("/update")
-    @ApiOperation(value = "功能描述-修改")
-    public void update(@Validated(UpdateGroup.class) @RequestBody LeRequest<XxxDTO> request) {
-        xxxService.update(request.getContent());
+    /**
+     * 获取详情
+     */
+    @GetMapping("/{id}")
+    public Result<XxxVO> getById(@PathVariable Long id) {
+        return Result.ok(xxxService.getById(id));
     }
 
-    @PostMapping("/query")
-    @ApiOperation(value = "功能描述-分页查询")
-    public Page<XxxVO> query(@Validated @RequestBody LeRequest<XxxQueryParam> request) {
-        return xxxService.pageList(request.getContent());
+    /**
+     * 新增
+     */
+    @PostMapping
+    public Result<Long> add(@Validated(InsertGroup.class) @RequestBody XxxDTO dto) {
+        return Result.ok(xxxService.add(dto));
     }
 
-    @PostMapping("/delete")
-    @ApiOperation(value = "功能描述-删除")
-    public void delete(@RequestBody LeRequest<Long> request) {
-        xxxService.delete(request.getContent());
+    /**
+     * 修改
+     */
+    @PutMapping
+    public Result<Void> update(@Validated(UpdateGroup.class) @RequestBody XxxDTO dto) {
+        xxxService.update(dto);
+        return Result.ok();
+    }
+
+    /**
+     * 删除
+     */
+    @DeleteMapping("/{ids}")
+    public Result<Void> delete(@PathVariable List<Long> ids) {
+        xxxService.deleteByIds(ids);
+        return Result.ok();
     }
 }
 ```
 
 ---
 
-## 参数封装规范
+## 统一响应封装
 
-### 请求参数用 LeRequest 包装
+### Result 包装类（通用模式）
 
 ```java
-@PostMapping("/query")
-public Page<XxxVO> query(@RequestBody LeRequest<XxxQueryParam> request) {
-    return xxxService.pageList(request.getContent());
+@Data
+public class Result<T> {
+    private int code;
+    private String message;
+    private T data;
+
+    public static <T> Result<T> ok() {
+        return ok(null);
+    }
+
+    public static <T> Result<T> ok(T data) {
+        Result<T> result = new Result<>();
+        result.setCode(200);
+        result.setMessage("success");
+        result.setData(data);
+        return result;
+    }
+
+    public static <T> Result<T> fail(String message) {
+        Result<T> result = new Result<>();
+        result.setCode(500);
+        result.setMessage(message);
+        return result;
+    }
 }
 ```
 
-### 分页参数
+### 分页响应
 
 ```java
 @Data
-public class XxxPageParam implements Serializable {
-    @NotNull(message = "分页参数不能为空")
-    private PageDTO page;
-    private String keyword;
-    private Integer status;
+public class PageResult<T> {
+    private List<T> records;
+    private long total;
+    private long current;
+    private long size;
 }
 ```
 
+---
+
+## 参数校验
+
 ### 分组校验
 
 ```java
@@ -116,142 +156,152 @@ public class XxxDTO {
     private Long id;
 
     @NotBlank(message = "名称不能为空", groups = {InsertGroup.class, UpdateGroup.class})
+    @Size(max = 100, message = "名称长度不能超过100个字符")
     private String name;
+
+    @Min(value = 0, message = "排序不能为负数")
+    private Integer sort;
 }
 
 // Controller 中应用
-@PostMapping("/add")
-public Long add(@Validated(InsertGroup.class) @RequestBody LeRequest<XxxDTO> request)
-```
+@PostMapping
+public Result<Long> add(@Validated(InsertGroup.class) @RequestBody XxxDTO dto) { ... }
 
-> Jakarta Validation: 项目用 JDK 21，必须 `import jakarta.validation.constraints.*`
+@PutMapping
+public Result<Void> update(@Validated(UpdateGroup.class) @RequestBody XxxDTO dto) { ... }
+```
 
----
+> Jakarta Validation: JDK 17+ 必须 `import jakarta.validation.constraints.*`
 
-## 响应格式
+### 查询参数
 
 ```java
-// 分页响应
-@PostMapping("/query")
-public Page<XxxVO> query(@RequestBody LeRequest<XxxQueryParam> request) { ... }
+@Data
+public class XxxQueryDTO {
+    private String keyword;
+    private Integer status;
 
-// 单条数据
-@GetMapping("/{id}")
-public XxxVO getById(@PathVariable Long id) { ... }
+    @Min(value = 1)
+    private Integer pageNum = 1;
 
-// 新增返回 ID / 修改删除返回 void
-@PostMapping("/add")
-public Long add(@RequestBody LeRequest<XxxDTO> request) { ... }
+    @Min(value = 1) @Max(value = 100)
+    private Integer pageSize = 10;
+}
 ```
 
 ---
 
 ## 常见场景
 
-### 带 Redisson 分布式锁的导入
+### 带分布式锁的导入
 
 ```java
-@PostMapping("/import-excel")
-@ApiOperation(value = "Excel导入")
-public void importExcel(@RequestParam(value = "file") MultipartFile file) {
-    if (Objects.isNull(file) || file.isEmpty()) {
-        throw new LeException("文件不能为空");
-    }
-    RLock lock = redissonClient.getLock("import:lock:" + TenantContextHolder.getTenantId());
-    if (!lock.tryLock(5, 60, TimeUnit.SECONDS)) {
-        throw new LeException("正在处理中，请稍后再试");
+@PostMapping("/import")
+public Result<Void> importExcel(@RequestPart("file") MultipartFile file) {
+    if (file == null || file.isEmpty()) {
+        throw new [你的异常类]("文件不能为空");
     }
+    RLock lock = redissonClient.getLock("import:lock:" + getCurrentTenantId());
     try {
-        xxxService.importExcel(file);
-    } finally {
-        if (lock.isLocked() && lock.isHeldByCurrentThread()) {
-            lock.unlock();
+        if (!lock.tryLock(5, 60, TimeUnit.SECONDS)) {
+            throw new [你的异常类]("正在处理中，请稍后再试");
+        }
+        try {
+            xxxService.importExcel(file);
+        } finally {
+            if (lock.isLocked() && lock.isHeldByCurrentThread()) {
+                lock.unlock();
+            }
         }
+    } catch (InterruptedException e) {
+        Thread.currentThread().interrupt();
+        throw new [你的异常类]("导入被中断");
     }
+    return Result.ok();
 }
 ```
 
 ### 批量删除
 
 ```java
-@RequestMapping(value = "/batch/delete", method = {RequestMethod.POST, RequestMethod.PUT})
-@ApiOperation(value = "批量删除")
-public void batchDelete(@RequestBody LeRequest<List<Long>> request) {
-    if (CollUtil.isEmpty(request.getContent())) {
-        throw new LeException("ID列表不能为空");
+@DeleteMapping("/{ids}")
+public Result<Void> delete(@PathVariable List<Long> ids) {
+    if (ids == null || ids.isEmpty()) {
+        throw new [你的异常类]("ID列表不能为空");
     }
-    xxxService.batchDelete(request.getContent());
+    xxxService.deleteByIds(ids);
+    return Result.ok();
 }
 ```
 
-### 带合计行的分页查询
+### 文件上传
 
 ```java
-@PostMapping("/query")
-@ApiOperation(value = "分页查询（带合计）")
-public ReportBaseTotalVO<XxxVO> query(@RequestBody LeRequest<XxxQueryParam> request) {
-    ReportBaseTotalVO<XxxVO> result = new ReportBaseTotalVO<>();
-    result.setTotalLine(xxxService.getSummaryTotal(request.getContent()));
-    result.setResultPage(PageVO.of(xxxService.pageList(request.getContent())));
-    return result;
+@PostMapping(value = "/upload", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
+public Result<UploadResult> upload(@RequestPart("file") MultipartFile file) {
+    return Result.ok(ossService.upload(file));
 }
 ```
 
 ---
 
-## Swagger 注解
+## API 文档注解
+
+### Swagger / SpringDoc 注解
 
 ```java
-@Api(value = "模块/功能", tags = "模块/功能")  // Controller 类
-@ApiOperation(value = "功能描述-新增")           // 方法
-@ApiModel("功能描述DTO")                         // DTO/VO 类
-@ApiModelProperty(value = "主键ID", required = true) // 字段
+// SpringDoc (OpenAPI 3.0, 推荐)
+@Tag(name = "用户管理")                              // Controller 类
+@Operation(summary = "新增用户")                      // 方法
+@Schema(description = "用户DTO")                      // DTO/VO 类
+@Schema(description = "主键ID", requiredMode = REQUIRED) // 字段
+
+// Swagger 2 (旧项目)
+@Api(value = "用户管理", tags = "用户管理")
+@ApiOperation(value = "新增用户")
+@ApiModel("用户DTO")
+@ApiModelProperty(value = "主键ID", required = true)
 ```
 
 ---
 
-## 检查清单
+## 全局异常处理
 
-- [ ] 认证注解 `@RequiresAuthentication`
-- [ ] API 文档注解 `@ApiOperation`
-- [ ] 参数校验 `@Validated` + 分组
-- [ ] 返回值类型正确（分页用 `Page<VO>`）
-- [ ] 使用 `LeRequest<T>` 封装请求
-- [ ] 敏感操作加分布式锁
+```java
+@RestControllerAdvice
+public class GlobalExceptionHandler {
 
----
+    @ExceptionHandler([你的异常类].class)
+    public Result<Void> handleBusinessException([你的异常类] e) {
+        return Result.fail(e.getMessage());
+    }
 
-## 多项目对比
+    @ExceptionHandler(MethodArgumentNotValidException.class)
+    public Result<Void> handleValidException(MethodArgumentNotValidException e) {
+        String message = e.getBindingResult().getFieldErrors().stream()
+            .map(FieldError::getDefaultMessage)
+            .collect(Collectors.joining(", "));
+        return Result.fail(message);
+    }
 
-| 特征 | RuoYi-Vue-Plus | leniu-tengyun-core |
-|-----|----------------|-------------------|
-| JDK | 17 | 21 |
-| 包名 | `org.dromara.*` | `net.xnzn.core.*` |
-| 请求封装 | 直接 BO | `LeRequest<T>` |
-| 响应封装 | `R<T>`, `TableDataInfo<T>` | `Page<T>`, `void` |
-| 分组校验 | `AddGroup`, `EditGroup` | `InsertGroup`, `UpdateGroup` |
-| 认证 | `@SaCheckPermission` | `@RequiresAuthentication` |
-| 异常 | `ServiceException` | `LeException` |
-| 国际化 | `MessageUtils.message()` | `I18n.getMessage()` |
+    @ExceptionHandler(Exception.class)
+    public Result<Void> handleException(Exception e) {
+        log.error("系统异常", e);
+        return Result.fail("系统繁忙，请稍后再试");
+    }
+}
+```
 
 ---
 
-## 错误对比
+## 检查清单
 
-```java
-// ---- 错误 ----
-@RestController                                    // 缺认证注解
-public Long add(@RequestBody XxxDTO dto) { }       // 不用 LeRequest
-public Long add(@Valid @RequestBody LeRequest<XxxDTO> request) { }  // @Valid 应为 @Validated(InsertGroup.class)
-import javax.validation.constraints.NotNull;        // JDK 21 用 jakarta
-
-// ---- 正确 ----
-@RestController @RequiresAuthentication
-public Long add(@Validated(InsertGroup.class) @RequestBody LeRequest<XxxDTO> request) {
-    return xxxService.add(request.getContent());
-}
-import jakarta.validation.constraints.NotNull;
-```
+- [ ] 认证注解（`@PreAuthorize` / `[你的认证注解]`）
+- [ ] API 文档注解（`@Operation` / `@ApiOperation`）
+- [ ] 参数校验 `@Validated` + 分组
+- [ ] 统一响应包装 `Result<T>`
+- [ ] 敏感操作加分布式锁
+- [ ] 全局异常处理器已配置
 
 ---
 
@@ -259,8 +309,7 @@ import jakarta.validation.constraints.NotNull;
 
 | 需要了解 | Skill |
 |---------|-------|
-| Service 层 | `java-service` |
-| Controller 详细 | `java-controller` |
 | 异常处理 | `error-handler` |
-| 参数校验 | `java-entity` |
 | 数据库设计 | `database-ops` |
+| 缓存 | `redis-cache` |
+| 文件上传 | `file-oss-management` |