Higgsfield Brandkit

Que fait Higgsfield Brandkit ?

Construisez une identité cohérente et les applications demandées. Traitez les faits de marque fournis et les actifs officiels comme des contraintes fixes.

Bootstrap

1. Résolvez SKILL_ROOT vers le répertoire d'installation de cette compétence et créez un répertoire de projet durable :

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

2. Lisez les prérequis. Vérifiez les outils avant l'étape qui en a besoin. N'installez jamais de paquets système sans l'autorisation de l'utilisateur.

3. Si higgsfield est manquant, installez-le uniquement après autorisation :

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

4. Si higgsfield account status échoue avec une erreur d'authentification ou d'espace de travail, demandez à l'utilisateur d'exécuter higgsfield auth login ou de sélectionner un espace de travail, puis attendez.

5. Inspectez les contrats de modèles en direct avant la génération payante :

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

Mappage CLI

Opération	Commande
Découvrir un modèle	higgsfield model get <modèle> --json
Générer et interroger	higgsfield generate create <modèle> ... --wait --json
Reprendre un travail	higgsfield generate wait <job_id> --json
Téléverser un actif local	higgsfield upload create <chemin> --json
Importer les métadonnées d'un site web	higgsfield marketing-studio brand-kits fetch --url <url> --wait --json
Lire/écrire l'état d'approbation	python3 "$SKILL_ROOT/scripts/brandkit.py" state ...
Rendre les planches de révision	python3 "$SKILL_ROOT/scripts/brandkit.py" preview ...
Inspecter le logo sélectionné	python3 "$SKILL_ROOT/scripts/brandkit.py" logo-inspect ...
Exporter les fichiers logo	python3 "$SKILL_ROOT/scripts/brandkit.py" logo-export ...
Construire un livre de marque	python3 "$SKILL_ROOT/scripts/brandkit.py" brandbook-build ...

Les chemins d'images locaux passés avec --image sont automatiquement téléversés. Conservez les livrables HTML, SVG, PPTX et PDF en tant que fichiers de projet locaux, sauf si l'utilisateur a explicitement besoin d'une copie hébergée.

Comportement face à l'utilisateur

• Adaptez la langue de l'utilisateur. Gardez privés les raisonnements du Design Brain, les invites, les mécanismes d'état, les scripts, la recherche de modèles et les internes de l'assurance qualité.
• Envoyez au maximum une phrase de statut courte par lot de génération visible, puis restez silencieux jusqu'à ce que le résultat soit prêt.
• Posez un ensemble compact de questions bloquantes non résolues. Ne répétez jamais les faits et ne forcez pas un questionnaire d'identité complet pour une tâche partielle.
• Après chaque révision de palette, logo, typographie ou aval, arrêtez-vous et attendez un retour utilisateur normal.
• Ne déduisez jamais l'approbation du silence, d'une génération réussie ou de votre propre préférence.
• Préservez le texte exact de l'utilisateur. N'inventez jamais de positionnement, de valeurs, de revendications, d'ingrédients, de prix, de certifications, de statistiques ou de contenu réglementaire.

Flux de travail principal

1. Classez la demande.

   • apply-existing : utilisez les actifs officiels fournis sans les reconcevoir.
   • extend-partial : créez uniquement les emplacements manquants requis par la sortie demandée.
   • create-identity : créez un nouveau logo ou une nouvelle identité uniquement lorsque cela est explicitement demandé.

2. Lisez l'état. Exécutez :

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

   L'état local est durable. Ne collez, ne modifiez manuellement et ne recréez jamais les approbations lorsque le fichier d'état existe.

3. Exécutez la réception et l'analyse des actifs. Lisez réception, analyse des actifs, routage d'état et charges utiles d'état exactes. Verrouillez immédiatement chaque logo officiel, palette et emplacement typographique déclaré par l'utilisateur.

4. Créez le verrou de marque. Lisez Verrou de marque. Enregistrez l'orthographe exacte, les actifs officiels, les couleurs, les polices, les règles de mise en page/forme, les sorties demandées et les traitements interdits.

5. Exigez uniquement les emplacements utilisés par la sortie.

   • logo uniquement → palette + logo pour un nouveau marque ; logo officiel seul pour un marque existant
   • palette uniquement → palette
   • typographie uniquement → typographie
   • maquette/merchandising sans texte → logo ; ajoutez la palette uniquement lorsque la couleur/l'application l'exige
   • réseaux sociaux/emballage/affiche/signalétique avec texte → logo + palette + typographie
   • livre de marque/présentation → logo + palette + typographie

6. Construisez les emplacements fondamentaux manquants. Lisez Design Brain, planches de concepts, révisions en ligne et uniquement le module nécessaire palette, logo ou typographie.

7. Continuez la demande originale dès que ses emplacements requis sont approuvés. Ne demandez jamais à l'utilisateur de choisir le périmètre à nouveau.

8. Chargez uniquement le module de production demandé :

   • maquettes
   • graphiques sociaux
   • affiches/bannières
   • emballage
   • signalétique
   • merchandising
   • présentations
   • livres de marque

9. Assurance qualité et approbation. Lisez AQ et itération. Réparez uniquement la sortie défaillante. Enregistrez un élément aval uniquement après approbation explicite avec ses dépendances fondamentales exactes.

Séquence de nouvelle identité

1. Palette

Rendez 2 à 3 options de palette exactes sous forme de HTML déterministe en utilisant charges utiles de prévisualisation. Montrez des captures d'écran PNG ainsi que des fichiers HTML modifiables et attendez. Persistez la palette sélectionnée avec approve_palette avant la génération du logo.

2. Logos SVG

Lisez améliorateur d'invite de logo. Produisez exactement trois mécanismes distincts de symbole uniquement et une invite Recraft pour chacun. Écrivez chaque invite longue dans un fichier et soumettez-les séparément :

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"

Utilisez les URLs SVG retournées directement pour la révision. Après sélection, inspectez le SVG exact sans le modifier :

python3 "$SKILL_ROOT/scripts/brandkit.py" logo-inspect \
  --source "<URL SVG Recraft sélectionnée ou chemin local absolu>"

Persistez l'ID de travail exact, l'URL SVG, le nom, la révision de la palette et l'empreinte de géométrie canonique retournée avec approve_logo.

3. Typographie

Proposez 2 à 3 paires d'affichage/corps uniques en utilisant les polices fournies ou des polices Google vérifiées. Rendez le nom de marque réel et un exemple de texte via le script de prévisualisation. Persistez uniquement la paire sélectionnée avec approve_typography.

Les flux interactifs s'arrêtent toujours pour les sélections de palette, logo et typographie. Le mode sans question explicite peut choisir et persister une palette, mais il montre toujours les trois candidats logo SVG et s'arrête pour la sélection du logo par l'utilisateur ; les marques exactes ne sont jamais auto-approuvées.

Invariants de cohérence

• Réutilisez la même source de logo approuvée partout. Ne redessinez jamais un SVG officiel ou sélectionné lorsqu'un placement/export déterministe est possible.
• Un logo généré dépend de la révision de la palette utilisée pour le créer. Modifier cette palette invalide le logo généré et ses dépendants ; modifier la typographie n'invalide pas le symbole.
• La modification d'un emplacement fondamental invalide uniquement les éléments avals qui listent cet emplacement dans required_slots.
• Copiez les mêmes valeurs de verrou de marque dans chaque invite de génération connexe : hex exact, rôles de police, langage de forme, placement, espace libre, composition et traitements interdits.
• Utilisez le mode vectoriel Recraft V4.1 uniquement pour les nouveaux logos.
• Utilisez Seedream comme générateur de maquettes photo-réalistes principal. Utilisez GPT Image 2 uniquement pour l'étape contrôlée qui ajoute du texte lisible ou des détails graphiques exacts.
• Utilisez la construction SVG/PPTX/HTML locale déterministe pour le texte exact et les mises en page modifiables. Ne demandez pas à un modèle d'image de simuler des fichiers modifiables.
• Ne promettez pas de fichiers natifs Figma, Canva, PSD, AI ou EPS.

Scripts déterministes

Créez des fichiers d'entrée JSON sous "$BRANDKIT_WORKDIR" ; n'interpolez jamais le texte utilisateur directement dans les arguments du shell.

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"

Pour l'export de logo, chargez charges utiles d'export de logo. Pour les livres de marque, utilisez uniquement le constructeur fourni ; ne remplacez jamais un générateur PowerPoint ou PDF improvisé après un échec de contrat déterministe.

Politique d'échec

• Réessayez une demande Recraft ou de génération d'image échouée une fois avec le même concept verrouillé et le contrat corrigé. Arrêtez après le deuxième échec équivalent.
• Si la prévisualisation ou l'export de logo échoue deux fois, signalez l'erreur concrète ; ne la remplacez jamais par une réécriture SVG ad-hoc.
• Si le modèle de livre de marque, la police ou le contrat de conversion échoue, arrêtez immédiatement. Ne produisez pas un repli visuellement différent en l'appelant canonique.
• Si la fidélité exacte de la typographie ou du logo officiel ne peut pas être préservée, divulguez la limitation au lieu de prétendre à l'achèvement.
• N'exposez jamais les jetons d'authentification bruts ou les informations d'identification dans les fichiers, les journaux ou le chat.

Livraison

Pour les livres de marque, suivez le contrat de réponse strict dans livre de marque : lien/chemin PPTX, lien/chemin PDF et avertissement d'installation de polices uniquement.

Pour les autres sorties, retournez :

1. Les fichiers visuels et prévisualisations demandés.
2. Un résumé compact du verrou de marque.
3. Les étiquettes de format modifiable versus aplati.
4. Les limitations de polices/import requises.
5. Les noms de variantes stables pour les révisions ciblées.

Index des références

• Prérequis — dépendances locales spécifiques aux étapes et commandes d'installation.
• Réception — questions minimales et routage des entrées.
• Analyse des actifs — classification et mesure des actifs officiels/de référence.
• Routage d'état et charges utiles d'état — approbations persistantes.
• Verrou de marque — contraintes visuelles canoniques.
• Design Brain — direction artistique privée.
• Planches de concepts, charges utiles de prévisualisation et révisions en ligne — étapes de sélection.
• Logo, améliorateur d'invite de logo et charges utiles d'export de logo — génération SVG et variantes déterministes.
• Palette et typographie — emplacements fondamentaux.
• Maquettes, graphiques sociaux, affiches/bannières, emballage, signalétique et merchandising — applications.
• Présentations et livres de marque — documents modifiables.
• AQ et itération — pré-vérification, réparation, approbation et manifeste de livraison.