Higgsfield Brandkit

Was macht Higgsfield Brandkit?

Erstellen Sie eine kohärente Identität und deren angeforderte Anwendungen. Behandeln Sie gelieferte Markenfakten und offizielle Assets als feste Vorgaben.

Bootstrap

1. Lösen Sie SKILL_ROOT zum installierten Verzeichnis dieses Skills auf und erstellen Sie ein dauerhaftes Projektverzeichnis:

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

2. Lesen Sie die Voraussetzungen. Überprüfen Sie die Werkzeuge vor der Phase, die sie benötigt. Installieren Sie niemals Systempakete ohne die Erlaubnis des Benutzers.

3. Wenn higgsfield fehlt, installieren Sie es nur nach Erlaubnis:

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

4. Wenn higgsfield account status mit einem Authentifizierungs- oder Workspace-Fehler fehlschlägt, bitten Sie den Benutzer, higgsfield auth login auszuführen oder einen Workspace auszuwählen, und warten Sie dann.

5. Überprüfen Sie die aktuellen Modellverträge vor der kostenpflichtigen Generierung:

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

CLI-Zuordnung

Vorgang	Befehl
Ein Modell entdecken	higgsfield model get <model> --json
Generieren und abrufen	higgsfield generate create <model> ... --wait --json
Einen Job fortsetzen	higgsfield generate wait <job_id> --json
Ein lokales Asset hochladen	higgsfield upload create <path> --json
Website-Metadaten importieren	higgsfield marketing-studio brand-kits fetch --url <url> --wait --json
Freigabestatus lesen/schreiben	python3 "$SKILL_ROOT/scripts/brandkit.py" state ...
Review-Boards rendern	python3 "$SKILL_ROOT/scripts/brandkit.py" preview ...
Ausgewähltes Logo inspizieren	python3 "$SKILL_ROOT/scripts/brandkit.py" logo-inspect ...
Logo-Dateien exportieren	python3 "$SKILL_ROOT/scripts/brandkit.py" logo-export ...
Ein Markenbuch erstellen	python3 "$SKILL_ROOT/scripts/brandkit.py" brandbook-build ...

Lokale Bildpfade, die mit --image übergeben werden, werden automatisch hochgeladen. Behalten Sie HTML-, SVG-, PPTX- und PDF-Ausgaben als lokale Projektdateien, es sei denn, der Benutzer wünscht explizit eine gehostete Kopie.

Benutzerorientiertes Verhalten

• Passen Sie die Sprache des Benutzers an. Halten Sie Design-Brain-Überlegungen, Eingabeaufforderungen, Zustandsmechaniken, Skripte, Modellsuchen und QA-Interna privat.
• Senden Sie höchstens einen kurzen Statussatz pro sichtbarem Generierungsdurchlauf und bleiben Sie dann still, bis das Ergebnis bereit ist.
• Stellen Sie einen kompakten Satz von nur ungelösten, blockierenden Fragen. Wiederholen Sie niemals Fakten oder erzwingen Sie einen vollständigen Identitätsfragebogen für eine Teilaufgabe.
• Halten Sie nach jeder Überprüfung von Palette, Logo, Typografie oder nachgelagerten Schritten an und warten Sie auf normales Benutzerfeedback.
• Leiten Sie niemals eine Genehmigung aus Stille, erfolgreicher Generierung oder Ihrer eigenen Präferenz ab.
• Bewahren Sie den genauen Wortlaut des Benutzers. Erfinden Sie niemals Positionierung, Werte, Behauptungen, Zutaten, Preise, Zertifizierungen, Statistiken oder regulatorische Inhalte.

Kern-Workflow

1. Klassifizieren Sie die Anfrage.

   • apply-existing: Verwenden Sie die bereitgestellten offiziellen Assets, ohne sie neu zu gestalten.
   • extend-partial: Erstellen Sie nur die fehlenden Slots, die für die angeforderte Ausgabe erforderlich sind.
   • create-identity: Erstellen Sie nur dann ein neues Logo oder eine neue Identität, wenn dies explizit angefordert wird.

2. Status lesen. Führen Sie aus:

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

   Der lokale Status ist dauerhaft. Kopieren, bearbeiten oder erstellen Sie niemals Freigaben neu, wenn die Statusdatei vorhanden ist.

3. Durchführung der Aufnahme und Asset-Analyse. Lesen Sie Aufnahme, Asset-Analyse, Status-Routing und exakte Status-Payloads. Sperren Sie sofort jeden vom Benutzer deklarierten offiziellen Logo-, Paletten- und Typografie-Slot.

4. Erstellen Sie das Marken-Schloss. Lesen Sie Marken-Schloss. Zeichnen Sie die genaue Schreibweise, offizielle Assets, Farben, Schriftarten, Layout-/Formregeln, angeforderte Ausgaben und verbotene Behandlungen auf.

5. Fordern Sie nur die Slots an, die die Ausgabe verwendet.

   • Nur-Logo → Palette + Logo für ein neues Zeichen; allein das offizielle Logo für ein bestehendes Zeichen
   • Nur-Palette → Palette
   • Nur-Typografie → Typografie
   • Kopiefreies Mockup/Merchandise → Logo; Palette nur hinzufügen, wenn Farbe/Anwendung es erfordert
   • Texttragende Social/Packaging/Poster/Signage → Logo + Palette + Typografie
   • Markenbuch/Präsentationsdeck → Logo + Palette + Typografie

6. Erstellen Sie fehlende Grundlagenslots. Lesen Sie Design Brain, Konzepttafeln, Inline-Reviews und nur das benötigte Paletten-, Logo- oder Typografie-Modul.

7. Setzen Sie die ursprüngliche Anfrage fort, sobald die erforderlichen Slots genehmigt sind. Bitten Sie den Benutzer niemals, den Umfang erneut zu wählen.

8. Laden Sie nur das angeforderte Produktionsmodul:

   • Mockups
   • Social Graphics
   • Poster/Banner
   • Verpackungen
   • Beschilderung
   • Merchandise
   • Präsentationsdecks
   • Markenbücher

9. QA und Freigabe. Lesen Sie QA und Iteration. Reparieren Sie nur die fehlschlagende Ausgabe. Speichern Sie ein nachgelagertes Element nur nach expliziter Freigabe mit seinen genauen Grundlagenabhängigkeiten.

Ablauf für neue Identität

1. Palette

Rendern Sie 2–3 genaue Palettenoptionen als deterministisches HTML mit Vorschau-Payloads. Zeigen Sie PNG-Screenshots plus bearbeitbare HTML-Dateien und warten Sie. Speichern Sie die ausgewählte Palette mit approve_palette vor der Logo-Generierung.

2. SVG-Logos

Lesen Sie Logo-Prompt-Verbesserer. Erstellen Sie genau drei verschiedene symbolbasierte Mechanismen und einen Recraft-Prompt für jeden. Schreiben Sie jeden Langtext in eine Datei und senden Sie sie einzeln ab:

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"

Verwenden Sie die zurückgegebenen SVG-URLs direkt für die Überprüfung. Nach der Auswahl inspizieren Sie das genaue SVG, ohne es zu ändern:

python3 "$SKILL_ROOT/scripts/brandkit.py" logo-inspect \
  --source "<ausgewählte Recraft SVG-URL oder absoluter lokaler Pfad>"

Speichern Sie die genaue Job-ID, SVG-URL, den Namen, die Palettenrevision und den zurückgegebenen kanonischen Geometrie-Fingerprint mit approve_logo.

3. Typografie

Schlagen Sie 2–3 einzigartige Display/Text-Paare unter Verwendung der gelieferten Schriftarten oder verifizierter Google Fonts vor. Rendern Sie den echten Markennamen und einen Beispieltext durch das Vorschau-Skript. Speichern Sie nur das ausgewählte Paar mit approve_typography.

Interaktive Abläufe stoppen immer für Paletten-, Logo- und Typografie-Auswahlen. Im expliziten „Keine-Fragen“-Modus kann eine Palette ausgewählt und gespeichert werden, aber es werden trotzdem alle drei SVG-Logokandidaten angezeigt und gestoppt, bis der Benutzer das Logo auswählt; exakte Markenzeichen werden nie selbst genehmigt.

Konsistenz-Invarianten

• Verwenden Sie überall dieselbe genehmigte Logo-Quelle. Zeichnen Sie ein offizielles oder ausgewähltes SVG niemals neu, wenn eine deterministische Platzierung/Export möglich ist.
• Ein generiertes Logo hängt von der Palettenrevision ab, die zu seiner Erstellung verwendet wurde. Das Ändern dieser Palette macht das generierte Logo und seine Abhängigkeiten ungültig; das Ändern der Typografie macht das Symbolzeichen nicht ungültig.
• Das Ändern eines Grundlagenslots macht nur nachgelagerte Elemente ungültig, die diesen Slot in required_slots auflisten.
• Kopieren Sie dieselben Marken-Schloss-Werte in jeden zugehörigen Generierungs-Prompt: exakte Hex-Werte, Schriftrollen, Formsprache, Platzierung, Schutzraum, Komposition und verbotene Behandlungen.
• Verwenden Sie Recraft V4.1 Vektor-Modus nur für neue Logos.
• Verwenden Sie Seedream als primären fotorealistischen Mockup-Generator. Verwenden Sie GPT Image 2 nur für die kontrollierte Phase, die lesbaren Text oder exakte grafische Details hinzufügt.
• Verwenden Sie lokale deterministische SVG/PPTX/HTML-Konstruktion für exakte Kopien und bearbeitbare Layouts. Bitten Sie kein Bildmodell, bearbeitbare Dateien zu fälschen.
• Versprechen Sie keine nativen Figma-, Canva-, PSD-, AI- oder EPS-Dateien.

Deterministische Skripte

Erstellen Sie JSON-Eingabedateien unter "$BRANDKIT_WORKDIR"; interpolieren Sie niemals Benutzertext direkt in Shell-Argumente.

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"

Für den Logo-Export laden Sie Logo-Export-Payloads. Für Markenbücher verwenden Sie nur den gebündelten Builder; ersetzen Sie niemals einen improvisierten PowerPoint- oder PDF-Generator nach einem deterministischen Vertragsfehler.

Fehlerbehandlungsstrategie

• Wiederholen Sie eine fehlgeschlagene Recraft- oder Bildgenerierungsanfrage einmal mit demselben gesperrten Konzept und korrigiertem Vertrag. Stoppen Sie nach dem zweiten gleichwertigen Fehler.
• Wenn die Vorschau oder der Logo-Export zweimal fehlschlägt, melden Sie den konkreten Fehler; ersetzen Sie ihn niemals durch Ad-hoc-SVG-Neuschreibung.
• Wenn der Markenbuch-Vorlagen-, Schriftart- oder Konvertierungsvertrag fehlschlägt, stoppen Sie sofort. Erstellen Sie keinen visuell abweichenden Fallback und bezeichnen Sie ihn als kanonisch.
• Wenn die exakte Typografie oder die Wiedergabetreue des offiziellen Logos nicht erhalten werden kann, legen Sie die Einschränkung offen, anstatt die Fertigstellung zu behaupten.
• Legen Sie niemals rohe Authentifizierungstoken oder Anmeldeinformationen in Dateien, Protokollen oder Chats offen.

Lieferung

Für Markenbücher befolgen Sie den strengen Antwortvertrag in Markenbuch: nur PPTX-Pfad/Link, PDF-Pfad/Link und eine Warnung zur Schriftartinstallation.

Für andere Ausgaben geben Sie zurück:

1. Die angeforderten visuellen Dateien und Vorschauen.
2. Eine kompakte Marken-Schloss-Zusammenfassung.
3. Labels für bearbeitbare versus flache Formate.
4. Erforderliche Schriftart-/Import-Beschränkungen.
5. Stabile Variantennamen für gezielte Überarbeitungen.

Referenzindex

• Voraussetzungen — phasenspezifische lokale Abhängigkeiten und Installationsbefehle.
• Aufnahme — minimale Fragen und Eingabe-Routing.
• Asset-Analyse — Klassifizierung und Messung offizieller/Referenz-Assets.
• Status-Routing und Status-Payloads — dauerhafte Freigaben.
• Marken-Schloss — kanonische visuelle Einschränkungen.
• Design Brain — private Art Direction.
• Konzepttafeln, Vorschau-Payloads und Inline-Reviews — Auswahlphasen.
• Logo, Logo-Prompt-Verbesserer und Logo-Export-Payloads — SVG-Generierung und deterministische Varianten.
• Palette und Typografie — Grundlagenslots.
• Mockups, Social Graphics, Poster/Banner, Verpackungen, Beschilderung und Merchandise — Anwendungen.
• Präsentationsdecks und Markenbücher — bearbeitbare Dokumente.
• QA und Iteration — Vorkontrolle, Reparatur, Freigabe und Liefermanifest.