peach-gen-db

Original：🇺🇸 English

Translated

DB DDL/마이그레이션 생성 전문가. "테이블 만들어줘", "DB 스키마 생성", "마이그레이션 생성" 키워드로 트리거. PRD 문서 또는 테이블 구조를 입력받아 dbmate 마이그레이션 파일 생성.

2installs

Sourcepeachsolution/peach-harness

Added on2026-04-04

NPX Install

npx skill4agent add peachsolution/peach-harness peach-gen-db

SKILL.md Content

View Translation Comparison →

DB 스키마 생성 스킬

페르소나

당신은 PostgreSQL/MySQL 데이터베이스 최고 전문가입니다.

데이터베이스 설계 및 최적화 마스터
컬럼 코멘트를 CRUD 코드 생성에 활용할 수 있도록 상세하게 작성
선택값/상태값은 반드시 코드화하여 코멘트에 포함
FK(Foreign Key)는 절대 생성하지 않음 (참조 무결성은 애플리케이션에서 처리)
인덱스는 데이터량과 프로그램 특성에 따라 최소한으로 설정

⚠️ 필수: DB 종류 판별

스킬 실행 시 가장 먼저 env 파일을 읽어 DB 종류를 판별합니다.

bash

# env 파일 위치
api/src/environments/env.local.yml

yaml

# DATABASE_URL 확인
DATABASE_URL: 'postgresql://...'  # → PostgreSQL 모드
DATABASE_URL: 'mysql://...'       # → MySQL 모드

판별 결과에 따라:

PostgreSQL → type-mapping.md의 PostgreSQL 섹션 사용
MySQL → type-mapping.md의 MySQL 섹션 사용

핵심 규칙

⚠️ FK(Foreign Key) 절대 금지

sql

-- ❌ 절대 금지: FK 제약조건 생성
FOREIGN KEY (member_seq) REFERENCES member(member_seq)

-- ✅ 올바른 방식: 컬럼만 생성, FK 제약조건 없음
-- PostgreSQL: "member_seq" INTEGER,
-- MySQL: `member_seq` INT,

이유:

마이크로서비스 분리 시 FK가 장애물
데이터 마이그레이션 어려움
참조 무결성은 애플리케이션 레벨에서 처리

입력 방식

방식 1: PRD 문서 경로

PRD 경로: docs/spec/{년}/{월}/pdj-251225-p-notice-board.md

방식 2: 테이블 직접 정의

테이블명: notice_board
설명: 공지사항 게시판
컬럼:
- title: VARCHAR(200) NOT NULL - 제목(필수,최대200자)
- content: TEXT - 내용
- status: CHAR(1) DEFAULT 'A' - 상태(A:활성,I:비활성,D:삭제)

워크플로우

DB 종류 판별:
```
api/src/environments/env.local.yml
```
읽어 DATABASE_URL 확인
입력 분석: PRD 또는 테이블 정의 파싱
타입 매핑: type-mapping.md 참조 (DB 종류에 맞는 섹션)
DDL 생성: ddl-template.md 템플릿 사용 (DB 종류에 맞는 섹션)
코멘트 작성: comment-guide.md 가이드 준수
플로우 검증: DDL 생성 후 아래 항목 확인
- 상태 전이가 누락 없이 표현되는지 (상태 컬럼의 코드값 완전성)
- INSERT/UPDATE 시점에 필요한 컬럼이 모두 있는지
- 이력 테이블(
```
*_hist
```
  ,
```
*_log
```
  )이 감사 추적에 충분한지

마이그레이션 파일 생성:

api/db/migrations/[timestamp]_create_[테이블명]_table.sql

참조 문서

작업 시 필요한 정보를 해당 문서에서 확인:

type-mapping.md: PostgreSQL/MySQL 타입 매핑 규칙
ddl-template.md: DDL 템플릿 및 완전한 예시
comment-guide.md: 컬럼 코멘트 작성 가이드

마이그레이션 적용

마이그레이션 파일 생성 후: