Media Higgsfield Product

---
name: media-higgsfield-product
description: |
  브랜드·제품 비주얼 요청을 10개 촬영 모드 중 하나로 판정하고, 그 모드에 맞는 프롬프트 구조를 조립해
  Higgsfield MCP로 이미지를 생성합니다. 스튜디오 컷·라이프스타일·핀터레스트 핀·히어로 배너·캐러셀·
  광고 크리에이티브 팩·가상 피팅·컨셉추얼·리스타일이 범위입니다.
  다음과 같은 요청 시 사용하세요:
  - "제품 사진 만들어줘", "누끼 배경에 스튜디오 컷"
  - "이 제품이 카페에 놓인 장면"
  - "핀터레스트용 세로 핀", "웹사이트 히어로 배너"
  - "메타 광고용 소재 여러 장", "인스타 캐러셀"
  - "모델이 착용한 컷", "가상 피팅"
  - "이 이미지 크리스마스 버전으로 바꿔줘"
  주의: Higgsfield 공식 CLI가 쓰는 백엔드 프롬프트 강화기는 MCP에 노출되지 않습니다. 이 스킬은 모드
  판정과 프롬프트 구조까지 담당하며, 최고 충실도가 필요하면 공식 CLI 경로를 안내합니다.
version: "1.2.0"
---

# Higgsfield 제품 촬영 (media-higgsfield-product)

> `moai-media` | 브랜드·제품 비주얼 10모드 판정과 생성 (코어: `media-higgsfield-core`)

## 개요

"제품 사진 만들어줘"는 한 종류의 요청이 아니다. 스튜디오 컷과 핀터레스트 핀과 광고 팩은 구도·비율·장수·프롬프트 구조가 전부 다르다. 이 스킬은 요청을 **10개 모드 중 하나로 먼저 판정하고**, 그 모드의 프롬프트 구조로 조립한다.

호출 계약·비용 프리플라이트는 코어를 따른다:
- 호출 계약: `../media-higgsfield-core/references/call-schema.md`
- 잡·비용·리드백: `../media-higgsfield-core/references/job-lifecycle.md`

## ⚠️ 알려진 한계 (먼저 읽는다)

Higgsfield 공식 CLI에는 `product-photoshoot` 전용 **백엔드 프롬프트 강화기**가 있다. 모드별 사진 용어와 구조 템플릿을 서버가 들고 있다가 프롬프트를 조립해 준다.

**이 강화기는 MCP 커넥터에 노출되지 않는다.** 마켓플레이스 앱 목록을 조회해도 해당 앱이 없다(저술 시점 관측). 따라서 이 스킬은 강화기를 호출할 수 없고, **모드별 프롬프트 구조를 직접 조립해 범용 이미지 모델에 넘긴다.**

결과적으로:

| 항목 | 이 스킬 (MCP) | 공식 CLI |
|---|---|---|
| 모드 판정 | ✅ 동일 | ✅ |
| 인터뷰 흐름 | ✅ 동일 | ✅ |
| 프롬프트 조립 | 스킬이 직접 | 서버 강화기 |
| 충실도 | **보장 못 함** | 공식 최적화 |
| 추가 설치 | 없음 | CLI 설치·로그인 필요 |

공식 문서는 강화기를 우회해 이미지 모델을 직접 호출하면 "눈에 띄게 결과가 나빠진다"고 명시한다. **최고 충실도가 목표라면** 사용자에게 공식 CLI 스킬(`higgsfield-product-photoshoot`) 경로를 안내한다. 이 스킬은 추가 설치 없이 지금 쓸 수 있다는 것이 장점이지 품질 우위가 아니다.

이 한계를 사용자에게 숨기지 않는다.

## 트리거 키워드

제품 사진, 제품컷, 스튜디오 컷, 누끼 배경, 라이프스타일 컷, 연출컷, 핀터레스트 핀, 히어로 배너, 상단 배너, 캐러셀, 슬라이드 광고, 광고 소재, 메타 광고, 가상 피팅, 착용컷, 룩북, 컨셉추얼, 부유하는 제품, 스플래시, 리스타일, 시즌 버전

## 10개 모드

| 모드 | 언제 |
|---|---|
| `product_shot` | 중립·스튜디오·카탈로그 배경 위 제품 |
| `lifestyle_scene` | 실제 환경, 손, 동작, 분위기 |
| `closeup_product_with_person` | 손·얼굴 일부가 들어간 타이트 크롭 — 뷰티 시연, 사용 장면 |
| `moodboard_pin` | 세로 2:3 핀터레스트 무드보드 |
| `hero_banner` | 웹사이트·이메일·캠페인 가로 헤더 |
| `social_carousel` | IG·링크드인·페이스북 연결형 3~10장 |
| `ad_creative_pack` | 메타·틱톡·핀터레스트·구글 정적 광고 변형 묶음 |
| `virtual_model_tryout` | AI 모델이 착용·사용 |
| `conceptual_product` | 초현실·CGI·부유·스플래시·조형적 |
| `restyle` | 기존 이미지의 미감·무드·시즌을 바꿈 |

판정 규칙·동점 처리는 `references/modes.md`. 사전 인터뷰 유형(A~F)은 `references/interview.md`.

## 워크플로우

### 1단계 — 모드 판정

표면 키워드가 아니라 **의도**로 고른다. 둘 다 걸리면 더 구체적인 쪽이 이긴다. 상세는 `references/modes.md`.

### 2단계 — 인터뷰 (최대 4문항)

사용자 상황을 A~F 유형으로 분류하고 그 유형의 질문만 묻는다. **한 메시지에 4문항을 넘기지 않는다.** 맥락에서 이미 답이 나온 질문은 건너뛴다. 선택지를 붙여 묻고 열린 질문을 하지 않는다.

이 스킬은 사용자에게 직접 묻지 않는다 — 슬롯을 blocker로 반환하고 오케스트레이터가 묻는다.

### 3단계 — 프롬프트 조립

모드별 구조로 조립한다(`references/modes.md`의 모드별 구성 요소). 강화기가 없으므로 이 단계가 품질을 좌우한다.

### 4단계 — 라이브 조회·비용 프리플라이트

`models_explore(action:'get')`로 대상 모델의 제약(비율·해상도)을 확인하고, `get_cost: true`로 크레딧을 확인한다. 비율은 모드 기본값을 쓰되 사용자가 명시하면 따른다.

### 5단계 — 승인 게이트

크레딧이 나가기 전에 멈춘다 — 코어 §유료 생성 승인 게이트를 그대로 따른다. **이 스킬은 강화기가 없어 프롬프트를 직접 조립하므로**(2단계 주의), 조립 결과가 사용자 의도와 어긋나 있으면 그 비용은 그대로 낭비된다. 게이트는 그것을 막는 자리다.

- **[HARD] 승인 화면에는 조립한 프롬프트 전문을 보여준다.** 아래 §주의사항의 "프롬프트 전문을 되돌려주지 않는다"는 **결과 보고**에 관한 규칙이지 승인 화면에 관한 규칙이 아니다. 돈이 나가기 전에는 무엇에 돈을 쓰는지 보여준다.
- 다중 변형(`social_carousel`·`ad_creative_pack` 포함)은 **장수 × 단가 = 최대 총 크레딧**을 함께 보여주고 배치 단위로 한 번에 승인받는다.

### 6단계 — 생성·전달

승인된 값으로만 호출한다. 참조 이미지는 `media_id` 또는 `job_id`로 전달한다(URL 거부). 결과는 이미지 URL 목록으로 짧게 전달한다.

## 다중 변형

장수를 요청하면 프리셋·조명·앵글·팔레트를 서로 다르게 가져간다 — 같은 프롬프트의 재구성이 되지 않게 한다.

`social_carousel`과 `ad_creative_pack`은 장수가 곧 슬라이드/변형 수다. 이 두 모드는 **전 슬라이드의 시각 시스템을 고정**해야 하므로, 변형을 주더라도 팔레트·타이포·구도 문법은 공유한다.

## 출력 형식

```
## Higgsfield 제품 비주얼 결과
- 판정 모드: [mode] — 근거: [걸린 신호]
- 사용 모델: [models_explore로 확인한 실제 id]
- 비율·장수: [aspect] · [count]
- 비용: [get_cost가 반환한 credits]
- 결과:
  - [URL]
  - [URL]
- 서버 조정(adjustments): [있으면 그대로 보고]
```

**결과 보고에서는** 조립한 프롬프트 전문을 되돌려주지 않는다 — 원하는 것은 결과물이다. 단 **5단계 승인 화면은 예외이며, 거기서는 전문을 보여준다**(크레딧이 나가기 전이므로).

## 주의사항

- **한계를 먼저 알린다.** 충실도가 중요한 작업이면 공식 CLI 경로를 안내한다.
- 인터뷰 4문항 한도를 넘기지 않는다.
- 모드를 잘못 고르면 나머지가 전부 어긋난다 — 판정이 첫 번째 품질 관문이다.
- 10개 모드 밖의 이름을 만들어 쓰지 않는다.
- 제품 사진 없이 텍스트만으로 만들면 충실도가 크게 떨어진다. 사진 업로드를 먼저 권한다.
- 경쟁사 상표·타인 저작물을 합성하지 않는다.
- 실제 제품과 다른 성능·효능을 암시하는 연출은 표시광고법 위반 소지가 있다 — 커머스 맥락이면 `moai-seller:commerce-ad-claim-compliance-kr`로 넘긴다.

## 관련 스킬

| 스킬 | 시점 |
|---|---|
| `moai-media:media-higgsfield-core` | 코어: 호출 계약·비용·namespace |
| `moai-media:media-higgsfield-image` | 대안: 모드 판정이 필요 없는 범용 이미지 |
| `moai-media:media-higgsfield-identity` | 선행: 모델·마스코트 일관성 참조 |
| `moai-seller:commerce-detail-page-image` | 후속: 상세페이지 배치 |
| `moai-seller:commerce-product-photo-brief` | 선행: 촬영 브리프 |
| `moai-seller:commerce-ad-claim-compliance-kr` | 후속: 광고 표현 적법성 |
| `moai-designer:design-brand-visual` | 인접: 브랜드 시스템 정합 |

## 출처

- [Higgsfield Skills (공식 agent 문서)](https://github.com/higgsfield-ai/skills) — `higgsfield-product-photoshoot` v0.12.0 (MIT). 10모드 정의·판정 규칙·동점 처리·인터뷰 유형의 근거.
- 라이브 MCP 마켓플레이스 앱 목록 조회 — 백엔드 강화기 미노출의 근거. **Evidence tier: 1차 (부정 관측).**
- 프롬프트 조립 구조는 공식 모드 정의에서 역산한 것이며, 공식 강화기와 동일한 산출을 보장하지 않는다.