#Skill Creator — 构建自定义技能

---
name: java-to-openapi
description: >
  将 Java 实体类转换为 OpenAPI 3.0 Schema JSON。
  当用户提到"生成 API 文档"、"实体转 OpenAPI"、"导出 Schema"、
  "Java 转 JSON Schema" 时触发。
  支持 JPA 注解识别和嵌套实体处理。
  不要用于非 Java 项目或非 OpenAPI 格式的文档生成。
---

# Java → OpenAPI Schema 转换

## 触发条件
- 用户输入 .java 文件路径
- 提到 OpenAPI / Swagger / Schema 生成
- 需要 API 文档自动生成

## 转换规则
1. Java String → { "type": "string" }
2. Java Integer/Long → { "type": "integer", "format": "int64" }
3. Java BigDecimal → { "type": "number", "format": "double" }
4. Java LocalDate → { "type": "string", "format": "date" }
5. Java LocalDateTime → { "type": "string", "format": "date-time" }
6. Java Enum → { "type": "string", "enum": [...] }
7. JPA @Column(name="X") → Schema property name = X
8. JPA @ManyToOne → { "$ref": "#/components/schemas/..." }

## 输出格式
每个实体输出为 components/schemas/<EntityName> 节点，
所有 schema 合并到一个 JSON 文件。

---
name: team-code-standards
description: >
  团队 Java 代码规范。在任何 Java 代码编写时自动生效。
  包含返回值格式、异常处理、命名规范、日志、日期类型的强制约定。
  这是一个 always-on 类型的技能，不需要特殊触发词。
alwaysApply: true
---

# 团队 Java 代码规范

## Controller 层
- 返回类型：`Result<T>`（统一响应体），不用 `ResponseEntity`
- 异常：抛出自定义业务异常，由 `GlobalExceptionHandler` 统一处理
- 不在 Controller 写 try-catch 包围整个方法体

## Service 层命名
- 查询单个：`getXxx`（如 getOrderById）
- 查询列表：`listXxx`（如 listOrdersByUser）
- 创建：`createXxx`
- 更新：`updateXxx`
- 删除：`deleteXxx`
- 不在 Service 方法名里加 redundant 前缀（不用 doCreate、handleUpdate）

## 日志
- 用 Lombok `@Slf4j`
- 用 `log.info/warn/error`，不用 `System.out.println`
- 异常日志：`log.error("订单创建失败, orderId={}", id, e)`

## 日期
- 全部用 `java.time.LocalDateTime` / `LocalDate` / `LocalTime`
- 不用 `java.util.Date` 或 `java.sql.Timestamp`
- 序列化依赖 Jackson 的 `JavaTimeModule`（项目已配置）

---
name: vue-project-conventions
description: >
  Vue 3 项目约定。编写 Vue 代码时自动应用。
  alwaysApply: true
---

## 状态管理
- 用 Pinia。定义 store：`src/stores/<name>.ts`
- 使用 `storeToRefs` 解构响应式属性
- Actions 用 async/await

## 路由
- 页面路由：`src/router/routes.ts`
- 页面组件放 `src/views/<PageName>.vue`
- 路由 meta 包含 title 字段

## UI 组件
- 优先用 Element Plus 内置组件（el-button、el-table、el-dialog...）
- 不要用原生 button/input 替代
- 自定义组件放 `src/components/`

## 组合式 API
- `<script setup lang="ts">`，不用 `export default`
- 用 `defineProps<T>()` 泛型语法
- 用 `defineEmits<T>()` 泛型语法
- Composable 抽到 `src/composables/useXxx.ts`