| name | commerce-detail-page-image |
| description | 한국 이커머스 상세페이지 13섹션 이미지를 자동 생성하고 1080×12720 단일 PNG로 합성하는 스킬입니다. "상세페이지 이미지 만들어줘", "13섹션 합성 이미지", "상폐 이미지", "1080 12720 합성"처럼 말하면 됩니다. commerce-detail-page-copy의 13섹션 카피와 사용자 상품 사진을 받아 섹션별 이미지 프롬프트를 작성하고, moai-media:media-higgsfield-image(Nano Banana Pro 등 11개 모델)로 13장의 이미지를 생성한 뒤 Pillow로 1080×12720 세로 합성 PNG를 직접 조립합니다(합성 로직은 이 문서에 인라인 코드로 포함). 외부 패키지는 Pillow 하나만 필요합니다.
|
| version | 1.1.0 |
상세페이지 이미지 합성 (Detail Page Image Composer)
개요
13섹션 감정여정 상세페이지 이미지를 생성하고 세로 합성 PNG로 만드는 스킬입니다.
moai-media:media-higgsfield-image를 백엔드로 사용하여 카테고리별 비주얼 톤이 일관된 13장의 섹션 이미지를 만들고,
Pillow 단일 의존성으로 1080×12720 단일 합성 이미지를 산출합니다.
트리거 키워드
상세페이지 이미지, 상폐 이미지, 13섹션 이미지, 1080 12720, 상세페이지 합성, 상품 상세 이미지,
combined.png, 상폐 합성본, 이커머스 이미지 합성
사전 조건
-
Pillow 설치: pip install Pillow 또는 uv pip install Pillow
- Python 3.10+ 환경
- 다른 의존성 없음 (NumPy 불필요)
-
moai-coworker 플러그인 활성화: 13섹션 이미지 생성에 media-higgsfield-image 사용
- 또는 사용자가 별도로 13장의 섹션 이미지를 준비해서 폴더 경로 제공
-
상품 사진 1-14장: 실제 상품 레퍼런스 (옵션이지만 권장)
워크플로우
1단계: 입력 수집
다음을 확보합니다:
- 13섹션 카피 JSON (
commerce-detail-page-copy 스킬 출력)
- 상품 사진 1-14장 경로
- 카테고리 (electronics/fashion/food/beauty/home/supplement/pet/kids/handmade/general)
- ProductDNA (선택,
commerce-product-photo-brief 스킬 출력)
- 출력 디렉토리 (기본:
./commerce-output/{job_id}/)
2단계: 13섹션 이미지 프롬프트 생성
각 섹션의 카피와 카테고리 비주얼 브리프를 합쳐 media-higgsfield-image 프롬프트를 작성합니다.
references/image-prompts.md 참조 (섹션별 비주얼 언어, 합성 가이드).
각 섹션은 고유한 비주얼 언어를 가집니다:
- Hero: cinematic_product_portrait — 풀블리드 + 드라마틱 림라이트
- Pain: emotional_photography_no_product — 어두운 톤, 상품 미노출
- Problem: clinical_infographic — 깔끔한 인포그래픽
- Story: editorial_split_before_after — Before/After 좌우 분할
- Solution: product_beauty_shot — 스튜디오 뷰티샷
- How: illustrated_step_sequence — 3단계 일러스트
- Proof: magazine_spread — 매거진 스프레드
- Authority: portrait_with_quote — 인물 포트레이트 + 인용
- Benefits: icon_grid_with_lifestyle — 아이콘 그리드 + 라이프스타일
- Risk: document_with_seal — 문서·인증 스타일
- Compare: split_screen_vs — 50/50 분할 비교
- Filter: checklist_visual — 체크리스트 시각화
- CTA: urgent_product_reveal — 긴급성 + 가격 강조
3단계: 이미지 생성 (moai-media:media-higgsfield-image)
생성 전략:
- 각 섹션 너비: 1080px
- 섹션별 높이:
references/sections-spec.md 표 참조 (Hero 1600-Filter 700)
- 카테고리 비주얼 브리프(electronics/fashion/...) 모든 프롬프트에 주입
- 상품 레퍼런스 사진을 media-higgsfield-image의 image-to-image 모드로 전달
생성 결과를 output_dir/{job_id}/sections/01_hero.png 부터 13_cta.png 까지 저장.
생성 실패 시: 해당 섹션은 다크 플레이스홀더(40,40,40)로 채워 합성을 진행합니다.
4단계: 1080×12720 합성 (Pillow 인라인 조립)
별도 스크립트 없이, 아래 Pillow 코드를 그대로 실행해 13장을 세로로 이어붙입니다.
동작: (1) 01_hero~13_cta 순서 로드 → (2) 너비 1080으로 리사이즈(비율 유지 + 중앙 크롭) →
(3) 섹션별 표준 높이로 조정 → (4) 세로 스택 → (5) 누락 섹션은 (40,40,40) 다크 플레이스홀더로 대체.
from PIL import Image
from pathlib import Path
WIDTH = 1080
SECTIONS = [
("01_hero", 1600), ("02_pain", 800), ("03_problem", 900), ("04_story", 1000),
("05_solution", 1100), ("06_how", 1000), ("07_proof", 1100), ("08_authority", 900),
("09_benefits", 1000), ("10_risk", 800), ("11_compare", 900), ("12_filter", 700),
("13_cta", 900),
]
PLACEHOLDER = (40, 40, 40)
def fit(img, w, h):
scale = max(w / img.width, h / img.height)
img = img.resize((round(img.width * scale), round(img.height * scale)), Image.LANCZOS)
left, top = (img.width - w) // 2, (img.height - h) // 2
return img.crop((left, top, left + w, top + h))
sections_dir = Path("./commerce-output/JOB_ID/sections")
total_h = sum(h for _, h SECTIONS)
canvas = Image.new(, (WIDTH, total_h), PLACEHOLDER)
failed, y = [],
slug, h SECTIONS:
p = sections_dir /
p.exists():
canvas.paste(fit(Image.(p).convert(), WIDTH, h), (, y))
:
failed.append(slug)
y += h
canvas.save(sections_dir.parent / )
({: , : failed})
높이 표준값은 references/sections-spec.md를, 섹션별 비주얼 언어는 references/image-prompts.md를 참조합니다.
5단계: 출력 보고
{
"job_id": "a1b2c3d4",
"output_dir": "/abs/.../commerce-output/a1b2c3d4",
"combined": "/abs/.../combined.png",
"sections": [
"/abs/.../sections/01_hero.png",
"...",
"/abs/.../sections/13_cta.png"
],
"failed_sections": [],
"elapsed_sec": 0,
"size": "1080x12720"
}
failed_sections가 비어있지 않으면 사용자에게 다음을 안내:
- 어떤 섹션이 실패했는지
- 같은
--output --job-id로 재실행 시 자동 재개되는지 (재개는 사용자가 수동으로 해당 섹션만 재생성)
출력 파일 구조
./commerce-output/{job_id}/
├── analysis.json # 13섹션 카피 + 프롬프트 + ProductDNA
├── sections/ # 13장 섹션 (1080×가변)
│ ├── 01_hero.png (1080×1600)
│ ├── 02_pain.png (1080×800)
│ ├── ...
│ └── 13_cta.png (1080×900)
└── combined.png # 1080×12720 세로 합성본
합성 코드 조정 포인트
4단계 인라인 Pillow 코드에서 다음 값만 바꾸면 됩니다:
WIDTH: 출력 너비 (기본 1080)PLACEHOLDER: 누락 섹션 색 (기본 (40, 40, 40))SECTIONS: 섹션 순서·표준 높이 (기본 13섹션, references/sections-spec.md와 동일)sections_dir: 실제 job_id 경로로 치환
이 스킬은 부재 스크립트(compose.py) 참조를 원칙 A(프롬프트/인라인 코드 경로)로 대체했습니다 — 합성은 위 Pillow 코드를 직접 실행합니다.
사용 예시
- "이 카피 결과로 13섹션 이미지 합성해줘"
- "상품사진 5장으로 상세페이지 1080 12720 만들어줘"
- "electronics 카테고리, 무선 이어폰 상세페이지 이미지 풀세트"
관련 스킬
moai-seller:commerce-detail-page-copy — 13섹션 카피 생성 (이 스킬 입력)moai-seller:commerce-product-photo-brief — 상품 사진 사전 분석- 13섹션 이미지 생성 — Higgsfield MCP(Soul·시네마틱 이미지·캐릭터) 직접 호출
moai-seller:commerce-marketplace-coupang — 채널별 이미지 규격 가이드
이 스킬을 사용하지 말아야 할 때
- 카피만 필요할 때:
commerce-detail-page-copy 단독 사용
- 단일 상품 컷만 필요할 때: Higgsfield MCP 직접 호출
- 영상 생성: Higgsfield MCP(DOP·Soul) 직접 호출
- shadcn/ui 기반 웹 상세페이지:
moai-seller:commerce-product-detail
라이선스
MIT.
