技能介绍

要解决什么问题

团队里 Java 微服务常出现「每人一套 Gradle 结构、响应 JSON 各写各的、REST 路径带 {id}、Controller 里堆业务」——评审成本高，也很难和现有腾讯系 starter（统一响应、七彩石、Polaris）对齐。本技能把 10 年架构师级约定 写进可执行的 assets/project-template/ 脚手架，并附带 Project CRUD 分层参考实现，让生成与重构代码时有明确对照物，而不是口头规范。

技能如何工作

技术栈锁定：JDK 17、Gradle 8.10 多模块、Spring Boot 3.3.5（Jakarta）、Ebean 13.18、MySQL 8、Redis（Jedis）、knife4j、p6spy 等；版本集中在根 gradle.properties。
新建服务必走模板：复制模板 → 批量替换 template / template-service → 校验 settings.gradle、主类与 application.yml → ./gradlew build -x test 验证；禁止从零手写工程骨架。
分层与 API 铁律：Controller 只编排；Service 接口/实现分离且不返回 VO；Repository 为 XxxDao + QueryBean；URL 不含资源 id（动作用 /projects/create、/detail 等，id 进 @RequestBody 且对外 String）；对外一律 ServiceResponse / PageResultResponse，业务异常走 ServiceException 与分段错误码。
编码与自检：阿里嵩山版命名/格式、方法 ≤80 行、关键逻辑用 // 1. xxx 步骤注释；提交前对照 SKILL 内自检清单（事务、软删、VO from() 工厂等）。

适用边界

面向 风格 A 的微服务后端，不是通用 Spring 教程；强依赖模板中的 CRM starter、鉴权三件套、Rainbow/Polaris 等接入方式。
SkillHub 分发版需按 references/template-build-files.md 还原被平台过滤的 Gradle/Docker 等构建文件后再 wrapper，否则无法与文档中的构建路径一致。
新增三方依赖须先与用户确认并写入 gradle.properties；实体与查询需遵守 Ebean 不继承 io.ebean.Model、默认软删过滤等约束，偏离模板需自行承担集成风险。