GPT Image 2

이 스킬은 GPT Image 2에 특화된 스킬로, 3가지 실행 환경 모두에서 사용할 수 있지만 동작에 상당한 차이가 있습니다. 첫 번째 단계로 현재 실행 모드를 반드시 확인해야 합니다.

이 스킬은 다음 두 가지 유형의 이미지 작업만 수행합니다:

• 이미지 생성: POST /images/generations
• 이미지 편집: POST /images/edits

이 문서에는 다음 내용이 포함됩니다: 실행 모드, 스킬 구조, 환경 변수, 저장/명명 규칙, 템플릿 색인, 모드 인식 워크플로우. 자세한 템플릿은 모두 references/ 디렉터리에 있으며, 다음과 같이 계층적으로 구성되어 있습니다:

• 1단계: 카테고리 디렉터리
• 2단계: 개별 템플릿 Markdown 파일

실행 모드 (필독, 어떤 작업을 수행하기 전에 먼저 확인해야 함)

이 Skill에는 경량 탐지 스크립트가 포함되어 있습니다. 먼저 한 번 실행한 후, 결과에 따라 작업 방식을 결정하십시오:

node skills/ gpt-image-2/scripts/check-mode.js
# 구조화된 결과를 상위 프로그램에 전달하려면:
node skills/ gpt-image-2/scripts/check-mode.js --json

출력 결과에는 mode = A / A? / B-or-C 및 recommendation이 표시됩니다. 세 가지 모드는 다음과 같이 정의됩니다:

모드 A · Garden 로컬 이미지 생성

트리거 조건: 환경 변수 ENABLE_GARDEN_IMAGEGEN이 참( 1 / true / yes / on ) 이고 OPENAI_API_KEY가 존재할 때.

동작: "템플릿 선택 → 프롬프트 작성 → 스크립트 호출 → 이미지 생성 및 저장"의 전체 엔드투엔드 프로세스가 성공적으로 완료됩니다.

• scripts/generate.js를 사용하여 텍스트로 이미지를 생성하고, scripts/edit.js로 기존 이미지를 편집합니다.
• 프롬프트는 기본적으로 garden- gpt-image-2/prompt/ 에, 이미지는 garden- gpt-image-2/image/에 저장됩니다.
• 이것이 가장 강력한 모드입니다: 여러분은 이미지 도구의 "소유자"가 됩니다.

모드 B · Host-Native: 호스트에 이미지 생성을 위임

발동 조건: Garden이 활성화되지 않았으나( ENABLE_GARDEN_IMAGEGEN이 설정되지 않았거나 / false인 경우), 현재 호스트 Agent에 이미지 생성 도구 또는 이미지 MCP가 내장되어 있는 경우.

전형적인 식별 신호 (직접 확인해 보세요):

• 도구 세트에 image_generation / imagegen / dalle / nano_banana / mcp__*image* / make_image / 등과 유사한 이름이 포함되어 있는 경우
• 사용자가 ChatGPT / Codex / Gemini / Cursor 등 네이티브 이미지 생성을 지원하는 클라이언트에서 본 스킬을 호출하는 경우
• 사용자가 명시적으로 "자신의 도구를 사용하여 이미지를 생성해 주세요"라고 요청하는 경우

행동: 본 스킬이 프롬프트 엔지니어링 지침으로 전락합니다——

1. 여전히 "템플릿 선택 → 필드 입력 → 최종 프롬프트 렌더링"의 절차를 따릅니다.
2. node scripts/generate.js를 호출하지 마십시오 (API 키가 없어 반드시 실패합니다).
3. 호스트가 기본으로 제공하는 이미지 도구를 직접 호출하여, 렌더링된 프롬프트를 입력으로 전달합니다.
4. 사용자가 원할 경우 프롬프트 파일을 garden- gpt-image-2/prompt/에 저장할 수 있지만, 이미지 저장 위치는 호스트가 결정하며 강제하지 않습니다.

모드 C · Advisor 순수 프롬프트 어드바이저

트리거 조건: Garden이 활성화되지 않았고, 호스트 에이전트에도 이미지 생성 도구가 전혀 없는 경우.

동작: 본 스킬은 "고품질 프롬프트 작성 어드바이저"로 기능이 축소됩니다——

1. "템플릿 선택 → 필드 입력 → 최종 프롬프트 생성" 과정을 따르며, 정보가 부족하면 사용자에게 묻습니다.
2. 최종 프롬프트를 사용자에게 직접 출력하고, garden- gpt-image-2/prompt/ - .md에 한 부 저장합니다.
3. 간단한 "사용 방법" 조언을 한 줄 덧붙입니다(예: ChatGPT / Midjourney / DALL·E / Sora / Nano Banana / 자체 백엔드 / 타사 GPT Image 2 게이트웨이에 입력).
4. 이미지 생성이 성공한 것처럼 가장하지 마세요. 사용자에게 "바로 재사용 가능한 고품질 프롬프트가 생성되었습니다. 본인의 이미지 도구를 사용하여 실행해 주세요"라고 명확히 안내하세요.

패턴 결정표

모드가 불확실한 경우

• 자신이 B인지 C인지 판단이 서지 않는다면, 사용자에게 직접 "사용자 환경의 이미지 도구를 사용해 이미지를 생성할까요, 아니면 제가 프롬프트를 작성해 드릴까요?" 라고 물어보세요.
• 모드 A 스크립트 호출 실패(401 / 네트워크 / 할당량) → 오류 메시지를 표시하고 "B / C로 전환할까요?"라고 묻습니다.

사용자가 도구를 입력

이 스킬이 사용자에게 질문을 해야 할 때는 다음 규칙을 따릅니다:

1. 현재 런타임에서 제공하는 사용자 입력 도구를 우선적으로 사용합니다.
2. 해당 도구가 없는 경우, 간결한 순수 텍스트 형식의 번호 매기기 질문으로 물어봅니다.
3. 합칠 수 있는 질문은 가능한 한 한 번에 모두 묻습니다.

스킬 구조

• scripts/check-mode.js: 이 파일을 먼저 실행하여 실행 모드(A / B / C)를 확인합니다.
• scripts/generate.js: 텍스트를 기반으로 이미지 생성 (Mode A에서만 사용)
• scripts/edit.js: 원본 이미지/마스크를 기반으로 이미지 수정 (Mode A에서만 사용)
• scripts/shared.js: 공유 요청, 저장, 환경 변수 읽기 로직
• references/: 계층적 구조의 프롬프트 템플릿 (A / B / C 세 모드 모두 사용)

환경 변수

다음 순서대로 구성을 읽습니다:

1. CLI 인수
2. process.env
3. /.env
4. /.gateway.env
5. ~/.gateway.env

핵심 변수:

• ENABLE_GARDEN_IMAGEGEN — 모드 토글. 1 / true / yes / on일 때 Mode A가 활성화되며, 설정되지 않았거나 다른 값일 경우 Mode B / C로 진입합니다.
• OPENAI_API_KEY — Mode A에서 필수; Mode B / C에서는 필요하지 않습니다.
• OPENAI_BASE_URL — 기본값은 https://api.openai.com/v1이며, 호환되는 타사 게이트웨이를 지정할 수 있습니다.
• OPENAI_IMAGE_MODEL — 기본값 gpt-image-2 이며, 게이트웨이가 지원하는 모델(예: gpt-image-1 / dall-e-3 )로 변경할 수 있습니다.

기본 구현은 OpenAI 호환 인터페이스에 따라 작동하며, 특정 타사 게이트웨이를 고정적으로 지정하지 않습니다.

기본 출력 디렉터리

사용자가 출력 경로를 명시적으로 지정하지 않은 경우, 현재 작업 공간의 다음 경로를 일관되게 사용합니다:

• 프롬프트 디렉터리: garden- gpt-image-2/prompt/ ( A / B / C 세 가지 모드 모두에서 재사용 및 버전 관리를 용이하게 하기 위해 사용을 권장합니다 )
• 이미지 디렉터리: garden- gpt-image-2/image/ ( Mode A에서만 사용; Mode B는 호스트가 결정하며, Mode C는 이미지를 생성하지 않음)

디렉터리가 존재하지 않을 경우, 스크립트(Mode A)가 자동으로 생성해야 합니다. Mode B/C의 경우 프롬프트를 작성하기 전에 수동으로 ` mkdir -p `를 실행해야 합니다.

기본 명명 규칙

사용자가 파일명을 명시적으로 지정하지 않은 경우, 스크립트는 현재 작업과 관련된 파일명을 자동으로 생성하고 현재 타임스탬프를 추가하여 중복을 방지해야 합니다.

이름 지정 규칙:

• 프롬프트: garden- gpt-image-2/prompt/ - .md
• 이미지: garden- gpt-image-2/image/ - .png

여기서:

• : 현재 사용자의 요청에 따라 관련 짧은 이름을 자동으로 추출
• : 현재 타임스탬프(예: 20260424-153045 )

예시:

• garden- gpt-image-2/prompt/live-commerce-ui-20260424-153045.md
• garden- gpt-image-2/image/live-commerce-ui-20260424-153045.png
• garden- gpt-image-2/prompt/vr-headset-exploded-view-20260424-153102.md
• garden- gpt-image-2/image/vr-headset-exploded-view-20260424-153102.png

프롬프트 저장 규칙

일반 규칙 (세 가지 모드 모두 적용):

1. 사용자가 프롬프트 파일 경로를 명시적으로 제공한 경우, 해당 파일을 직접 입력으로 사용할 수 있습니다.
2. 사용자가 직접 텍스트 프롬프트를 제공한 경우에도, 최종 프롬프트를 먼저 garden- gpt-image-2/prompt/에 저장해야 합니다.
3. 사용자가 --prompt-output을 명시적으로 지정한 경우, 사용자가 지정한 경로를 따릅니다.
4. 그렇지 않은 경우 기본 명명 규칙에 따라 자동으로 저장합니다.

이미지 저장 규칙 (Mode A에만 해당)

1. 사용자가 --image 또는 --output을 명시적으로 지정한 경우, 사용자가 지정한 경로를 따릅니다.
2. 그렇지 않은 경우 기본적으로 garden- gpt-image-2/image/ 에 저장합니다.
3. 파일 이름은 현재 작업의 의미와 관련이 있어야 하며, 타임스탬프가 추가되어야 합니다.

Mode B는 호스트 이미지 도구가 저장 방식을 결정하며, Mode C는 이미지를 생성하지 않습니다.

간단한 사용법

0. 실행 모드 확인 ( 모든 작업의 첫 단계 )

node skills/ gpt-image-2/scripts/check-mode.js

출력 결과를 통해 현재 Mode A / B / C 중 어느 모드인지 확인할 수 있으며, 이에 따라 이후 generate.js / edit.js 호출 여부를 결정합니다. 아래 1~4는 Mode A에서만 사용됩니다.

1. 텍스트 기반 이미지 생성 (Mode A)

node skills/ gpt-image-2/scripts/generate.js \
  --prompt "A cute baby sea otter" \
  --size 1024x1024 \
  --quality high

2. 프롬프트 파일을 사용한 이미지 생성 (Mode A)

node skills/ gpt-image-2/scripts/generate.js \
  --promptfile garden- gpt-image-2/prompt/poster-20260424-153045.md

3. 기존 이미지 편집 (모드 A)

node skills/ gpt-image-2/scripts/edit.js \
  --image assets/source.png \
  --prompt "배경을 깔끔한 스튜디오 장면으로 바꿔주세요"

4. 마스크를 사용한 부분 편집 (모드 A)

node skills/ gpt-image-2/scripts/edit.js \
  --image assets/source.png \
  --mask assets/mask.png \
  --prompt "마스크된 영역만 유리 꽃병으로 교체해 주세요"

5. 모드 B / C의 "사용법"

명령줄 진입점이 없음 — 이 스킬은 현재 프롬프트 엔지니어링 가이드 역할만 수행합니다:

• Mode B: 최종 프롬프트 렌더링 → 호스트에 내장된 image_generation과 같은 도구를 호출(매개변수에 프롬프트 전달) → 이미지 획득.
• Mode C: 최종 프롬프트 생성 → garden- gpt-image-2/prompt/ - .md에 저장 → 내용을 사용자에게 직접 표시 → 어떤 이미지 도구에서 바로 재사용할 수 있는지 사용자에게 안내.

JSON 템플릿 작동 방식

references/에 JSON 템플릿이 제공될 경우, 다음 규칙에 따라 사용합니다:

1. 먼저 SKILL.md에서 가장 유사한 분류 디렉터리를 찾습니다.
2. 그런 다음 구체적인 템플릿 파일을 찾습니다.
3. 템플릿 내의 {argument ...} 는 대체 가능한 매개변수를 나타냅니다.
4. 사용자가 명시적으로 제공한 값은 그대로 입력합니다.
5. 사용자가 제공하지 않았지만 템플릿에 default로 표시된 항목은 우선 기본값을 사용할 수 있습니다.
6. 정보가 누락되어 결과에 중대한 영향을 미칠 경우, 사용자에게 적극적으로 문의하십시오.
7. 사용자가 “무작위로 생성해 주세요”라고 명시적으로 요청할 경우, 기본값을 유지하거나 템플릿이 허용하는 범위 내에서 합리적으로 무작위화할 수 있습니다.

질문 규칙

템플릿에 핵심 변수가 누락된 경우, “어떤 스타일을 원하시나요?”와 같이 포괄적으로 묻지 마십시오. 템플릿 필드에 따라 정확하게 질문해야 합니다.

예를 들어, 라이브 방송 UI 템플릿에 주체가 누락된 경우, 우선 다음과 같이 질문해야 합니다:

• 스트리머는 누구인가요?
• 실제 인물 사진, 유명인 이름, 인물 설명을 사용할 것인지, 아니면 완전히 무작위로 생성할 것인지?

상품 정보가 누락된 경우에는 다음과 같이 질문해야 합니다:

• 상품명은 무엇인가요?
• 상품 가격이 지정되어 있나요?
• 댓글과 선물 내용을 자동으로 완성해 드릴까요?

템플릿 인덱스

작업 유형에 따라 가장 적합한 구체적인 템플릿 파일만 읽어야 하며, references/ 디렉토리 전체를 한 번에 모두 읽지 마십시오.

1. 방법론 총정리 문서

먼저 읽을 파일:

• references/prompt-writing.md

적용 대상:

• JSON 템플릿을 어떻게 구성할지 아직 결정하지 못한 경우
• 어떤 필드는 질문해야 하고, 어떤 필드는 기본값으로 설정할 수 있으며, 어떤 필드는 무작위로 설정할 수 있는지 판단해야 하는 경우
• 사례를 재사용 가능한 템플릿으로 추상화해야 하는 경우

2. UI 모크업 ( references/ui-mockups/ )

다양한 “인터페이스 + 콘텐츠” 형태의 모크업 시각 자료에 적합합니다. 현재 구현된 사례:

• live-commerce-ui.md — 이커머스 라이브 스트리밍 판매 스크린샷 모크업 (스트리머 + 채팅창 + 선물 영역 + 상품 카드)
• social-interface-mockup.md — 소셜 플랫폼 피드 상세 페이지 모크업 (Twitter/X, Xiaohongshu, Weibo, Threads 등)
• product-card-overlay.md — 랜딩 페이지 헤로 / 상세 페이지 메인 이미지 (인물 + 상품 + 판매 포인트 + 가격)
• chat-interface-scene.md — 채팅/대화 인터페이스 모크업 (iMessage, 위챗, 그룹 채팅, AI 어시스턴트)
• short-video-cover-ui.md — 숏폼 영상 커버 / 라이브 스트리밍 썸네일 (YouTube, 틱톡, Bilibili, VTuber 스트리밍)
• landing-page-case-study.md — 다크 모드 SaaS / 마케팅 사례 연구 롱폼 페이지 UI 모크업 (다중 섹션 + 스크롤 기반 스토리텔링 + 데이터 카드 + CTA)

3. 제품 비주얼 ( references/product-visuals/ )

“상품을 시각적 중심으로 하는” 이미지에 적합합니다. 현재 구현된 사례:

• exploded-view-poster.md — 제품 분해도 포스터 (주제 수직 적층 + 콜아웃 + 상단 로고 + 하단 브랜드 영역)
• white-background-product.md — 이커머스 순백색 배경 메인 이미지 (단일 상품 / 다각도 / 미니멀한 마케팅 레이어링)
• premium-studio-product.md — 고급 스튜디오 상업용 제품 이미지 (잡지 광고 수준의 분위기)
• packaging-showcase.md — 선물 세트 / 포장 전시 이미지 (외부 상자 + 내용물 전시)
• lifestyle-product-scene.md — 라이프스타일 제품 장면 사진 (실제 장면 속 상품)
• ecommerce-marketing-board.md — 중국식 전자상거래 복합 판매 보드 (메인 이미지 + 상세 페이지 + 판매 포인트 + 사용 방법 + 사용 장면 + TVC 스토리보드 조합 한 장)

4. 지도 ( references/maps/ )

“지도형 시각 자료”에 적합합니다(인포그래픽은 별도의 분류 17로 분리됨). 현재 구현된 항목:

• food-map.md — 도시 맛집 손그림 지도 (번호가 매겨진 위치 + 범례 + 중심 마스코트)
• travel-route-map.md — 여행 경로 지도 (다일 일정 / 1일 시티 워크 / 아웃도어 코스)
• illustrated-city-map.md — 도시 풍경 일러스트 지도 (랜드마크 + 산과 강 + 문화적 요소)
• store-distribution-map.md — 브랜드 매장 / 서비스 커버리지 분포도
• itinerary-day-trip-map.md — 당일치기 여행 분할 포스터 (왼쪽: 양피지 스타일 일정 카드 + 오른쪽: 판타지 리얼리즘 지도, 5~7개 지점 엄격히 정렬)

5. 슬라이드 및 시각 자료 ( references/slides-and-visual-docs/ )

“한 페이지에 한 가지 주제를 명확히 설명”하는 시각적 문서에 적합합니다. 현재 구현된 사례:

• dense-explainer-slides.md — Irasutoya × 카스미가오카 혼합 고밀도 해설 슬라이드
• policy-style-slide.md — 정책 / 정부 공고 / 백서 스타일 설명 슬라이드
• visual-report-page.md — 비즈니스 보고서 실행 요약 / 투자자 브리핑 / 연차 보고서 개요 페이지
• educational-diagram-slide.md — 교육용 다이어그램 (개념 / 메커니즘 / 프로세스 분해)

6. 포스터 및 캠페인 ( references/poster-and-campaigns/ )

“브랜드 메인 비주얼 + 캠페인 + 배너 + 잡지 표지”에 적합합니다. 현재 구현된 사례:

• brand-poster.md — 브랜드 메인 포스터 (제품 / 인물 / 순수 텍스트 슬로건)
• campaign-kv.md — 캠페인 키 비주얼 + 파생 레이아웃 시스템
• banner-hero.md — 웹 헤로 / 랜딩 페이지 / 앱 배너 (가로 구도 + CTA)
• editorial-cover.md — 잡지 / 간행물 / 출판물 표지
• biomimetic-concept-poster.md — 생체 모방 산업 디자인 컨셉 포스터 (자연 원형 → 진화 바 → 히어로 렌더링 → 다중 뷰 기술 도면)
• vintage-editorial-infographic.md — 빈티지 아카이브 / 1940년대 편집형 인포그래픽 포스터 (인물 + 공식 + 타임라인 + 모형, Bell Labs 스타일)
• character-catalog-poster.md — 동일 캐릭터의 다양한 버전 인포그래픽 포스터 (별자리 / 원소 / 왕조 / 성격 시리즈 카드)
• lineup-comparison-poster.md — 제품 라인업 비교 인포그래픽 포스터 (30개 이상의 SKU를 한 장에 + 범례 + 등급 키)

7. 인물 및 캐릭터 ( references/portraits-and-characters/ )

“인물 비주얼”에 적합합니다. 현재 구현된 사례:

• professional-portrait.md — 전문가급 비즈니스 초상화 (LinkedIn / 팀 페이지 / 미디어 삽화)
• founder-portrait.md — 창업자 미디어용 화보 (연극 조명 + 제목 삽입 공간)
• virtual-host.md — VTuber / 가상 방송인 프로필 카드 + 생방송 미리보기
• character-sheet.md — 캐릭터 종합 설정 자료 (3면도 + 표정 + 의상 + 컬러 팔레트)
• pose-reference-sheet.md — N×N 포즈 / 동작 사전 참조표 (동일 캐릭터의 다양한 포즈, 댄스 / 전투 / 피트니스)

8. 장면 및 일러스트 ( references/scenes-and-illustrations/ )

“분위기 + 스토리 + 감정”에 어울리는 일러스트형 비주얼. 현재 구현된 내용:

• healing-scene.md — 힐링 계열의 일상 / 계절 장면 일러스트
• concept-scene.md — 영화 같은 콘셉트의 대규모 장면 / IP 키 아트
• picture-book-scene.md — 동화책 / 그림책 내지 / 명절 카드
• minimalist-mood-scene.md — 미니멀한 여백이 돋보이는 분위기 이미지 / 문학적인 배경화면

9. 편집 워크플로우 ( references/editing-workflows/ )

“기존 이미지를 기반으로 편집”하는 작업에 적합한 이미지 수정 작업 ( scripts/edit.js에 해당). 현재 구현된 항목:

• background-replacement.md — 배경 교체 (상품 / 인물 / 야외 / 스튜디오 배경)
• local-object-replacement.md — 부분 객체 교체 (마스크 사용 또는 미사용)
• object-removal.md — 잡물 / 행인 / 전선 / 결함 제거
• product-retouching.md — 제품 보정 (광택 / 라벨 / 그림자 / 결함)
• portrait-local-edit.md — 인물 부분 수정 (헤어스타일 / 의상 / 메이크업 / 액세서리)

10. 아바타 및 프로필 ( references/avatars-and-profile/ )

“스타일화된 아바타 / 캐릭터 설정 / 그리드 / 스티커 / 시리즈 초상화” 등 “개인 이미지” 유형의 시각 자료에 적합합니다. 현재 구현된 내용:

• style-transfer-selfie.md — 참조 이미지의 인물을 코스프레 / 고딕 / 복고 필름 / 아이돌 화보 등 원하는 스타일로 변환
• character-grid-portrait.md — 동일 캐릭터의 n×n 그리드 초상화 (다양한 직업 / 표정 / 시대 / 스타일)
• themed-3d-icon.md — 카와이 3D / 마인크래프트 / 스카리피즘 3D 앱 아이콘 스타일의 아바타
• sticker-set.md — 스티커 세트 / 이모지 모음집 (개별 요소 + 윤곽선 + 태그)
• cultural-portrait-series.md — 왕조 / 신화 / 문학 / 민족 시리즈 초상화

11. 스토리보드 및 시퀀스 ( references/storyboards-and-sequences/ )

“다중 컷 / 만화 / 관계도 / 진행 단계” 등 “서사적 시퀀스” 유형의 시각 자료에 적합합니다. 현재 구현된 항목:

• four-panel-comic.md — 4컷 만화 / 풍자 만화 / 개그 만화 (서론·본론·전환·결론 + 대화 풍선)
• manga-spread-page.md — 1페이지 / 양면 만화 분컷 (불규칙한 칸 + 대화 + 내레이션)
• anime-key-visual.md — 단일 이미지 애니메이션 키 비주얼 / 라이트 노벨 표지 / IP 포스터
• character-relationship-diagram.md — 캐릭터 관계도 포스터 (카드 + 관계선 + 범례)
• recipe-process-flowchart.md — 레시피 / 튜토리얼 / 절차 흐름도 (번호 + 삽화 + 설명)
• product-tvc-storyboard.md — 제품 TVC 광고 스토리보드 (9-panel 실사 느낌 + 샷 설명 + 재생 시간)
• cinematic-storyboard-grid.md — 영화적 서사 스토리보드 콘택트 시트 (3×4 / 4×4, 연속 서사 + 시네마틱 스틸)
• process-photo-board.md — 실사 시네마틱 프로세스 보드 (장비 착용 / 메이크업 / 훈련 / 동작 분해, 번호 + 단계별 진행)

12. 그리드 및 콜라주 ( references/grids-and-collages/ )

“다중 패널 그리드 / 콜라주 / 프로젝트 기획 보드” 유형의 비주얼에 적합합니다. 현재 구현된 예시:

• banner-grid-2x2.md — 2×2 마케팅 배너 세트 (한 번에 4장의 통일된 시리즈 디자인 출력)
• lookbook-grid.md — 7일 룩북 / 9칸 셀프케어 / TOP N 리스트 이미지
• mixed-style-multi-panel.md — 다양한 스타일 혼합 콜라주 (동일한 주제를 서로 다른 화풍으로 표현)
• anime-pitch-board.md — 애니메이션 / 게임 / 영화·드라마 기획 피치 보드 (KV + 캐릭터 + 세계관 + 카피)
• ad-banner-multi-grid.md — 다중 산업 / 다중 주제 혼합 광고 배너 그리드 (각 칸마다 독립된 산업 + 스타일 + 카피)

13. 브랜딩 및 패키징 ( references/branding-and-packaging/ )

“브랜드 아이덴티티 시스템 / 마스코트 / 패키징 디자인” 유형의 비주얼에 적합합니다. 현재 구현된 사례:

• brand-identity-board.md — 브랜드 아이덴티티 보드 (로고 + 색상 구성 + 서체 + 적용 모형)
• mascot-brand-kit.md — 마스코트 다중 패널 브랜드 아이덴티티 키트 (메인 이미지 + 3면도 + 표정 + 적용 예시)
• cosmetic-packaging.md — 화장품 / 스킨케어 제품 단일 용기 / 시리즈 / 선물 세트 포장
• beverage-label-design.md — 음료 / 식품 / 조미료 라벨 디자인 (중국 트렌드 / 일본식 / 서양식)
• full-mascot-brand-doc.md — 18개 이상의 모듈로 구성된 대규모 브랜드 아이덴티티 + 마스코트 전체 프로세스 문서 (DNA / 무드보드 / 스케치 / 선화 / 3D / 색상 조합 / 질감 / 적용 사례 한눈에 보기)
• character-merch-board.md — IP 캐릭터 + 굿즈 / 포장 / 포스터 / 소셜 미디어 프로필 등 다중 요소 통합 브랜드 보드

14. 타이포그래피 및 텍스트 레이아웃 ( references/typography-and-text-layout/ )

“글자 우선 / 이중 언어 레이아웃” 등 “텍스트를 주 시각 요소로 하는” 유형에 적합합니다. 현재 적용된 사례:

• title-safe-poster.md — 대형 텍스트 중심 포스터 (일본식 고에너지 / 스위스 미니멀리즘 / 복고풍 인쇄)
• bilingual-layout-visual.md — 중영 / 중일 이중 언어 레이아웃 비주얼 (문화 / 학술 / 다문화 브랜드)

15. 자산 및 소품 ( references/assets-and-props/ )

“아이콘 세트 / 게임 스크린샷” 등 “세트형 소재 / 게임 자산” 유형의 비주얼에 적합합니다. 현재 구현된 사례:

• retro-skeuomorphic-icons.md — 스큐모픽 / Y2K / 픽셀 아이콘 세트 (일관된 스타일의 세트)
• game-screenshot-mockup.md — 게임 내 스크린샷 모크업 (HUD + 자막 + 퀘스트 패널)

16. 학술용 그림 ( references/academic-figures/ )

“논문 / 주요 학술대회 투고 / 학술 포스터 / 학위 논문 발표 PPT / 연구 계획서 발표 / 학술지 투고용 그래픽 초록”에 적합한 삽화.전체적으로 흰색 바탕 + 학술지용 서체 + 기하학적 정밀도 + 채도가 낮은 엔지니어링 색상(진한 파랑 / 회색빛 파랑 / 검은 회색 위주, 주색 ≤3가지) + 단색 인쇄 가능. 허위 정량 데이터 (수치 / 등고선 / 색상 범주 / 수식) 사용을 엄격히 금지합니다.

CS / CV / ML 분야:

• method-pipeline-overview.md — 방법 개요도 / 파이프라인 그림(다단계 블록 + 데이터 흐름; 변형 4에서는 공학적인 좌/중/우 3단식 기술 로드맵 제공)
• neural-network-architecture.md — 신경망 아키텍처 다이어그램 (레이어 블록 + 텐서 모양 + 점프 연결)
• qualitative-comparison-grid.md — 다중 방법 정성적 비교 표 ( 행 = 샘플, 열 = 방법 )

공학 / 자연과학 / 논문 발표 공통:

• scientific-schematic.md — 개념 / 원리 / 실험 장치 개략도 (자유도가 높음, 자연어 템플릿)
• mechanism-diagram.md — 기전 도식도 / 인과 관계 / 전환 경로 (중심 대상 + 다단계 전환 + 결과 영역; 3단계 인과 관계 / 순환적 자가 자극 / 다분지 경쟁 세 가지 변형 포함)
• multi-condition-comparison.md — 다중 작동 조건 / 다중 조건 결과 비교도 (동일한 대상의 서로 다른 조건 하에서의 병렬 결과, 2×2 / 1×N / M×N; 패널 간의 엄격한 통일성 강조)
• publication-chart.md — 출판용 데이터 차트 (막대 / 선 / 산점도 / 히트맵 / 박스)

개요 / 초록 / 논문 발표 첫 페이지:

• graphical-abstract.md — 학술지 투고용 그래픽 초록 (가로 4단 구성 / 중앙 전개 / 정사각형 / 세로형 4가지 변형)
• research-overview-poster.md — 연구 계획서 / 논문 심사 / 연구 보고 첫 페이지 연구 개요도 (상·중·하 3단 + 5개 모듈; 중심 방사형 / 좌우 2단 / 미니멀 스타일의 세 가지 변형 포함)

선택 전략: CS/CV/ML 논문은 method-pipeline-overview + qualitative-comparison-grid를 우선 선택; 공학 / 에너지 / 화학 공학 / 재료 분야는 method-pipeline-overview 변형 4 + mechanism-diagram + multi-condition-comparison을 우선 선택;투고 저널 초록 그림에는 graphical-abstract를 사용; 논문 발표 PPT 첫 페이지에는 research-overview-poster를 사용.

17. 인포그래픽 ( references/infographics/ )

“인포그래픽 / 고밀도 대중 과학 설명 / 손그림 인포그래픽 / KPI 대시보드” 등 “정보 시각화 대형 그림”에 적합합니다. 현재 구현된 예시:

• legend-heavy-infographic.md — 범례 밀도가 높은 과학 대중화 / 인과 관계도 / 진화도 / 해부도 (이중 언어)
• hand-drawn-infographic.md — 손그림 스타일 인포그래픽 (마카롱 / 모란디 / 칠판 / 크라프트지; 자연어 템플릿)
• bento-grid-infographic.md — 벤토 그리드 모듈형 인포그래픽 (고밀도 다중 모듈 위젯 배열)
• comparison-infographic.md — 이원/다원 비교 인포그래픽 (A 대 B / 요금제 등급 / 오해 대 정답)
• step-by-step-infographic.md — 단계별 튜토리얼 인포그래픽 (일러스트 느낌, 따뜻한 분위기; 비엔지니어링 흐름도)
• kpi-dashboard-infographic.md — KPI 대시보드형 인포그래픽 (연도별 회고 / Wrapped / 비즈니스 대시보드)

18. 기술 다이어그램 ( references/technical-diagrams/ )

“시스템 아키텍처 / 프로세스 / 시퀀스 / 상태 기계 / ER / 마인드맵 / 네트워크 토폴로지” 등의 엔지니어링 다이어그램에 적합합니다. 통일된 어두운 색상의 그리드 배경 + 고정폭 폰트 + 역할별 색상 코딩을 적용했으며, 각 템플릿에는 밝은 색상(light) 변형도 포함되어 있습니다.

⚠️ 주의: 이 디렉토리에서 생성되는 파일은 편집 가능한 SVG가 아닌 PNG 비트맵입니다. 편집이 필요하시면 mermaid / draw.io / excalidraw / Figma를 사용해 주세요. 현재 구현된 항목:

• system-architecture.md — 시스템 아키텍처 다이어그램 (프론트엔드 + 백엔드 + DB + 캐시 + 큐 + 외부)
• flowchart-decision.md — 흐름도 / 의사결정도 (BPMN 도형 의미 + Yes/No 분기)
• sequence-diagram.md — 시퀀스 다이어그램 (액터 + 라이프라인 + 메시지 화살표 + 활성화 바)
• state-machine.md — 상태 기계 / 라이프사이클 다이어그램 (state + transition + guard / action)
• er-diagram.md — ER 다이어그램 / 데이터 모델 다이어그램 (엔티티 + 필드 + PK/FK + 크로우스 풋 관계)
• mind-map-tech.md — 기술 주제 마인드맵 (중심 + 방사형 분기)
• network-topology.md — 네트워크 토폴로지 다이어그램 (장치 글리프 + 존 / VPC + 대역폭 / 프로토콜 표기)

프롬프트 워크플로우 (패턴 인식)

A / B / C에 상관없이, 처음 6단계는 공통이며, 차이점은 7~8단계에서 어떻게 "도표를 생성"하느냐에 있습니다.

1. check-mode.js를 실행하여 모드 (A / B / C) 를 확인합니다.
2. 작업이 그림 생성이냐 수정하느냐를 판단합니다.
3. 해당 작업이 어느 분류 디렉터리에 속하는지 식별합니다(아래 “템플릿 색인” 참조).
4. 해당하는 구체적인 템플릿 파일만 읽어들여야 하며, references/ 디렉토리 전체를 한 번에 읽어들이지 마십시오.
5. 템플릿 형식을 엄격히 준수합니다: 대부분의 템플릿은 JSON 메인 템플릿을 사용하며(구조화된 작업에 우선적으로 사용됨), 소수의 템플릿( infographics/hand-drawn-infographic.md, academic-figures/scientific-schematic.md 등)은 '구조화된 자연어 + 매개변수' 혼합 형식을 사용합니다. 이는 JSON을 강제로 적용할 경우 창작의 자유가 제한되기 때문입니다.
6. 사용자 입력을 템플릿 매개변수에 매핑하십시오. 핵심 정보가 부족할 경우, 적극적으로 구체적인 확인 질문을 던지십시오.

이 단계까지 진행하면 프롬프트가 렌더링된 것입니다. 이제 패턴에 따라 분기합니다:

7-A. 모드 A: 최종 프롬프트를 garden- gpt-image-2 /prompt/에 저장하고 , scripts/generate.js 또는 scripts/edit.js를 호출하면 이미지가 garden- gpt-image-2/image/에 저장됩니다. 7-B. 모드 B: 최종 프롬프트를 호스트의 이미지 도구에 직접 전달하여 호출합니다;필요에 따라 프롬프트 사본을 garden- gpt-image-2/prompt/에 저장합니다. 7-C. 모드 C: 최종 프롬프트를 garden- gpt-image-2/prompt/에 저장하고, - .md에 저장하며, 대화창에 전체 프롬프트를 사용자에게 표시하고, 간단한 “사용 방법 / 추천 도구” 조언을 덧붙입니다.

8. 작업이 끝나면 사용자에게 한 문장으로 현재 모드가 무엇인지, 프롬프트가 어디에 저장되었는지, 이미지(있는 경우)가 어디에 저장되었는지 알려줍니다.

중요 제약 조건

일반 사항:

• 템플릿 파일의 JSON은 프롬프트 구조 템플릿이며, API 요청 본문 템플릿이 아닙니다.
• 세 가지 모드 모두에서, 최종적으로 이미지 모델에 전달되는 것은 "렌더링된 프롬프트 문자열"입니다. 이는 평평하게 변환된 JSON일 수도 있고, 구조화된 자연어 문단일 수도 있으며, 템플릿 그대로 사용해야 합니다.
• 사용자가 명시적으로 요청하지 않는 한, SKILL.md에 있는 “모드 설명”을 최종 프롬프트에 복사하지 마십시오. 이는 에이전트가 볼 수 있도록 제공된 메타정보입니다.

Mode A에만 적용:

• 생성 스크립트에서 JSON 본문 사용
• 편집 스크립트는 multipart form data를 사용합니다
• 응답은 우선 data[0].b64_json 으로 파싱되며, data[0].url도 호환됩니다
• 상위 인터페이스에서 명시적으로 요구하지 않는 한, 별도의 특수 쿼리 매개변수를 추가하지 마십시오

질문해야 할 때

다음 정보 중 누락된 부분이 있어 결과에 중대한 영향을 미칠 경우에만 질문하십시오:

• 프롬프트 목표가 없을 때
• 이미지를 수정할 때 원본 이미지가 없을 때
• 주제의 정체성이나 시각적 유형이 결과의 방향을 결정하는 경우
• 상품 / 가격 / 카피 / UI 텍스트가 화면의 핵심 구성 요소인 경우
• 사용자가 서로 상충되는 여러 목표를 동시에 표현한 경우

이 외의 경우에는 스스로 합리적인 기본값을 설정하고 이를 계속 적용합니다.