java-springboot-standards-skilllisted

# /java-springboot-standards-skill — Spring Boot 单体、微服务、Spring AI 与安全合规开发规范 本 Skill 是面向企业级 **Java Spring Boot 单体架构（Monolith & Modular Monolith）**、**微服务架构（Spring Cloud Alibaba）**、**Spring AI 智能体体系** 与 **Spring Security 安全合规防护** 的全栈开发与审查规范，提供从工程脚手架、软件包分层、六端接口隔离、数据流转、统一上下文、安全防御体系、AI 智能体与微服务联动到 Javadoc/步骤化业务注释的闭环标准。 --- ## 1. 按需适配与反过度设计铁律 (Zero Over-Engineering) **【核心纪律】严禁凭空给不需要的项目堆砌无关技术栈！** Agent 在为工程生成代码或包结构时，必须严格基于**当前项目的 `pom.xml` 依赖与用户的实际需求**进行按需匹配： 1. **普通单体项目 (无 AI)**： * 只生成/遵循经典的 MVC / DDD 规范包结构（`controller`, `service`, `mapper`, `model.{domain,dto,vo}`）。 * **绝对禁止**创建 `agent/`, `advisor/`, `tools/`, `memory/` 等 AI 目录；**绝对禁止**引入 Spring AI 依赖或编写智能体/大模型相关代码。 2. **普通微服务项目 (无 AI)**： * 只生成/遵循微服务标准治理（Feign, Nacos, Seata, Redisson, RabbitMQ, XXL-Job）。 * **绝对禁止**无端引入 AI 模块。 3. **AI 赋能项目 (明确包含 Spring AI / LLM 需求)**： * 仅在存在 `spring-ai` 相关依赖或用户明确要求 AI / 智能体 / RAG / 工具调用场景时，方可按需启用 `agent/`, `tools/`, `advisor/` 及流式 SSE 规范。 --- ## 2. 触发场景 (Trigger) 当用户或 Agent 在处理以下任何场景时必须激活本 Skill： * **Spring Boot 架构与分层接口开发**：创建或重构单体模块、Maven 多模块工程、通用 Starter、Feign 契约层，以及编写 Controller、Service、Mapper、Domain/DTO/VO、参数校验、统一响应与异常、六端路由划分。 * **数据建模与数据流转**：设计实体字段、审计字段、Entity/DTO/VO 契约、分页查询、MyBatis/MyBatis-Plus 映射、联表查询、多表装配、N+1 查询治理、状态数据、用户归属和订单快照等数据规范。 * **安全防护与合规审查**：配置 Spring Security、JWT 身份认证、`@PreAuthorize` 方法级鉴权、SQL 注入与 XSS 防御、PII 数据脱敏、接口限流、上线前安全审查。 * **事务、并发与中间件治理**：处理本地/分布式事务、Redis + Lua 原子扣减、Redisson 分布式锁、状态机、Canal + ElasticSearch 同步、RabbitMQ、XXL-Job 等 Spring Cloud 组件。 * **Spring