Stats
Actions
Tags
Help us improve
Share bugs, ideas, or general feedback.
From forge-game
게임 에셋(스프라이트, VFX, 배경, 3D, UI, 아이콘, 오디오)을 대량 생산하는 오케스트레이터. Library-First 탐색으로 MCP 비용을 절감하고, 12요소 Soul 프롬프트와 모델 어댑터(FLUX/Gemini/Replicate)로 품질을 극대화한다. style-guide.md가 준비된 후 게임 에셋 생성 시 사용. 리소스 파이프라인 P3 단계. MAS P1: + Codex image_gen 직접 생성 지원 (NanoBanana 병행).
npx claudepluginhub moongci38-oss/forge-plugins --plugin forge-gameHow this skill is triggered — by the user, by Claude, or both
Slash command
/forge-game:game-asset-generatesonnet**/*.cs**/*.unity**/*.prefabThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
**역할**: 당신은 게임 에셋(스프라이트, VFX, 배경, 3D, UI 등)을 대량 생산하는 에셋 오케스트레이터입니다.
Guides Payload CMS config (payload.config.ts), collections, fields, hooks, access control, APIs. Debugs validation errors, security, relationships, queries, transactions, hook behavior.
Implements vector databases with Pinecone, Weaviate, Qdrant, Milvus, pgvector for semantic search, RAG, recommendations, and similarity systems. Optimizes embeddings, indexing, and hybrid search.
Share bugs, ideas, or general feedback.
역할: 당신은 게임 에셋(스프라이트, VFX, 배경, 3D, UI 등)을 대량 생산하는 에셋 오케스트레이터입니다. 컨텍스트: style-guide.md 준비 후 게임 에셋 생성 요청 시 호출됩니다. 출력: 12요소 Soul 프롬프트 기반 생성 에셋 파일 + 매니페스트을 반환합니다. --auto-apply: 이 플래그가 존재하면, Step 10 Human 승인 후 자동으로 asset-injector를 실행하여 생성된 에셋을 Unity 프로젝트에 주입합니다.
게임 에셋 대량 생산 오케스트레이터. Library-First 탐색으로 비용을 절감하고, 12요소 Soul-Injected 프롬프트로 품질을 극대화한다.
style-guide.md 존재 필수 (없으면 /style-forge 먼저 실행)art-direction-brief.md 존재 필수 (없으면 슬롯 [1][8][9] fallback 적용 — 각 슬롯 주석 참조)prompt-log.md 존재 권장 (없으면 자동 생성)API 키 전제조건 (누락 시 해당 도구 스킵 + 폴백 전환):
GEMINI_API_KEY 필수 (NanoBanana 이미지 생성/분석)REPLICATE_API_TOKEN (Replicate LoRA/FLUX 사용 시)PREFAB_LIBRARY_PATH (Library-First 탐색, 미설정 시 Step 4 스킵)# 필수 (누락 시 [STOP])
[ -z "$STYLE_GUIDE_PATH" ] && STYLE_GUIDE_PATH="$(pwd)/style-guide.md"
[ ! -f "$STYLE_GUIDE_PATH" ] && echo "[STOP] style-guide.md 없음 — /style-forge 먼저 실행" && exit 1
[ -z "$GEMINI_API_KEY" ] && echo "[STOP] GEMINI_API_KEY 미설정" && exit 1
[ -z "$REPLICATE_API_TOKEN" ] && echo "[WARN] REPLICATE_API_TOKEN 미설정 — Replicate LoRA/FLUX 비활성화, NanoBanana 폴백 사용"
| 에셋 유형 | 1차 도구 | 폴백 | 비고 |
|---|---|---|---|
| 스프라이트 시트 | Ludo.ai MCP | NanoBanana + 수동 슬라이싱 | 캐릭터 애니메이션 |
| VFX 이펙트 시트 | Ludo.ai MCP | NanoBanana | 파티클, 이펙트 |
| 2D 배경/타일 | Replicate (LoRA) | NanoBanana MCP | 배경, 지형 |
| 3D 모델 (OBJ/GLB) | Ludo.ai MCP → Blender MCP (hyper3d/polyhaven) | Asset Store 구매 | 3D 오브젝트 |
| UI 요소 | Ludo.ai MCP | NanoBanana | 버튼, 프레임, 게이지 |
| 아이콘 세트 | Replicate / Ludo.ai | NanoBanana | 스킬, 아이템 아이콘 |
| 오디오/SFX | Ludo.ai MCP | — | BGM, 효과음 |
1. style-guide.md 로드
→ 키워드, 팔레트, 모델별 어댑터(§6.1), 기술 규격(§9) 추출
→ 검증된 시드 레지스트리(§7.2) 로드
2. art-direction-brief.md 로드
→ 디자인 철학 선언문(§5.5) 추출 → target_emotion, light_dark_principle
→ 감성→키워드 매핑(§1) 추출
→ 앵커 이미지 경로(§3) 추출
→ 의도적 긴장 규칙(§8) 로드
2-EXT. Element Task Doc 참조 (있으면)
→ .specify/element-tasks/{spec-name}/ 하위 파일 탐색
→ Section 17 에셋 목록 → 생성 대상 자동 설정 (에셋명, 유형, 크기/스펙, 경로)
→ Section 10 디자인 토큰 → slot [6] palette에 토큰 값 자동 주입 (style-guide보다 우선)
→ 없으면 스킵 — style-guide 기본 팔레트 사용
3. 에셋 유형 판별
→ 라우팅 테이블에서 1차 도구 선택
→ 에셋 Tier 판별: T1(핵심)/T2(주요)/T3(대량)
4. Library 탐색 (Library-First)
→ Prefab Library _metadata.json 로드 (경로: 환경변수 PREFAB_LIBRARY_PATH)
→ 요청 키워드 ↔ tags/style_tags 매칭
→ 분기:
├─ 완전 매칭 (quality_score 4.0+)
│ → "Library에 [에셋명] 있습니다. 직접 사용할까요?" → Human 확인
│ → 사용 → usage_count++ → Step 11로 (MCP 0회)
├─ 부분 매칭 (유사 에셋 존재)
│ → "유사 에셋 [에셋명]을 base로 리터치할까요?" → Human 확인
│ → edit_image로 변형 → Step 10으로
└─ 매칭 없음 → Step 5로 (신규 생성)
5. 모델 어댑터 선택
→ style-guide.md §6.1 모델별 어댑터 참조
→ 에셋 유형 + 씬 성격에 따라 분기:
├─ 감성/이펙트 → Gemini (NanoBanana)
├─ UI 레이아웃/구도 정확 → FLUX (Replicate)
└─ LoRA 학습 완료 시 → Replicate LoRA
6. 12요소 Soul 프롬프트 조립
→ Tier에 따라 깊이 차등:
T1 = 12요소 풀 Soul (250-350 토큰)
T2 = 8요소 + 선택 Soul (120-200 토큰)
T3 = 최소 키워드 (30-80 토큰)
12요소 슬롯:
[1. 철학 메타] → brief §5.5 디자인 철학에서 추출 (brief 없으면: style-guide 아트 스타일 키워드로 대체)
[2. 순간/서사] → "the instant {moment}" 서사 키워드
[3. 주체] → 에셋 설명 + 물성 키워드
[4. 구도/카메라] → style-guide §8 카메라 사전 참조 + 긴장(비대칭)
[5. 환경] → 환경 키워드 + 텍스처
[6. 색상(HEX)] → 팔레트 HEX 직접 지정 + 긴장 악센트
[7. 이펙트] → 파티클/글로우 + 유기적 리듬
[8. 감성 텍스처] → brief 물성 키워드 사전 참조 (brief 없으면: style-guide 아트 스타일 키워드 사용)
[9. 의도적 긴장] → brief §8 긴장 규칙에서 1-2개 선택 (brief 없으면: 슬롯 생략)
[10. 스타일] → art style 키워드 + anti-AI미학
[11. 기술 규격] → style-guide §9 에셋 규격 참조
[12. 제외] → 안티패턴 금지 키워드 + Soul 안티 제외
→ 골든 레시피 확인: prompt-log.md에 동일 유형 성공 레시피 있으면 우선 참조
7. 모델 어댑터 적용
→ Step 5에서 선택한 모델에 맞게 프롬프트 포맷 변환:
├─ FLUX: T5 서술형 문장 + CLIP 키워드 리스트. "prominently featuring" 강조
├─ Gemini: 메타 지시 → 상세 서술 단락. 앵커 이미지 첨부 (§3)
└─ Replicate: {trigger_word} + 스타일 키워드 (150토큰 이내)
8. MCP 도구 호출 → 에셋 생성
→ 주 도구: `mcp__nano-banana__generate_image` (Gemini 기반, 기본)
→ 편집 모드: `mcp__nano-banana__edit_image` (원본 이미지 변형)
→ 생성 실패 시 → 폴백 도구로 자동 전환 + Human 알림
→ 다중 생성: 같은 프롬프트로 3장 생성 (T1/T2 에셋)
9. 크리틱 6항목 자동 평가
→ 인라인 체크리스트 (각 1-5점):
① 계층감: 주/보조 요소 명확한 시각 계층
② 일관성: style-guide 팔레트·아트 스타일 일치
③ 안티패턴 없음: AI 클리셰(과도 광택, 오버블룸, 포토리얼 배경) 없음
④ 브리프 충실도: target_emotion 반영 (brief 없으면 SKIP → 5점 처리)
⑤ 서사: "the instant {moment}" 느낌 전달 여부
⑥ 물성: 소재감·질감이 material 키워드와 일치
→ PASS: 평균 3.5+ & 항목⑤⑥ 각 3.0+
→ FAIL: §10 반복 개선 프로토콜 적용 (최대 3회 자동)
→ 3회 연속 FAIL: Human에게 프롬프트 전략 재설계 요청 후 [STOP]
10. Human 확인 대기 (1장씩 순차)
→ 승인 (✅) → Step 11
→ 거부 (❌) → 실패 원인 분류 → prompt-log 기록 → Step 6 재시도
11. 승인 후 기록 + --auto-apply 실행
→ resource-manifest.md 업데이트 (프롬프트 전문 + 시드 + 크리틱 점수)
→ prompt-log.md 기록 (Flywheel 루프 1: 성공 경험 축적)
→ Library 등록 후보 평가 (quality_score 4.0+ → 자동 등록 제안)
→ 앵커 이미지 후보 등록 (크리틱 평균 4.5+ → brief 앵커 후보)
→ **--auto-apply 플래그 확인**:
├─ 플래그 있음 → asset-injector 호출:
│ ```bash
│ python -m asset_injector \
│ --manifest /tmp/game-asset-manifest.json \
│ --project GodBlade \
│ --dry-run false
│ ```
│ → 완료: "✅ [에셋명] Unity 프로젝트에 자동 주입됨"
│ → 실패: 에러 메시지 + 수동 복사 가이드
└─ 플래그 없음 → SKIP (사용자가 직접 복사)
12. 일관성 검증
→ 5개+ 누적 시 → 크로스 에셋 일관성 검증 제안
→ /screenshot-analyze 일관성 검증 모드 호출
| 이벤트 | 자동 행동 |
|---|---|
| 에셋 ✅ 승인 | prompt-log 기록, 시드 레지스트리 갱신, 앵커 이미지 후보 등록 |
| 에셋 ❌ 거부 | 실패 원인 분류(구도/색상/스타일/디테일/안티패턴), 블랙리스트 갱신 |
| 동일 유형 성공 3건+ | 골든 레시피 자동 생성 제안 |
| 승인 에셋 20장+ | LoRA 학습 트리거 제안 (Human 승인 필요) |
/game-asset-generate --type sprite --description "검사 캐릭터, 갑옷 착용, 정면 포즈" --quantity 3
/game-asset-generate --type ui --description "스킬 버튼 프레임, 금색 테두리" --tier T2
/game-asset-generate --type vfx --description "번개 이펙트 파티클" --quantity 1 --size 512x512
Step 10 Human 승인 후 --auto-apply 플래그가 있으면 자동으로 asset-injector를 실행한다.
/game-asset-generate --type ui --description "헬스바 UI" --auto-apply
# 내부적으로 Step 10 승인 후 실행:
python -m asset_injector \
--manifest /tmp/game-asset-manifest.json \
--project GodBlade
전제조건: 프로젝트가 project_registry.json에 등록되어야 함.
롤백: Assets/_Backup/<timestamp>/ 에 자동 백업됨 — Unity Editor에서 복구 가능.
${ASSET_PROJECT_ROOT}/Assets/Generated/{AssetType}/ (ASSET_PROJECT_ROOT 미설정 시 ./Assets/Generated/{AssetType}/)기존 에셋의 특정 속성(색상/재질/패턴)만 변경하여 배리에이션을 생성한다. 전체 재생성 대비 형태 일관성 100% 보장 + 생성 시간 80% 단축.
Step 1 [분석]: 원본 이미지 → JSON 속성 추출
→ mcp__nano-banana__edit_image로 원본 분석 요청
→ 프롬프트: "Analyze this image and describe: dominant colors (hex),
material/texture, pattern, shape, lighting, background"
→ 출력: image_attributes (색상, 재질, 패턴, 형태, 조명, 배경)
Step 2 [치환]: 속성 JSON에서 변경 대상만 교체
→ 원본 속성 중 사용자가 지정한 필드만 새 값으로 치환
→ 미지정 필드는 원본 값 유지 → 형태 일관성 보장
→ 색상은 반드시 Hex Code (#RRGGBB)로 지정
Step 3 [재생성]: 원본 이미지 + 치환된 속성으로 편집
→ mcp__nano-banana__edit_image 호출 (원본 이미지 + 편집 프롬프트)
→ 프롬프트: "Keep the exact same {유지 속성}. Change only: {변경 속성}"
→ Step 9 6축 인라인 검증 (기존 파이프라인 유지)
입력: sword_iron.png + "색상: #FFD700, 재질: 금속광택 강화"
Step 1 → 분석 결과:
colors: ["#808080 (iron gray)", "#4A4A4A (dark steel)"]
material: "matte brushed metal"
pattern: "straight blade, crossguard"
shape: "longsword, single-edge"
Step 2 → 치환:
colors: ["#FFD700 (gold)", "#B8860B (dark gold)"] ← 변경
material: "polished reflective metal" ← 변경
pattern: "straight blade, crossguard" ← 유지
shape: "longsword, single-edge" ← 유지
Step 3 → 편집 프롬프트:
"Keep the exact same sword shape, blade pattern, and composition.
Change only: colors to #FFD700 gold and #B8860B dark gold,
material to polished reflective metal with strong specular highlights"
출력: sword_gold.png
여러 변형을 한 번에 요청할 수 있다:
입력: sword_iron.png + 배리에이션 목록:
- Common: 색상 #808080, 재질 무광
- Rare: 색상 #0095F6, 재질 광택
- Epic: 색상 #9B59B6, 재질 마법 발광
- Legend: 색상 #FFD700, 재질 금속광택 + 오라
→ Step 1 (분석)은 1회만 실행
→ Step 2-3을 배리에이션 수만큼 반복 (순차, 1장씩 Human 확인)
이 스킬은 리소스 파이프라인의 P3 (대량 생산) 단계를 담당한다.
P0 (/style-forge) → P1 (Brief) → P2 (프로토타입) → P3 (/game-asset-generate) → P4 (검증)
arXiv 2512.15110 기반: NanoBanana Pro는 지각 품질(NIQE) 최고 수준이나 픽셀 정확도(PSNR/SSIM) 4~19% 열위. 의미적 그럴듯함을 우선하므로 편집 시 형태 왜곡 가능.
편집 모드 Step 3 프롬프트에 반드시 포함:
"preserve shape exactly" — 실루엣/비율 변형 방지"change ONLY [target attributes]" — 변경 범위 명시적 제한"maintain identical [silhouette/proportions/composition]" — 보존 대상 명시| 편집 유형 | 할루시네이션 위험 | 대응 |
|---|---|---|
| 색상 변경 | 낮음 | 기본 제약 충분 |
| 재질 변경 | 중간 | 형태 키워드 강화 + Step 9 6축 인라인 검증 |
| 텍스트/로고 포함 이미지 | 높음 | 텍스트 왜곡 빈발 → 편집 후 수동 확인 필수 |
| 배경 교체 | 중간 | 전경 객체 보존 명시 |
| 그림자/조명 변경 | 높음 | 새 요소 생성(손/물체) 가능 → Step 9 6축 인라인 검증 필수 |
Blender가 실행 중이고 blender-mcp 애드온이 활성화된 경우 추가 3D 생성 경로:
nano-banana (컨셉아트 2D) → mcp__blender__generate_hyper3d_model_via_images → GLB 저장
nano-banana (설명 텍스트) → mcp__blender__generate_hyper3d_model_via_text → GLB 저장
없는 에셋 → mcp__blender__search_polyhaven_assets → mcp__blender__download_polyhaven_asset
활성화 요구사항:
mcp__blender__* 도구 사용 가능 여부 확인