Higgsfield BrandKit

Higgsfield BrandKit은(는) 무엇을 하나요?

일관된 아이덴티티와 요청된 적용 자료를 구축하세요. 제공된 브랜드 사실과 공식 자산은 고정된 제약 조건으로 취급합니다.

부트스트랩

1. SKILL_ROOT를 이 스킬이 설치된 디렉토리로 해결하고, 내구성 있는 프로젝트 디렉토리를 생성합니다:

   BRANDKIT_WORKDIR="${PWD}/brandkit"
   BRANDKIT_STATE="${BRANDKIT_WORKDIR}/state.json"
   mkdir -p "${BRANDKIT_WORKDIR}"
   

2. 사전 요구 사항을 읽으세요. 해당 단계가 필요하기 전에 도구를 확인하세요. 사용자 허가 없이 시스템 패키지를 설치하지 마세요.

3. higgsfield가 없으면, 허가를 받은 후에만 설치하세요:

   curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh
   

4. higgsfield account status가 인증 또는 워크스페이스 오류로 실패하면, 사용자에게 higgsfield auth login을 실행하거나 워크스페이스를 선택하도록 요청하고 기다리세요.

5. 유료 생성 전에 라이브 모델 계약을 검사하세요:

   higgsfield model get recraft_v4_1 --json
   higgsfield model get seedream_v5_pro --json
   higgsfield model get gpt_image_2 --json
   

CLI 매핑

작업	명령어
모델 찾기	higgsfield model get <model> --json
생성 및 폴링	higgsfield generate create <model> ... --wait --json
작업 재개	higgsfield generate wait <job_id> --json
로컬 자산 업로드	higgsfield upload create <path> --json
웹사이트 메타데이터 가져오기	higgsfield marketing-studio brand-kits fetch --url <url> --wait --json
승인 상태 읽기/쓰기	python3 "$SKILL_ROOT/scripts/brandkit.py" state ...
리뷰 보드 렌더링	python3 "$SKILL_ROOT/scripts/brandkit.py" preview ...
선택된 로고 검사	python3 "$SKILL_ROOT/scripts/brandkit.py" logo-inspect ...
로고 파일 내보내기	python3 "$SKILL_ROOT/scripts/brandkit.py" logo-export ...
브랜드북 구축	python3 "$SKILL_ROOT/scripts/brandkit.py" brandbook-build ...

--image와 함께 전달된 로컬 이미지 경로는 자동 업로드됩니다. 사용자가 명시적으로 호스팅된 복사본을 필요로 하지 않는 한 HTML, SVG, PPTX, PDF 결과물을 로컬 프로젝트 파일로 유지하세요.

사용자 대면 동작

• 사용자의 언어를 맞추세요. Design Brain 추론, 프롬프트, 상태 메커니즘, 스크립트, 모델 조회, QA 내부는 비공개로 유지하세요.
• 보이는 생성 배치당 최대 하나의 짧은 상태 문장을 보내고, 결과가 준비될 때까지 조용히 기다리세요.
• 해결되지 않은 차단 질문만 한 세트로 압축하여 물어보세요. 부분 작업을 위해 전체 아이덴티티 설문을 강요하거나 사실을 반복하지 마세요.
• 각 팔레트, 로고, 타이포그래피 또는 다운스트림 리뷰 후에는 멈추고 일반 사용자 피드백을 기다리세요.
• 침묵, 성공적인 생성, 또는 자신의 선호도로부터 승인을 추론하지 마세요.
• 사용자의 정확한 문구를 보존하세요. 포지셔닝, 가치, 주장, 성분, 가격, 인증, 통계 또는 규제 콘텐츠를 절대 임의로 만들지 마세요.

핵심 워크플로우

1. 요청 분류.

   • apply-existing: 제공된 공식 자산을 재설계 없이 사용합니다.
   • extend-partial: 요청된 출력에 필요한 누락된 슬롯만 생성합니다.
   • create-identity: 명시적으로 요청된 경우에만 새 로고 또는 아이덴티티를 생성합니다.

2. 상태 읽기. 다음을 실행하세요:

   python3 "$SKILL_ROOT/scripts/brandkit.py" state \
     --state-file "$BRANDKIT_STATE" --action get_status
   

   로컬 상태는 내구성이 있습니다. 상태 파일이 있으면 승인을 붙여넣거나, 수동 편집하거나, 재생성하지 마세요.

3. 인테이크 및 자산 분석 실행. 인테이크, 자산 분석, 상태 라우팅, 정확한 상태 페이로드를 읽으세요. 사용자가 선언한 모든 공식 로고, 팔레트 및 타이포그래피 슬롯을 즉시 잠급니다.

4. 브랜드 잠금 생성. 브랜드 잠금을 읽으세요. 정확한 철자, 공식 자산, 색상, 글꼴, 레이아웃/모양 규칙, 요청된 출력물, 금지된 처리를 기록하세요.

5. 출력이 사용하는 슬롯만 요구하세요.

   • 로고 전용 → 새 마크의 경우 팔레트 + 로고; 기존 마크의 경우 공식 로고만
   • 팔레트 전용 → 팔레트
   • 타이포그래피 전용 → 타이포그래피
   • 카피 없는 목업/상품 → 로고; 색상/적용이 필요한 경우에만 팔레트 추가
   • 텍스트가 포함된 소셜/패키징/포스터/간판 → 로고 + 팔레트 + 타이포그래피
   • 브랜드북/데크 → 로고 + 팔레트 + 타이포그래피

6. 누락된 기반 슬롯 구축. Design Brain, 컨셉 보드, 인라인 리뷰 및 필요한 팔레트, 로고 또는 타이포그래피 모듈만 읽으세요.

7. 필요한 슬롯이 승인되는 즉시 원래 요청을 계속 진행하세요. 사용자에게 범위를 다시 묻지 마세요.

8. 요청된 프로덕션 모듈만 로드하세요:

   • 목업
   • 소셜 그래픽
   • 포스터/배너
   • 패키징
   • 간판
   • 상품
   • 프레젠테이션 데크
   • 브랜드북

9. QA 및 승인. QA 및 반복을 읽으세요. 실패한 출력만 수정하세요. 정확한 기반 종속성과 함께 명시적 승인 후에만 다운스트림 요소를 저장하세요.

새 아이덴티티 시퀀스

1. 팔레트

미리보기 페이로드를 사용하여 결정론적 HTML로 2-3개의 정확한 팔레트 옵션을 렌더링하세요. PNG 스크린샷과 편집 가능한 HTML 파일을 보여주고 기다리세요. 로고 생성 전에 approve_palette로 선택된 팔레트를 유지하세요.

2. SVG 로고 마크

로고 프롬프트 향상기를 읽으세요. 정확히 세 개의 개별적인 심볼 전용 메커니즘과 각각에 대한 하나의 Recraft 프롬프트를 생성하세요. 각 긴 프롬프트를 파일에 쓰고 개별적으로 제출하세요:

higgsfield generate create recraft_v4_1 \
  --model_type vector \
  --colors @"${BRANDKIT_WORKDIR}/logo-colors.json" \
  --background_color '#F7F7F5' \
  --aspect_ratio 1:1 \
  --resolution 2k \
  --wait --json < "${BRANDKIT_WORKDIR}/logo-candidate-1.txt"

리뷰를 위해 반환된 SVG URL을 직접 사용하세요. 선택 후, SVG를 변경하지 않고 정확하게 검사하세요:

python3 "$SKILL_ROOT/scripts/brandkit.py" logo-inspect \
  --source "<선택된 Recraft SVG URL 또는 절대 로컬 경로>"

정확한 작업 ID, SVG URL, 이름, 팔레트 개정, 반환된 표준 지문을 approve_logo로 유지하세요.

3. 타이포그래피

제공된 글꼴 또는 검증된 Google Fonts를 사용하여 2-3개의 독특한 디스플레이/본문 쌍을 제안하세요. 실제 브랜드 이름과 샘플 카피를 미리보기 스크립트를 통해 렌더링하세요. approve_typography로 선택된 쌍만 유지하세요.

인터랙티브 흐름은 항상 팔레트, 로고 및 타이포그래피 선택을 위해 중단됩니다. 명시적인 무질문 모드는 팔레트를 선택하고 유지할 수 있지만, 여전히 세 가지 SVG 로고 후보를 모두 보여주고 사용자의 로고 선택을 위해 중단됩니다; 정확한 브랜드 마크는 스스로 승인되지 않습니다.

일관성 불변 조건

• 승인된 동일한 로고 소스를 모든 곳에서 재사용하세요. 결정론적 배치/내보내기가 가능할 때 공식 또는 선택된 SVG를 다시 그리지 마세요.
• 생성된 로고는 생성에 사용된 팔레트 개정에 종속됩니다. 해당 팔레트를 변경하면 생성된 로고와 그 종속 항목이 무효화됩니다. 타이포그래피를 변경해도 심볼 마크는 무효화되지 않습니다.
• 기반 슬롯을 변경하면 required_slots에 해당 슬롯을 나열하는 다운스트림 요소만 무효화됩니다.
• 동일한 Brand Lock 값을 모든 관련 생성 프롬프트에 복사하세요: 정확한 16진수, 글꼴 역할, 모양 언어, 배치, 여백 공간, 구성 및 금지된 처리.
• 새 로고 마크에만 Recraft V4.1 벡터 모드를 사용하세요.
• 주요 포토리얼 목업 생성기로 Seedream을 사용하세요. 읽기 쉬운 텍스트나 정확한 그래픽 세부 정보를 추가하는 제어된 단계에만 GPT Image 2를 사용하세요.
• 정확한 카피와 편집 가능한 레이아웃을 위해 로컬 결정론적 SVG/PPTX/HTML 구성을 사용하세요. 이미지 모델이 편집 가능한 파일을 위조하도록 요청하지 마세요.
• 네이티브 Figma, Canva, PSD, AI 또는 EPS 파일을 약속하지 마세요.

결정론적 스크립트

"$BRANDKIT_WORKDIR" 아래에 JSON 입력 파일을 생성하세요. 사용자 텍스트를 셸 인수에 직접 삽입하지 마세요.

python3 "$SKILL_ROOT/scripts/brandkit.py" preview \
  --input "$BRANDKIT_WORKDIR/reviews.json" \
  --output-dir "$BRANDKIT_WORKDIR/reviews"

python3 "$SKILL_ROOT/scripts/brandkit.py" logo-export \
  --input "$BRANDKIT_WORKDIR/logo-export.json" \
  --output-dir "$BRANDKIT_WORKDIR/logo"

python3 "$SKILL_ROOT/scripts/brandkit.py" brandbook-build \
  --state-file "$BRANDKIT_STATE" \
  --input "$BRANDKIT_WORKDIR/brandbook.json" \
  --output-dir "$BRANDKIT_WORKDIR/brandbook"

로고 내보내기의 경우 로고 내보내기 페이로드를 로드하세요. 브랜드북의 경우 번들된 빌더만 사용하세요. 결정론적 계약 실패 후 임시방편 PowerPoint 또는 PDF 생성기를 대체하지 마세요.

실패 정책

• 실패한 Recraft 또는 이미지 생성 요청을 동일한 잠긴 개념과 수정된 계약으로 한 번 재시도하세요. 두 번째 동등한 실패 후 중단하세요.
• 미리보기 또는 로고 내보내기가 두 번 실패하면 구체적인 오류를 보고하세요. 임시방편 SVG 재작성으로 대체하지 마세요.
• 브랜드북 템플릿, 글꼴 또는 변환 계약이 실패하면 즉시 중단하세요. 시각적으로 다른 대체물을 생성하고 이를 표준이라고 부르지 마세요.
• 정확한 타이포그래피 또는 공식 로고 충실도를 유지할 수 없으면 완료를 주장하는 대신 제한 사항을 공개하세요.
• 파일, 로그 또는 채팅에 원시 인증 토큰이나 자격 증명을 절대 노출하지 마세요.

전달

브랜드북의 경우 브랜드북의 엄격한 응답 계약을 따르세요: PPTX 링크/경로, PDF 링크/경로 및 글꼴 설치 경고만 포함.

다른 출력물의 경우 다음을 반환하세요:

1. 요청된 시각적 파일 및 미리보기.
2. 간결한 Brand Lock 요약.
3. 편집 가능 vs 평면화 형식 레이블.
4. 필요한 글꼴/가져오기 제한 사항.
5. 대상 수정을 위한 안정적인 변형 이름.

참조 색인

• 사전 요구 사항 — 단계별 로컬 종속성 및 설치 명령어.
• 인테이크 — 최소한의 질문과 입력 라우팅.
• 자산 분석 — 공식/참조 분류 및 측정.
• 상태 라우팅 및 상태 페이로드 — 지속적 승인.
• 브랜드 잠금 — 표준 시각적 제약 조건.
• Design Brain — 비공개 아트 디렉션.
• 컨셉 보드, 미리보기 페이로드 및 인라인 리뷰 — 선택 단계.
• 로고, 로고 프롬프트 향상기 및 로고 내보내기 페이로드 — SVG 생성 및 결정론적 변형.
• 팔레트 및 타이포그래피 — 기반 슬롯.
• 목업, 소셜 그래픽, 포스터/배너, 패키징, 간판 및 상품 — 적용 자료.
• 프레젠테이션 데크 및 브랜드북 — 편집 가능한 문서.
• QA 및 반복 — 사전 점검, 수리, 승인 및 전달 매니페스트.