peach-erd

Original：🇺🇸 English

Translated

Mermaid ERD 전체 워크플로우 스킬. MCP 설치 → mmd 생성 → 브라우저 미리보기 → PNG/SVG 저장까지 원스톱 처리. "ERD 업데이트", "ERD 미리보기", "ERD 저장", "ERD 그려줘", "테이블 추가", "관계 변경", "DB 설계 시각화", "ERD에 컬럼 추가", "erd.mmd 수정" 키워드로 트리거. DB 스키마나 테이블 구조를 시각화하려는 의도가 보이면 이 스킬을 사용하라.

2installs

Sourcepeachsolution/peach-harness

Added on2026-04-04

NPX Install

npx skill4agent add peachsolution/peach-harness peach-erd

SKILL.md Content

View Translation Comparison →

ERD 원스톱 스킬

파일 경로

파일	용도
`docs/erd/erd.mmd`	Mermaid ERD 소스
`docs/erd/erd.png`	PNG 렌더링 (git 커밋용)
`docs/erd/erd.svg`	SVG 렌더링 (git 커밋용)

워크플로우

1단계: 환경 확인

mermaid MCP 서버가 등록되어 있는지 확인한다.

bash

claude mcp list 2>/dev/null | grep mermaid

미등록 시 자동 설치:

bash

npm install -g claude-mermaid
claude mcp add --scope user mermaid claude-mermaid

설치 후 사용자에게 "claude-mermaid MCP를 설치했습니다. Claude Code를 재시작해야 MCP가 활성화됩니다." 안내한다.

2단계: erd.mmd 확인

docs/erd/erd.mmd

파일이 존재하는지 확인한다.

파일 없으면 → 폴더 생성 + 기본 템플릿으로 erd.mmd 생성:

mermaid

erDiagram
    example["example (예시)"] {
        serial4 example_seq PK "일련번호"
        varchar name "이름"
    }

파일 있으면 → 읽어서 현재 내용 파악.

3단계: 수정

사용자가 수정을 요청하면 erd.mmd를 수정한다. 수정 없이 미리보기/저장만 요청한 경우 이 단계를 건너뛴다.

4단계: 병렬 실행 (미리보기 + 파일 저장)

erd.mmd의 내용을 읽고 두 작업을 동시에 실행한다.

작업 A — 브라우저 미리보기 (mermaid MCP):

mcp__mermaid__mermaid_preview:
  preview_id: "erd-main"
  diagram: {erd.mmd 전체 내용}
  width: 1400
  height: 1200
  scale: 2

작업 B — PNG/SVG 파일 저장 (Bash, 프로젝트 루트에서):

bash

npx @mermaid-js/mermaid-cli@latest \
  -i docs/erd/erd.mmd \
  -o docs/erd/erd.png \
  -s 2 && \
npx @mermaid-js/mermaid-cli@latest \
  -i docs/erd/erd.mmd \
  -o docs/erd/erd.svg

작업 A 실패 시 (MCP 미연결):

작업 B(CLI)만 실행하여 PNG/SVG 저장은 보장한다.
사용자에게 안내: "브라우저 미리보기를 사용하려면 Claude Code를 재시작하거나
```
claude mcp add --scope user mermaid claude-mermaid
```
로 MCP를 등록하세요."

5단계: 결과 보고

브라우저 미리보기 URL (성공 시)
저장된 PNG/SVG 파일 경로
수정 반복이 필요하면 3단계로 돌아간다

ERD 작성 규칙

엔티티명

["영문명 (한글명)"]

형식으로 작성한다. 관계선에서는 엔티티명만 사용한다 (병기하면 렌더링 오류).

kacta_staff["kacta_staff (직원)"] { ... }     ✅
kacta_staff ||--o{ kacta_staff_hist : "이력"   ✅
kacta_staff["kacta_staff (직원)"] ||--o{ ...   ❌ 렌더링 오류

인덱스 마커

컬럼 코멘트 끝에 대괄호로 표기한다.

마커	의미	예시
`[IDX]`	일반 인덱스	`int4 office_seq FK "kacta_office 참조 [IDX]"`
`[PIDX]`	Partial Index (WHERE is_delete='N')	`varchar status "상태 코드 [PIDX]"`
`[UIDX]`	Unique Index	`varchar cert_no "증명서 번호 [UIDX]"`
`[PIDX:a+b]`	복합 Partial Index	`varchar status "... [PIDX:status+region_seq]"`

감사 필드

마스터 테이블:

is_delete

,

insert_seq

,

insert_date

,

update_seq

,

update_date

이력 테이블:
```
insert_seq
```
,
```
insert_date
```
(만)

peach-erd

NPX Install

Tags

SKILL.md Content

ERD 원스톱 스킬

파일 경로

워크플로우

1단계: 환경 확인

2단계: erd.mmd 확인

3단계: 수정

4단계: 병렬 실행 (미리보기 + 파일 저장)

5단계: 결과 보고

ERD 작성 규칙

엔티티명

인덱스 마커

감사 필드