gen-dto
common-rule.md 컨벤션에 맞는 Request/Response DTO 클래스를 생성하는 스킬. "/gen-dto"를 입력하거나, "DTO 만들어줘" 같은 요청에 트리거된다. 대상 도메인과 필요한 내부 클래스를 인터뷰로 수집한 뒤 바로 코드를 생성한다.
SKILL.md.claude/skills/gen-dto/SKILL.md
GitHubGen DTO
Request/Response DTO 클래스를 생성하는 스킬이다.
언제 사용하는가
- 새 도메인의 DTO가 필요할 때
- "DTO 만들어줘" 요청 시
인터뷰 항목
다음 정보를 질문으로 수집한다. 한 번에 하나씩 묻는다.
- 대상 도메인 — 어떤 도메인인지 (예:
Board) - Request 내부 클래스 — 필요한 기능별 클래스 (예:
Save,Update,Login) - Response 내부 클래스 — 필요한 데이터 범위별 클래스 (예:
Max,Min,Detail) - 각 클래스의 필드 — 포함할 필드 목록
사용자가 이미 충분한 정보를 제공했다면 추가 질문 없이 바로 생성한다.
생성 규칙
반드시 _docs/.ai/rules/common-rule.md의 DTO 규칙을 따른다:
파일 구조
- 도메인당 파일 하나씩:
{Domain}Request.java,{Domain}Response.java - 외부 클래스에는 어노테이션 없음
@Data는 내부 static class에만
Request 네이밍
내부 클래스 이름은 기능명으로:
Save— 등록Update— 수정Login— 로그인Join— 회원가입
Response 네이밍
내부 클래스 이름은 데이터 범위 기준으로:
Max— 테이블 전체 컬럼 (상세/목록 겸용)Min— 최소 정보 (id + 대표값)Detail— 조인 포함 확장 정보Option— 셀렉트박스/드롭다운용DTO— 범용 (위 분류에 해당하지 않을 때)
Entity → DTO 변환
생성자 또는 정적 팩토리 메서드로 처리한다.
Request 예시
package com.example.ajax_demo.board;
public class BoardRequest {
@Data
public static class SaveOrUpdateDTO {
private String title;
private String content;
}
}
Response 예시
package com.example.ajax_demo.board;
import lombok.Data;
public class BoardResponse {
@Data
public static class DTO {
private Integer id;
private String title;
public DTO(Board board) {
this.id = board.getId();
this.title = board.getTitle();
}
}
@Data
public static class DetailDTO {
private Integer id;
private String title;
private String content;
private String username;
private boolean isOwner;
public DetailDTO(Board board, User sessionUser) {
this.id = board.getId();
this.title = board.getTitle();
this.content = board.getContent();
this.username = board.getUser().getUsername();
this.isOwner = sessionUser != null
&& board.getUser().getId().equals(sessionUser.getId());
}
}
}
생성 위치
src/main/java/com/example/ajax_demo/{domain}/{Domain}Request.java
src/main/java/com/example/ajax_demo/{domain}/{Domain}Response.java
주의사항
- Entity가 먼저 존재해야 한다. 없으면 사용자에게 알린다
- 외부 클래스에
@Data붙이지 않는다 - Entity를 Controller에 직접 전달하지 않기 위해 DTO 변환은 필수다