Slide Renderer

Slide Renderer

Gemini API를 사용하여 프롬프트 파일(.md)을 4K 16:9 PNG 이미지로 변환하는 스크립트 실행 가이드.

스크립트 참조 및 실행 (CRITICAL)

스크립트는 이 스킬의 상대경로에 위치합니다:

scripts/generate_slide_images.py

실행 순서:

Step 1. 상대경로로 실행 (최우선)

python scripts/generate_slide_images.py \
  --prompts-dir [프롬프트 폴더 경로] \
  --output-dir [이미지 출력 폴더 경로]

Step 2. 상대경로 실패 시 Glob 폴백

Glob: **/visual-generator/skills/slide-renderer/scripts/generate_slide_images.py

Step 3. Glob도 실패 시 확장 탐색

Glob: **/generate_slide_images.py

절대 금지: 스크립트를 찾지 못했을 때 자체적으로 Python 코드를 작성하지 마세요. 반드시 에러를 보고하고 사용자에게 경로 확인을 요청하세요.

환경 요구사항

스크립트 출력 해석

에러 처리

에러 유형별 처리

재시도 로직

실패 발생
  → 재시도 가능 여부 판단 (현재 시도 < 3)
    → YES: 5초 대기 → 해당 프롬프트만 재실행 (기존 성공 파일은 자동 스킵)
    → NO: 최종 실패 목록에 추가, 사유 기록

Quality Evaluation Criteria

이미지 생성 후 5차원 품질 평가를 실시한다. 각 차원은 0-10점으로 평가된다.

5-Dimension Evaluation System

Tiered Evaluation Logic

PASS 조건: 전체 평균 ≥ 7.0 AND korean_text_readability ≥ 5.0 (veto) AND korean_hallucination_detection ≥ 5.0 (veto)

veto 방식: 한글 차원 중 하나라도 5.0 미만이면 전체 평균과 무관하게 자동 FAIL.

concept 테마 면제

concept 테마는 텍스트 항목이 없으므로 한글 평가 차원을 자동으로 10.0으로 설정한다. 프롬프트에 "concept", "zero text rendering", 또는 "zero-text rendering"이 포함되면 면제 적용.

Korean Text Safety

generate_slide_images.py는 3중 방어 체계의 inference 계층을 담당한다.

SYSTEM_INSTRUCTION Anti-Hallucination

스크립트의 SYSTEM_INSTRUCTION에 Korean Text Hallucination Prevention 지시가 포함된다: 빈 공간에 임의 한글 생성 금지, 모든 한글은 CONTENT 섹션 텍스트에만 대응, 빈 영역에는 플랫 아이콘/아이소메트릭 일러스트/장식 요소 배치 지시.

3-Layer Defense Architecture

자세한 규칙은 plugins/visual-generator/agents/prompt-designer.md → ## Korean Text Safety Rules 참조. 빈 공간 처리 가이드는 references/scene-richness-spec.md → ## 11. Space-Filling Prevention 참조.

OpenAI gpt-image-2 Rendering Path

gpt-image-2 API를 사용하여 슬라이드 프롬프트 파일(.md)을 4K(3840x2160) PNG 이미지로 변환하는 스크립트 실행 가이드. --size 플래그로 다른 해상도 지정 가능 (제약: 양변 16배수, max edge 3840px, total pixels ≤ 8,294,400).

스크립트 참조 및 실행 (CRITICAL)

스크립트는 이 스킬의 상대경로에 위치합니다:

scripts/generate_slide_images_openai.py

실행 순서:

Step 1. 상대경로로 실행 (최우선)

python scripts/generate_slide_images_openai.py \
  --prompts-dir [프롬프트 폴더 경로] \
  --output-dir [이미지 출력 폴더 경로] \
  [--size 3840x2160] [--quality high] [--model gpt-image-2] [--eval-model gpt-5.6]
  [--max-images N] [--yes]

Step 2. 상대경로 실패 시 Glob 폴백

Glob: **/visual-generator/skills/slide-renderer/scripts/generate_slide_images_openai.py

Step 3. Glob도 실패 시 확장 탐색

Glob: **/generate_slide_images_openai.py

절대 금지: 스크립트를 찾지 못했을 때 자체적으로 Python 코드를 작성하지 마세요.

환경 요구사항

CLI

python scripts/generate_slide_images_openai.py \
  --prompts-dir [경로] \
  --output-dir [경로] \
  [--size 3840x2160]      # 기본 4K, gpt-image-2 제약 내에서 자유 지정
  [--quality high]        # low|medium|high|auto
  [--model gpt-image-2]   # 생성 모델
  [--eval-model gpt-5.6]  # 평가 모델 (런타임 fallback: gpt-5.6 → gpt-5.6-terra → gpt-5.6-luna)
  [--max-images N]        # 기본 30, 초과 시 확인 필요
  [--yes]                 # 확인 없이 자동 진행

비용

비용은 OpenAI 콘솔(https://platform.openai.com/usage)에서 확인하세요.

--max-images (기본 30): sanity cap. 초과 시 사용자 확인 또는 --yes 필요.

API 사전 체크

• Organization Verification: gpt-image-2 사용 시 OpenAI Organization 검증 필요 (developer console → Usage → Verification)
• 403 에러: 조직 미검증 상태 → 검증 페이지 안내 후 중단

에러 처리

5D 품질 평가

5D 평가 기준 및 Schema → references/openai-quality-rubric.md 참조. PASS: overall_score ≥ 7.0 AND korean_text_readability ≥ 5.0 AND korean_hallucination_detection ≥ 5.0