gpt-image-2
ConardLi/garden-skills
Permet de générer et de modifier des images à l'aide de GPT Image 2 selon trois modes : génération directe via une API compatible avec OpenAI, ingénierie de prompts pour les outils d'image natifs de l'hôte, ou simple conseil en matière de prompts. Comprend plus de 80 modèles structurés pour des affiches, des maquettes d'interface utilisateur, des visuels de produits, des cartes, des diapositives, etc.
...Développer toutGPT Image 2
Il s'agit d'une compétence ciblée pour GPT Image 2, utilisable dans les trois environnements d'exécution, mais dont le comportement varie considérablement. La première étape consiste à déterminer le mode d'exécution actuel.
Elle ne traite que deux types de tâches liées aux images :
- Génération d’images :
POST /images/generations - Modification d’images :
POST /images/edits
Ce document répertorie : le mode d’exécution, la structure de la compétence, les variables d’environnement, les règles d’enregistrement et de nommage, l’index des modèles, ainsi que le flux de travail adapté au mode. Tous les modèles détaillés se trouvent dans le répertoire references/, organisés en plusieurs niveaux :
- Premier niveau : répertoires de catégories
- Deuxième niveau : fichiers Markdown par modèle
Mode de fonctionnement (à lire impérativement ; à définir avant toute autre action)
Cette Skill intègre un script de détection léger. Exécutez-le une première fois, puis déterminez la marche à suivre en fonction des résultats :
node skills/ gpt-image-2/scripts/check-mode.js
# Pour obtenir des résultats structurés à utiliser par le programme en amont :
node skills/ gpt-image-2/scripts/check-mode.js --json
La sortie indiquera « mode = A / A? / B-or-C » ainsi qu’une recommandation. Les trois modes sont définis comme suit :
Mode A · Génération d’images en local avec Garden
Conditions de déclenchement: la variable d’environnement ENABLE_GARDEN_IMAGEGEN est définie sur « vrai » ( 1 / true / yes / on ) et la variable OPENAI_API_KEY est présente.
Comportement: exécution complète de bout en bout du processus « sélection d’un modèle → rédaction d’une prompt → appel du script → génération et enregistrement de l’image sur le disque ».
- Utilisez
scripts/generate.jspour générer des images à partir de texte etscripts/edit.jspour modifier des images existantes. - Par défaut, les prompts sont enregistrés dans le répertoire «
garden- gpt-image-2/prompt/» et les images dans «garden- gpt-image-2/image/». - C’est le mode le plus puissant : vous êtes le « propriétaire » de l’outil d’imagerie.
Mode B · Host-Native : délégation de la génération d’images à l’hôte
Conditions de déclenchement: Garden n’est pas activé ( ENABLE_GARDEN_IMAGEGEN n’est pas défini / vaut faux), mais l’Agent hôte actuel intègre un outil de génération d’images ou un MCP d’images.
Signes distinctifs typiques (à vérifier par vous-même) :
- la présence dans votre ensemble d’outils de noms tels que
image_generation/imagegen/dalle/nano_banana/mcp__*image*/make_image/ ou similaires - L’utilisateur appelle cette compétence dans un client prenant en charge la génération d’images native, tel que ChatGPT, Codex, Gemini ou Cursor
- L'utilisateur demande explicitement : « Génère une image avec ton propre outil »
Comportement: cette compétence se réduit alors à un simple guide de formulation de prompts —
- Continuez à suivre le processus « Sélectionner un modèle → Remplir les champs → Générer la prompt finale ».
- Ne pas appeler
les scripts Node / generate.js(absence de clé API, échec garanti). - Appeler directement l’outil d’image intégré à l’hôte, en utilisant la prompt rendue comme entrée.
- Si l’utilisateur le souhaite, il peut enregistrer le fichier de prompt dans
garden- gpt-image-2/prompt/, maisla destination de l’image est laissée à la discrétion de l’hôte et n’est pas obligatoire.
Mode C · Conseiller de prompts pur
Conditions de déclenchement: Garden n’est pas activé et l’Agent hôte ne dispose d’aucun outil de génération d’images.
Comportement: cette compétence se transforme alors en « conseiller en rédaction de prompts de haute qualité » —
- en suivant le processus « choisir un modèle → remplir les champs → générer la prompt finale », et en demandant des informations supplémentaires à l’utilisateur en cas de manque de données.
- La prompt finale est directement affichée à l’utilisateur et une copie est enregistrée sur
garden- gpt-image-2/prompt/.- .md - Ajoutez une brève suggestion d’utilisation (par exemple : « À utiliser avec ChatGPT / Midjourney / DALL·E / Sora / Nano Banana / votre propre backend / une passerelle GPT Image 2 tierce »).
- Ne donnez pas l’impression que la génération d’image a réussi. Indiquez clairement à l’utilisateur : « Une prompt de haute qualité, prête à l’emploi, a été générée. Veuillez l’exécuter avec votre outil d’imagerie. »
Tableau de décision des modèles
| Condition | Modèle | Appeler le script ? | Enregistrer la prompt sur le disque ? | Image de fin de disque ? |
|---|---|---|---|---|
ENABLE_GARDEN_IMAGEGEN=1 + clé présente |
A | ✅ generate.js / edit.js |
✅ Automatique | ✅ Automatique |
ENABLE_GARDEN_IMAGEGEN=1 mais pas de clé |
A ? | ❌ (il faut d'abord une clé) | — | — |
| Non activé + l’hôte dispose d’un outil d’image | B | ❌ (Utiliser l'outil de l'hôte) | Facultatif | À la discrétion de l’hôte |
| Non activé + l’hôte ne dispose pas d’outils graphiques | C | ❌ | ✅ Obligatoire | ❌ (impossible) |
Lorsque le mode n'est pas certain
- Si vous ne parvenez pas à déterminer si vous êtes en mode B ou C, demandez directement à l’utilisateur: « Souhaitez-vous générer l’image à l’aide des outils graphiques de votre environnement, ou suffit-il que je rédige la prompt ? »
- Échec de l'exécution du script en mode A (401 / réseau / quota) → signaler l'erreur et demander « Passer en mode B / C ? »
L'utilisateur indique l'outil
Lorsque cette compétence doit poser une question à l’utilisateur, respectez les règles suivantes :
- Utilisez en priorité l’outil de saisie utilisateur fourni par l’environnement d’exécution actuel.
- En l’absence d’outil adapté, posez des questions courtes sous forme de texte brut numéroté.
- Dans la mesure du possible, regroupez les questions pour les poser en une seule fois.
Structure de la compétence
scripts/check-mode.js: à exécuter en premier pour détecter le mode d’exécution (A / B / C)scripts/generate.js: génération d’images à partir de texte (utilisé uniquement en mode A)scripts/edit.js: modification de l’image à partir de l’image d’origine ou d’un masque (utilisé uniquement en mode A)scripts/shared.js: logique de partage des requêtes, d’enregistrement et de lecture des variables d’environnementreferences/: modèles de prompts structurés en couches (utilisés dans les trois modes A / B / C)
Variables d’environnement
La configuration est lue dans l'ordre suivant :
- Paramètres CLI
process.env/.env /.gateway.env ~/.gateway.env
Variables principales :
ENABLE_GARDEN_IMAGEGEN— Commutateur de mode. La valeur1/true/yes/onactive le mode A ; si cette variable n’est pas définie ou prend une autre valeur, le mode B / C est activé.OPENAI_API_KEY— Obligatoire en Mode A ; non requis en Modes B / C.OPENAI_BASE_URL— Par défaut :https://api.openai.com/v1; peut pointer vers une passerelle tierce compatible.OPENAI_IMAGE_MODEL— Par défautgpt-image-2, peut être remplacé par un modèle pris en charge par la passerelle (par exemplegpt-image-1/dall-e-3).
L’implémentation par défaut fonctionne selon l’interface compatible OpenAI, sans spécifier de passerelle tierce.
Répertoire de sortie par défaut
Si l’utilisateur n’a pas explicitement spécifié de chemin de sortie, le répertoire suivant situé dans l’espace de travail actuel est utilisé par défaut :
- Répertoire des prompts :
garden- gpt-image-2/prompt/( recommandé pour les trois modes A, B et C, afin de faciliter la réutilisation et la gestion des versions) - Répertoire des images :
garden- gpt-image-2/prompt/( utilisé uniquement en mode A; en mode B, c’est l’hôte qui décide ; en mode C, aucune image n’est générée)
Si le répertoire n’existe pas, le script (Mode A) doit le créer automatiquement ; pour les Modes B et C, il faut exécuter manuellement la commande ` mkdir -p ` avant d’écrire le prompt.
Règles de nommage par défaut
Si l’utilisateur n’a pas spécifié explicitement de nom de fichier, le script doit générer automatiquement un nom de fichier en rapport avec la tâche en cours, en y ajoutant l’horodatage actuel, afin d’éviter les conflits de noms.
Règles de nommage :
- Invite :
garden- gpt-image-2/prompt/- .md - Images :
garden- gpt-image-2/image/- .png
Dans ce cas :
: extrait automatiquement un nom court pertinent en fonction de la demande de l’utilisateur actuel: horodatage actuel, par exemple20260424-153045
Exemple :
garden- gpt-image-2/prompt/live-commerce-ui-20260424-153045.mdgarden- gpt-image-2/image/live-commerce-ui-20260424-153045.pnggarden- gpt-image-2/prompt/vue-en-détails-du-casque-VR-20260424-153102.mdgarden- gpt-image-2/image/vr-headset-exploded-view-20260424-153102.png
Règles d'enregistrement des prompts
| Mode | Faut-il enregistrer la consigne ? | Description |
|---|---|---|
| Mode A | ✅ Obligatoire | Doit être enregistré avant de passer à la phase de génération / d'édition |
| Mode B | Recommandé | Par défaut, il est conseillé de l'enregistrer pour faciliter sa réutilisation ; si l'utilisateur indique « Non », cette étape est ignorée |
| Mode C | ✅ Obligatoire | L'utilisateur récupère la ligne de commande et l'exécute lui-même ; si cela n'est pas enregistré sur le disque, c'est du temps perdu |
Règles générales (applicables aux trois modes) :
- Si l’utilisateur fournit explicitement le chemin d’accès au fichier de prompt, ce fichier peut être utilisé directement comme entrée.
- Si l'utilisateur fournit directement un prompt sous forme de texte, il faut tout d'abord enregistrer le prompt final dans
le répertoire garden- gpt-image-2/prompt/. - Si l’utilisateur spécifie explicitement l’option --prompt-output, le chemin d’accès indiqué par l’utilisateur
est respecté. - Sinon, le fichier est automatiquement enregistré selon la règle de nommage par défaut.
Règles d’enregistrement des images (Mode A uniquement)
- Si l'utilisateur spécifie explicitement les options
--imageou --output, le chemin d'accès indiqué par l'utilisateursera respecté. - Sinon, l’enregistrement s’effectue par défaut dans
garden- gpt-image-2/image/. - Le nom du fichier doit être en rapport avec la signification de la tâche en cours et comporter un horodatage.
En Mode B, c’est l’outil d’imagerie hôte qui détermine le mode d’enregistrement ; en Mode C, aucune image n’est générée.
Utilisation rapide
0. Détecter le mode d’exécution ( première étape de toute tâche )
node skills/ gpt-image-2/scripts/check-mode.js
La sortie vous indiquera si vous êtes actuellement en Mode A, B ou C, ce qui déterminera si vous devez ensuite appeler generate.js ou edit.js. Les étapes 1 à 4 ci-dessous ne s’appliquent qu’en Mode A.
1. Génération d’images à partir de texte (Mode A)
node skills/ gpt-image-2/scripts/generate.js \
--prompt "Un adorable bébé loutre de mer" \
--size 1024x1024 \
--quality high
2. Génération d’images à partir d’un fichier de prompts (Mode A)
node skills/ gpt-image-2/scripts/generate.js \
--promptfile garden- gpt-image-2/prompt/poster-20260424-153045.md
3. Modifier une image existante (Mode A)
node skills/ gpt-image-2/scripts/edit.js \
--image assets/source.png \
--prompt « Remplacer l'arrière-plan par un décor de studio épuré »
4. Retouche locale avec masque (Mode A)
node skills/ gpt-image-2/scripts/edit.js \
--image assets/source.png \
--mask assets/mask.png \
--prompt "Remplacer uniquement la zone masquée par un vase en verre"
5. « Utilisation » des modes B et C
Pas d’interface en ligne de commande — cette Skill ne sert ici que de guide de création de prompts:
- Mode B: générer la prompt finale → appeler l’outil de type «
image_generation» fourni par l’hôte (en transmettant la prompt dans les paramètres) → obtenir l’image. - Mode C: générer la prompt finale → l'enregistrer dans
garden- gpt-image-2/prompt/→ afficher directement le contenu à l'utilisateur → indiquer à l'utilisateur dans quels outils d'imagerie il peut la réutiliser directement.- .md
Fonctionnement des modèles JSON
Lorsqu’un modèle JSON est fourni dans le répertoire « references/ », il convient de l’utiliser selon les règles suivantes :
- Commencez par rechercher la catégorie la plus proche dans le fichier
SKILL.md. - Identifiez ensuite le fichier de modèle correspondant.
- Dans le modèle,
{argument ...}représente un paramètre remplaçable. - Les valeurs explicitement fournies par l’utilisateur sont directement renseignées.
- Si l’utilisateur n’a pas fourni de valeur mais que le modèle indique «
default», vous pouvez dans un premier temps utiliser la valeur par défaut. - Si l’absence d’informations est susceptible d’affecter considérablement le résultat, demandez-le activement à l’utilisateur.
- L’utilisateur peut également demander explicitement « génère-le de manière aléatoire » ; dans ce cas, vous pouvez conserver les valeurs par défaut ou procéder à une randomisation raisonnable dans les limites autorisées par le modèle.
Règles d’interrogation
Lorsque des variables clés manquent dans le modèle, évitez de poser une question vague telle que « Quel style souhaitez-vous ? ». Posez plutôt des questions précises en fonction des champs du modèle.
Par exemple, si un modèle d’interface utilisateur de diffusion en direct ne comporte pas d’élément principal, il convient de demander en priorité :
- Qui est le streamer ?
- Faut-il utiliser une photo réelle, le nom d’une célébrité, une description du personnage, ou opter pour une génération entièrement aléatoire ?
Lorsque les informations sur le produit manquent, demandez :
- Quel est le nom du produit ?
- Le prix du produit est-il spécifié ?
- Souhaitez-vous que je complète automatiquement le contenu des commentaires et des cadeaux ?
Index des modèles
Ne lire que les fichiers de modèles spécifiques les plus pertinents en fonction du type de tâche, sans lire l'intégralité du répertoire references/ en une seule fois.
1. Documentation générale sur la méthodologie
À lire en premier :
references/prompt-writing.md
S'applique lorsque :
- vous n’avez pas encore décidé comment structurer le modèle JSON
- Vous devez déterminer quels champs doivent faire l’objet d’une requête, lesquels peuvent être définis par défaut et lesquels peuvent être aléatoires
- Vous avez besoin de transformer vos cas d’utilisation en modèles réutilisables
2. Maquettes d’interface utilisateur ( references/ui-mockups/ )
Convient à toutes sortes de maquettes visuelles de type « interface + contenu ». Déjà disponibles :
live-commerce-ui.md— Maquette d’écran de vente en direct sur une plateforme e-commerce (animateur + zone de discussion + zone de cadeaux + fiche produit)social-interface-mockup.md— Maquette de la page de détail d’une publication sur les réseaux sociaux (Twitter/X, Xiaohongshu, Weibo, Threads, etc.)product-card-overlay.md— Image principale d’une page d’accueil ou d’une page de détail (personnage + produit + argument de vente + prix)chat-interface-scene.md— Maquette d’interface de chat / conversation (iMessage, WeChat, discussion de groupe, assistant IA)short-video-cover-ui.md— Couverture de vidéo courte / vignette de live (YouTube, Douyin, Bilibili, stream VTuber)landing-page-case-study.md— Maquette d’interface utilisateur pour une longue page d’étude de cas SaaS / marketing en mode sombre (plusieurs sections + narration par défilement + fiches de données + CTA)
3. Visuels produit ( references/product-visuals/ )
Images adaptées à une approche « centrée sur le produit ». Déjà mises en œuvre :
exploded-view-poster.md— Affiche de vue éclatée du produit (élément principal empilé verticalement + légende + logo en haut + zone de marque en bas)white-background-product.md— Image principale e-commerce sur fond blanc (produit unique / plusieurs angles / superposition marketing minimaliste)premium-studio-product.md— Image de produit commerciale prise en studio haut de gamme (ambiance digne d’une publicité de magazine)packaging-showcase.md— Images de présentation des coffrets cadeaux / emballages (boîte extérieure + présentation du contenu)lifestyle-product-scene.md— Photos de produits en situation (produits intégrés dans des scènes de la vie quotidienne)ecommerce-marketing-board.md— Tableau de vente ultra-composite pour le commerce électronique à la chinoise (image principale + page de détails + arguments de vente + mode d’emploi + mise en situation + storyboard de spot TV, le tout sur une seule image)
4. Cartes ( references/maps/ )
Convient aux « visuels de type carte » (les infographies ont été transférées dans la catégorie distincte n° 17). Actuellement mis en œuvre :
food-map.md— Carte gastronomique urbaine dessinée à la main (points numérotés + légende + mascotte centrale)travel-route-map.md— Carte d’itinéraires de voyage (circuits de plusieurs jours / balades urbaines d’une journée / itinéraires de plein air)illustrated-city-map.md— Carte illustrée de la ville (monuments + paysages + éléments culturels)store-distribution-map.md— Carte de répartition des magasins de la marque / de la couverture des servicesitinerary-day-trip-map.md— Affiche en deux parties pour une excursion d’une journée (à gauche : fiche d’itinéraire sur fond de parchemin + à droite : carte fantastique et réaliste, avec 5 à 7 étapes parfaitement alignées)
5. Diapositives et documents visuels ( references/slides-and-visual-docs/ )
Documents visuels adaptés au principe « une seule page pour expliquer clairement un sujet ». Déjà mis en œuvre :
dense-explainer-slides.md— Diapositives explicatives à haute densité combinant Irasutoya et Kasumigasekipolicy-style-slide.md— Diapositive de présentation de style « politique / communiqué gouvernemental / livre blanc »visual-report-page.md— Page de synthèse de rapport commercial / présentation aux investisseurs / aperçu du rapport annueleducational-diagram-slide.md— Diagramme pédagogique (concepts / mécanismes / décomposition des processus)
6. Affiches et campagnes ( references/poster-and-campaigns/ )
Convient aux « visuels principaux de marque + campagnes + bannières + couvertures de magazines ». Déjà mis en œuvre :
brand-poster.md— Affiche principale de la marque (produit / personnage / message textuel)campaign-kv.md— Visuel clé de campagne + système de mises en page dérivéesbanner-hero.md— Bannières web / pages de destination / bannières d’application (composition horizontale + CTA)editorial-cover.md— Couverture de magazine / revue / publicationbiomimetic-concept-poster.md— Affiche conceptuelle de design industriel biomimétique (prototype naturel → barre d’évolution → rendu hero → schémas techniques multi-vues)vintage-editorial-infographic.md— Archives vintage / Affiche infographique éditoriale des années 1940 (personnages + formules + chronologie + maquettes, style Bell Labs)character-catalog-poster.md— Affiche infographique présentant plusieurs versions d’un même personnage (cartes de série sur les signes du zodiaque / les éléments / les dynasties / la personnalité)lineup-comparison-poster.md— Affiche infographique comparant une gamme de produits (plus de 30 références sur une même image + légende + échelle de classement)
7. Portraits et personnages ( references/portraits-and-characters/ )
Convient à la « représentation visuelle des personnages ». Déjà mis en œuvre :
professional-portrait.md— Portrait professionnel de qualité (LinkedIn / page d’équipe / illustrations pour les médias)founder-portrait.md— Portraits de fondateurs destinés aux médias (éclairage théâtral + emplacement réservé au titre)virtual-host.md— Fiche personnelle de VTuber / animateur virtuel + aperçu du livecharacter-sheet.md— Fiche de personnage complète (vues en trois dimensions + expressions faciales + tenues + palette de couleurs)pose-reference-sheet.md— Tableau de référence N×N des poses / mouvements (plusieurs poses pour un même personnage : danse / combat / fitness)
8. Scènes et illustrations ( references/scenes-and-illustrations/ )
Illustrations visuelles adaptées à l’« ambiance + histoire + émotions ». Déjà mises en place :
healing-scene.md— Illustrations de scènes quotidiennes ou saisonnières apaisantesconcept-scene.md— Scènes conceptuelles de grande envergure au style cinématographique / visuels clés d’IPpicture-book-scene.md— Livres pour enfants / pages d’albums illustrés / cartes de vœuxminimalist-mood-scene.md— Images d’ambiance minimalistes avec des espaces vides / Fonds d’écran littéraires
9. Workflows d’édition ( references/editing-workflows/ )
Tâches de retouche adaptées à « l’édition à partir d’images existantes » (correspondant à scripts/edit.js ). Actuellement mises en œuvre :
background-replacement.md— Remplacement d’arrière-plan (produits / portraits / extérieur / décors de studio)local-object-replacement.md— Remplacement d’objets localisés (avec ou sans masque)object-removal.md— Suppression d’éléments indésirables / de passants / de câbles / d’imperfectionsproduct-retouching.md— Retouche de produits (brillance / étiquettes / ombres / imperfections)portrait-local-edit.md— Retouche locale de portraits (coiffure / vêtements / maquillage / accessoires)
10. Avatars et profil ( references/avatars-and-profile/ )
Convient aux visuels de type « image personnelle » tels que « avatars stylisés / personnages / grilles / autocollants / séries de portraits ». Déjà mis en œuvre :
style-transfer-selfie.md— Transforme le personnage de l’image de référence en n’importe quel style : cosplay, gothique, film rétro, photos d’idoles, etc.character-grid-portrait.md— Portraits d’un même personnage sous forme de grille n×n (plusieurs classes / plusieurs expressions / plusieurs époques / plusieurs styles)themed-3d-icon.md— Avatars de type icônes d’application en 3D : kawaii, Minecraft ou 3D skeuomorphiquesticker-set.md— Ensembles d’autocollants / collections d’émojis (éléments individuels + contours + étiquettes)cultural-portrait-series.md— Série de portraits par époque / mythologie / littérature / ethnies
11. Storyboards et séquences ( references/storyboards-and-sequences/ )
Convient aux visuels de type « séquences narratives » tels que « storyboards / bandes dessinées / diagrammes relationnels / étapes de processus ». Déjà mis en œuvre :
four-panel-comic.md— Bande dessinée en 4 cases / caricature / bande dessinée humoristique (introduction, développement, tournant, conclusion + bulles de dialogue)manga-spread-page.md— Plan de bande dessinée sur une page ou un double-page (cases irrégulières + dialogues + pensées)anime-key-visual.md— Visuel clé d’anime (image unique) / couverture de light novel / affiche d’IPcharacter-relationship-diagram.md— Affiche représentant les relations entre les personnages (cartes + liens + légende)recipe-process-flowchart.md— Recettes / Tutoriels / Organigrammes de procédure (numérotation + illustrations + explications)product-tvc-storyboard.md— Storyboard de spot publicitaire TV (9 cases avec rendu filmé + description des plans + durée)cinematic-storyboard-grid.md— Planche de contact de storyboard narratif de style cinématographique (3×4 / 4×4, narration continue + images fixes de style cinématographique)process-photo-board.md— Planche de travail cinématographique avec des personnes réelles (équipement / maquillage / entraînement / décomposition des gestes, numérotation + progression des étapes)
12. Grilles et collages ( references/grids-and-collages/ )
Convient aux visuels de type « grilles à plusieurs panneaux / collages / tableaux de projet ». Déjà mis en œuvre :
banner-grid-2x2.md— Ensemble de bannières marketing 2×2 (4 visuels d’une même série générés en une seule fois)lookbook-grid.md— Lookbook de 7 jours / Grille de 9 cases sur les soins personnels / Liste des TOP Nmixed-style-multi-panel.md— Collage mixte de styles (interprétations de styles variés autour d’un même thème)anime-pitch-board.md— Tableau de présentation de projets d’animation, de jeux vidéo et de cinéma (image clé + personnages + univers + texte)ad-banner-multi-grid.md— Grille de bannières publicitaires mixtes (plusieurs secteurs / plusieurs thèmes) (chaque case correspondant à un secteur, un style et un texte publicitaire distincts)
13. Image de marque et packaging ( references/branding-and-packaging/ )
Convient aux visuels de type « système d’identité de marque / mascotte / conception d’emballage ». Déjà mis en œuvre :
brand-identity-board.md— Tableau de système d’identité de marque (logo + palette de couleurs + police + maquettes d’application)mascot-brand-kit.md— Kit d’identité de marque à plusieurs panneaux pour mascotte (image principale + trois vues + expressions + applications)cosmetic-packaging.md— Emballages de cosmétiques / soins de la peau : flacons individuels / gammes / coffrets cadeauxbeverage-label-design.md— Conception d’étiquettes pour boissons / aliments / condiments (style « national tendance » / japonais / occidental)full-mascot-brand-doc.md— Identité visuelle complète comprenant plus de 18 modules + documentation complète sur le processus de création de la mascotte (ADN / moodboard / croquis / dessins au trait / 3D / palette de couleurs / matériaux / aperçu des applications en une seule image)character-merch-board.md— Tableau de marque complet regroupant plusieurs éléments : personnages IP + produits dérivés / emballages / affiches / profils sur les réseaux sociaux
14. Typographie et mise en page du texte ( references/typography-and-text-layout/ )
Convient aux types de projets où « le texte est l’élément visuel principal », tels que « le texte d’abord » ou les « mises en page bilingues ». Déjà mis en œuvre :
title-safe-poster.md— Affiches à message fort en gros caractères (style japonais dynamique / minimalisme suisse / impression rétro)bilingual-layout-visual.md— Visuels de mise en page bilingues chinois-anglais / chinois-japonais (marques culturelles / universitaires / interculturelles)
15. Ressources et accessoires ( references/assets-and-props/ )
Convient aux visuels de type « ensembles de ressources / ressources de jeux », tels que les « collections d’icônes / captures d’écran de jeux ». Exemples déjà mis en œuvre :
retro-skeuomorphic-icons.md— Jeu d’icônes skeuomorphiques / Y2K / pixelisées (style cohérent et unifié)game-screenshot-mockup.md— Maquette de capture d'écran de jeu (HUD + sous-titres + panneau de quêtes)
16. Figures académiques ( references/academic-figures/ )
Illustrations adaptées aux « articles de recherche / soumissions à des conférences de haut niveau / affiches académiques / présentations PowerPoint de soutenance / soutenances de projet de thèse / résumés graphiques pour soumissions à des revues ».Fond globalement blanc + polices de publication + géométrie précise + couleurs techniques peu saturées (principalement bleu foncé / bleu-gris / gris-noir, ≤ 3 couleurs principales) + imprimables en monochrome. Il est strictement interdit d’inventer des données quantitatives (valeurs / courbes de niveau / plages de couleurs / formules).
Domaines CS / CV / ML :
method-pipeline-overview.md— schéma d’aperçu de la méthode / figure de pipeline (blocs multi-étapes + flux de données ; la variante 4 propose une feuille de route technique en trois parties : gauche / centre / droite, de type ingénierie)neural-network-architecture.md— Schéma de l’architecture du réseau neuronal (blocs de couches + forme des tenseurs + connexions)qualitative-comparison-grid.md— Grille de comparaison qualitative multi-méthodes ( lignes = échantillons, colonnes = méthodes )
Commun à l’ingénierie, aux sciences naturelles et aux soutenances de thèse :
scientific-schematic.md— Schéma conceptuel / de principe / de dispositif expérimental (grande liberté de formulation, modèle en langage naturel)mechanism-diagram.md— Schéma de mécanisme / liens de causalité / voies de transformation (objet central + transformation en plusieurs étapes + zone de résultats ; comprend trois variantes : chaîne de causalité en trois étapes / auto-excitation cyclique / concurrence à plusieurs branches)multi-condition-comparison.md— Tableau comparatif des résultats sous plusieurs conditions (résultats juxtaposés d’un même objet sous différentes conditions, 2×2 / 1×N / M×N ; insistons sur une uniformité stricte entre les panneaux)publication-chart.md— Graphiques de données prêts à être publiés (barres / lignes / nuages de points / cartes thermiques / boîtes)
Aperçu / Résumé / Page d’accueil de la soutenance :
graphical-abstract.md— Résumé graphique pour soumission à une revue (quatre variantes : horizontal à 4 sections / déploiement central / carré / format portrait)research-overview-poster.md— Affiche de synthèse de recherche pour la présentation du sujet, la soutenance ou le rapport (trois niveaux : haut, milieu, bas + cinq modules ; comprend trois variantes : disposition radiale centrée, double colonne gauche-droite et minimaliste)
Stratégie de sélection : pour les articles en CS/CV/ML, privilégier
« method-pipeline-overview »+« qualitative-comparison-grid »; pour les domaines de l’ingénierie, de l’énergie, de la chimie et des matériaux, privilégier la variante 4 de« method-pipeline-overview »+ «mechanism-diagram» +« multi-condition-comparison» ;Pour les résumés destinés aux revues, utiliser «graphical-abstract» ; pour la page d’accueil des présentations PowerPoint de soutenance, utiliser «research-overview-poster».
17. Infographies ( references/infographics/ )
Convient aux « infographies / vulgarisations scientifiques à haute densité d’informations / infographies dessinées à la main / tableaux de bord KPI » et autres « grandes images de visualisation d’informations ». Modèles actuellement disponibles :
legend-heavy-infographic.md— Vulgarisation scientifique à forte densité de légendes / chaînes causales / évolution / schémas anatomiques (bilingues)hand-drawn-infographic.md— infographie de style dessin à la main (macaron / morandi / tableau noir / papier kraft ; modèle en langage naturel)bento-grid-infographic.md— Infographie modulaire de type « bento » (disposition de widgets à haute densité et à modules multiples)comparison-infographic.md— Infographies comparatives binaires / multiples (A vs B / niveaux de forfait / idées reçues vs vérités)step-by-step-infographic.md— Infographie tutorielle étape par étape (style illustré, chaleureux ; hors diagrammes de processus techniques)kpi-dashboard-infographic.md— Infographie de type tableau de bord KPI (rétrospective annuelle / « Wrapped » / tableau de bord métier)
18. Schémas techniques ( references/technical-diagrams/ )
Convient aux schémas techniques tels que « architecture système / processus / chronologie / machine à états / ER / carte mentale / topologie réseau ». Fond en grille sombre uniforme + police à espacement fixe + palette de couleurs codée par rôle ; chaque modèle est accompagné d’une variante « light ».
⚠️ Attention : ce répertoire génère des images bitmap au format PNG, et non des fichiers SVG modifiables; si vous avez besoin de fichiers modifiables, veuillez utiliser Mermaid / Draw.io / Excalidraw / Figma. Modèles actuellement disponibles :
system-architecture.md— Schéma d’architecture système (front-end + back-end + base de données + cache + file d’attente + éléments externes)flowchart-decision.md— Organigramme / diagramme de décision (sémantique des formes BPMN + branches Oui/Non)sequence-diagram.md— Diagramme de séquence (acteur + ligne de vie + flèches de message + barre d’activation)state-machine.md— Machine à états / diagramme de cycle de vie (état + transition + condition / action)er-diagram.md— Diagramme ER / Diagramme de modèle de données (entité + champ + clé primaire/clé étrangère + relation « patte de corbeau »)mind-map-tech.md— Carte mentale sur un thème technique (centre + branches radiales)network-topology.md— Schéma de topologie réseau (icônes d’équipements + zones / VPC + bande passante / protocoles)
Workflow des mots-clés (sensible au contexte)
Que ce soit A, B ou C, les 6 premières étapes sont communes; la seule différence réside dans la manière de « générer le diagramme » aux étapes 7 et 8.
- Exécuter
check-mode.jspour déterminer le mode (A / B / C). - Déterminez si la tâche consiste à créer ou à modifier un diagramme.
- Identifier à quelle catégorie elle appartient (voir « Index des modèles » ci-dessous).
- Ne lire que le fichier de modèle spécifique correspondant, sans lire l’intégralité du répertoire references/ en une seule fois.
- Respectez strictement le format des modèles : la plupart des modèles utilisent un modèle principal au format JSON (de préférence pour les tâches structurées), tandis que quelques modèles (
infographics/hand-drawn-infographic.md,academic-figures/scientific-schematic.md, etc.) utilisent un format mixte « langage naturel structuré + paramètres », car l’utilisation forcée du JSON limiterait la liberté de création. - Mettez en correspondance les entrées de l’utilisateur avec les paramètres du modèle ; lorsque les informations clés sont insuffisantes, posez de manière proactive des questions de clarification ciblées.
À ce stade, la prompt est prête. La procédure se divise ensuite selon deux modes :
7-A. Mode A: enregistrer la prompt finale dans garden- gpt-image-2/prompt/, appeler scripts/generate.js ou scripts/edit.js ; l’image est alors placée dans garden- gpt-image-2/image/.
7-B. Mode B: transmettre directement la prompt finale à l’outil d’imagerie de l’hôte pour qu’il l’appelle ;Enregistrer une copie de la consigne à la demande sur garden- gpt-image-2/prompt /.
7-C. Mode C: enregistrer la consigne finale sur garden- gpt-image-2/prompt/ la consigne complète à l'utilisateur dans la conversation, accompagnée d'une brève suggestion sur « comment l'utiliser / les outils recommandés ».
- À la fin de la tâche, indiquer à l’utilisateur en une phrase : quel est le mode actuel, où se trouve le prompt et où se trouvent les images (le cas échéant).
Contraintes importantes
Généralités :
- Le JSON contenu dans le fichier de modèle correspond à un modèle de structure de prompt, et non à un modèle de corps de requête API.
- Dans les trois modes, ce qui est finalement transmis au modèle d’image est la « chaîne de prompt rendue » — il peut s’agir d’un JSON « aplati » ou d’un paragraphe en langage naturel structuré ; utilisez-le tel quel, conformément au modèle.
- Sauf demande expresse de l’utilisateur, ne copiez pas la « description du mode » contenue dans le fichier SKILL.md dans la prompt finale — il s’agit de métadonnées destinées à l’Agent.
Valable uniquement pour le mode A :
- Le script de génération utilise un corps JSON
- Le script d’édition utilise des données de formulaire multipart
- La réponse est analysée en priorité selon
data[0].b64_json, mais est également compatible avecdata[0].url - À moins que l’interface en amont ne l’exige expressément, n’ajoutez pas de paramètres de requête spéciaux
Quand poser une question
Ne poser des questions que lorsque ces informations font défaut et que cela affecte significativement les résultats :
- Absence d’objectif de prompt
- Pas d’image d’origine lors de la modification d’une image
- L’identité du sujet ou le style visuel déterminent l’orientation des résultats
- Le produit, le prix, le texte publicitaire ou le texte de l’interface utilisateur constituent des éléments centraux de l’image
- L’utilisateur a exprimé simultanément plusieurs objectifs contradictoires
Dans ce cas, il convient de définir soi-même une valeur par défaut raisonnable et de s’y tenir.
---
name: gpt-image-2
description: Generates and edits images using GPT Image 2 across three modes: direct generation via OpenAI-compatible API, prompt engineering for host-native image tools, or pure prompt advisory. Includes 80+ structured templates for posters, UI mockups, product visuals, maps, slides, and more.
---
# GPT Image 2
这是一个面向 GPT Image 2 的聚焦型技能,在 3 种运行环境下都能用,但行为差异显著。**第一步必须先确定当前运行模式**。
它只做两类图像任务:
- 生成图片:`POST /images/generations`
- 编辑图片:`POST /images/edits`
本文件保留:运行模式、技能结构、环境变量、保存 / 命名规则、模板索引、模式感知工作流。详细模板全部放在 `references/`,分层组织:
- 一级:分类目录
- 二级:单模板 Markdown 文件
## 运行模式(必读,做任何事之前先确定)
本 Skill 自带一个轻量探测脚本,先跑一次,再根据结果决定怎么干活:
```bash
node skills/gpt-image-2/scripts/check-mode.js
# 想拿结构化结果给上层程序用:
node skills/gpt-image-2/scripts/check-mode.js --json
```
输出会给出 `mode = A` / `A?` / `B-or-C` 以及 `recommendation`。三个模式定义如下:
### Mode A · Garden 本地生图
**触发条件**:环境变量 `ENABLE_GARDEN_IMAGEGEN` 为真(`1` / `true` / `yes` / `on`)**且** 存在 `OPENAI_API_KEY`。
**行为**:完整端到端跑通"选模板 → 写 prompt → 调用脚本 → 出图落盘"。
- 用 `scripts/generate.js` 文本生图、`scripts/edit.js` 编辑现有图。
- prompt 默认落盘到 `garden-gpt-image-2/prompt/`、图片落盘到 `garden-gpt-image-2/image/`。
- 这是最强的模式:你是图像工具的"持有者"。
### Mode B · Host-Native 委托宿主出图
**触发条件**:未启用 Garden(`ENABLE_GARDEN_IMAGEGEN` 未设置 / 为假),但**当前宿主 Agent 自带图像生成工具或图像 MCP**。
**典型识别信号**(你应该自检):
- 你的工具集里出现 `image_generation` / `imagegen` / `dalle` / `nano_banana` / `mcp__*image*` / `make_image` / 类似名字
- 用户在 ChatGPT / Codex / Gemini / Cursor 等支持原生出图的客户端中调用本 Skill
- 用户显式说"用你自己的工具出图"
**行为**:本 Skill **退化成提示词工程指引**——
1. 仍按"选模板 → 填字段 → 渲染最终 prompt"的流程走。
2. **不要调用 `node scripts/generate.js`**(没有 API key、必失败)。
3. 直接调用宿主自带的图像工具,把渲染好的 prompt 作为输入。
4. 如用户希望可顺手把 prompt 文件保存到 `garden-gpt-image-2/prompt/`,但图片去向由宿主决定,不强制。
### Mode C · Advisor 纯提示词顾问
**触发条件**:未启用 Garden,**且**宿主 Agent 也没有任何图像生成工具。
**行为**:本 Skill 退化为"高质量 prompt 撰写顾问"——
1. 按"选模板 → 填字段 → 渲染最终 prompt"流程走,缺信息就问用户。
2. 把最终 prompt **直接打印给用户** + 保存一份到 `garden-gpt-image-2/prompt/<task-slug>-<timestamp>.md`。
3. 附一句简短的"如何使用"建议(如:丢进 ChatGPT / Midjourney / DALL·E / Sora / Nano Banana / 自己后端 / 第三方 GPT Image 2 网关)。
4. **不要假装出图成功**。明确告知用户:"已生成可直接复用的高质量 prompt,请用你的图像工具执行。"
### 模式决策表
| 条件 | 模式 | 调用脚本? | 落盘 prompt? | 落盘图片? |
|---|---|---|---|---|
| `ENABLE_GARDEN_IMAGEGEN=1` + 有 KEY | **A** | ✅ `generate.js` / `edit.js` | ✅ 自动 | ✅ 自动 |
| `ENABLE_GARDEN_IMAGEGEN=1` 但没 KEY | A? | ❌(先要 KEY) | — | — |
| 未启用 + 宿主有图像工具 | **B** | ❌(用宿主工具) | 可选 | 由宿主决定 |
| 未启用 + 宿主无图像工具 | **C** | ❌ | ✅ 必须 | ❌(无法) |
### 模式不确定时
- 如果你判断不清自己是 B 还是 C,**直接问用户一句**:"是用你环境里的图像工具出图,还是只要我写好提示词?"
- Mode A 调脚本失败(401 / 网络 / 配额)→ 报错并询问"切到 B / C 吗?"
## 用户输入工具
当此技能需要向用户提问时,遵循以下规则:
1. 优先使用当前运行时提供的用户输入工具。
2. 如果没有对应工具,则用简短的纯文本编号问题提问。
3. 能合并的问题尽量一次问完。
## 技能结构
- `scripts/check-mode.js`:**先跑这个**,检测运行模式(A / B / C)
- `scripts/generate.js`:文本生图(仅 Mode A 使用)
- `scripts/edit.js`:基于原图 / 遮罩改图(仅 Mode A 使用)
- `scripts/shared.js`:共享请求、保存、环境变量读取逻辑
- `references/`:分层结构化提示词模板(A / B / C 三模式都用)
## 环境变量
按以下顺序读取配置:
1. CLI 参数
2. `process.env`
3. `<cwd>/.env`
4. `<cwd>/.gateway.env`
5. `~/.gateway.env`
核心变量:
- `ENABLE_GARDEN_IMAGEGEN` — **模式开关**。`1` / `true` / `yes` / `on` 时启用 Mode A;未设置或其它值则进入 Mode B / C。
- `OPENAI_API_KEY` — Mode A 必需;B / C 不需要。
- `OPENAI_BASE_URL` — 默认 `https://api.openai.com/v1`,可指向第三方兼容网关。
- `OPENAI_IMAGE_MODEL` — 默认 `gpt-image-2`,可换成网关支持的型号(如 `gpt-image-1` / `dall-e-3`)。
默认实现按 OpenAI 兼容接口工作,不写死任何第三方网关。
## 默认输出目录
如果用户没有明确指定输出路径,统一使用当前工作区下的:
- 提示词目录:`garden-gpt-image-2/prompt/`(**A / B / C 三种模式都建议用**,方便复用与版本管理)
- 图片目录:`garden-gpt-image-2/image/`(**仅 Mode A 使用**;Mode B 由宿主决定,Mode C 不产生图)
如果目录不存在,脚本(Mode A)必须自动创建;Mode B / C 在写 prompt 前手动 `mkdir -p`。
## 默认命名规则
如果用户没有明确指定文件名,脚本应自动生成与当前任务相关的文件名,并追加当前时间戳,避免重名。
命名规则:
- 提示词:`garden-gpt-image-2/prompt/<task-slug>-<timestamp>.md`
- 图片:`garden-gpt-image-2/image/<task-slug>-<timestamp>.png`
其中:
- `<task-slug>`:根据当前用户要求自动提取一个相关短名称
- `<timestamp>`:当前时间戳,例如 `20260424-153045`
示例:
- `garden-gpt-image-2/prompt/live-commerce-ui-20260424-153045.md`
- `garden-gpt-image-2/image/live-commerce-ui-20260424-153045.png`
- `garden-gpt-image-2/prompt/vr-headset-exploded-view-20260424-153102.md`
- `garden-gpt-image-2/image/vr-headset-exploded-view-20260424-153102.png`
## Prompt 保存规则
| 模式 | 是否必须保存 prompt | 说明 |
|---|---|---|
| Mode A | ✅ 必须 | 进入实际生成 / 编辑流程必落盘 |
| Mode B | 推荐 | 默认建议保存方便复用;用户说"不用"就略过 |
| Mode C | ✅ 必须 | 用户拿走 prompt 自己执行,不落盘等于白干 |
通用规则(适用三种模式):
1. 如果用户显式给了 prompt 文件路径,可直接使用该文件作为输入。
2. 如果用户直接给的是文本 prompt,也要先把最终 prompt 保存到 `garden-gpt-image-2/prompt/`。
3. 如果用户显式指定了 `--prompt-output`,则尊重用户指定路径。
4. 否则使用默认命名规则自动保存。
## 图片保存规则(仅 Mode A)
1. 如果用户显式指定了 `--image` 或 `--output`,则尊重用户指定路径。
2. 否则默认保存到 `garden-gpt-image-2/image/`。
3. 文件名应和当前任务语义相关,并附加时间戳。
Mode B 由宿主图像工具决定保存方式;Mode C 不产生图片。
## 快速用法
### 0. 检测运行模式(**任何任务的第一步**)
```bash
node skills/gpt-image-2/scripts/check-mode.js
```
输出会告诉你当前是 Mode A / B / C,决定后续是否调用 `generate.js` / `edit.js`。下面 1~4 仅在 **Mode A** 下使用。
### 1. 文本生图(Mode A)
```bash
node skills/gpt-image-2/scripts/generate.js \
--prompt "A cute baby sea otter" \
--size 1024x1024 \
--quality high
```
### 2. 用提示词文件生图(Mode A)
```bash
node skills/gpt-image-2/scripts/generate.js \
--promptfile garden-gpt-image-2/prompt/poster-20260424-153045.md
```
### 3. 编辑已有图片(Mode A)
```bash
node skills/gpt-image-2/scripts/edit.js \
--image assets/source.png \
--prompt "Replace the background with a clean studio scene"
```
### 4. 带遮罩的局部编辑(Mode A)
```bash
node skills/gpt-image-2/scripts/edit.js \
--image assets/source.png \
--mask assets/mask.png \
--prompt "Replace only the masked area with a glass vase"
```
### 5. Mode B / C 的"用法"
没有命令行入口——本 Skill 此时只是**提示词工程指南**:
- **Mode B**:渲染好最终 prompt → 调用宿主自带的 `image_generation` 类工具(参数中传入 prompt)→ 拿到图。
- **Mode C**:渲染好最终 prompt → 保存到 `garden-gpt-image-2/prompt/<task-slug>-<timestamp>.md` → 把内容直接展示给用户 → 提示用户在哪些图像工具中可以直接复用。
## JSON 模板工作方式
当 `references/` 中提供 JSON 模板时,按下面规则使用:
1. 先从 `SKILL.md` 找到最贴近的分类目录。
2. 再定位到具体模板文件。
3. 模板中的 `{argument ...}` 表示可替换参数。
4. 用户明确提供的值,直接填入。
5. 用户没有提供,但模板标了 `default` 的,默认可以先用默认值。
6. 如果缺失信息会显著影响结果,主动询问用户。
7. 用户也可以明确说“你随机生成”,这时可以保留默认值或在模板允许范围内合理随机化。
## 询问规则
当模板缺少关键变量时,不要笼统地问“你想要什么风格?”。应当根据模板字段精确提问。
例如直播 UI 模板缺少主体时,应优先问:
- 主播是谁?
- 用真人照片、名人名字、人物描述,还是完全随机生成?
缺少商品信息时应问:
- 商品名称是什么?
- 商品价格是否指定?
- 是否希望我自动补全评论和礼物内容?
## 模板索引
按任务类型只读取最贴近的具体模板文件,不要一次性全读整个 `references/`。
### 1. 方法论总文档
先读:
- `references/prompt-writing.md`
适用于:
- 你还没决定怎么构造 JSON 模板
- 你需要判断哪些字段该问、哪些字段可默认、哪些字段可随机
- 你需要把案例抽象成可复用模板
### 2. UI Mockups (`references/ui-mockups/`)
适合各种“界面 + 内容”的样机视觉。当前已落地:
- `live-commerce-ui.md` — 电商直播带货截图样机(主播 + 聊天区 + 礼物区 + 商品卡)
- `social-interface-mockup.md` — 社交平台动态详情页样机(Twitter/X、小红书、微博、Threads 等)
- `product-card-overlay.md` — 落地页 hero / 详情页主图(人物 + 商品 + 卖点 + 价格)
- `chat-interface-scene.md` — 聊天 / 对话界面样机(iMessage、微信、群聊、AI 助手)
- `short-video-cover-ui.md` — 短视频封面 / 直播缩略图(YouTube、抖音、B 站、VTuber stream)
- `landing-page-case-study.md` — 深色 SaaS / 营销 case study **长页面** UI mockup(多 section + 滚动叙事 + 数据卡 + CTA)
### 3. Product Visuals (`references/product-visuals/`)
适合“以商品为视觉中心”的图。当前已落地:
- `exploded-view-poster.md` — 产品爆炸视图海报(主体垂直堆叠 + callout + 顶部 logo + 底部品牌区)
- `white-background-product.md` — 电商纯白底主图(单品 / 多角度 / 极简营销叠层)
- `premium-studio-product.md` — 高级影棚商业产品图(杂志广告级氛围)
- `packaging-showcase.md` — 礼盒 / 包装展示图(外盒 + 内容物展示)
- `lifestyle-product-scene.md` — 生活方式产品场景图(商品出现在真实场景中)
- `ecommerce-marketing-board.md` — 中式电商超复合销售看板(主图 + 详情页 + 卖点 + 使用步骤 + 场景 + TVC 分镜组合一图)
### 4. Maps (`references/maps/`)
适合“地图类视觉”(信息图已抽离到独立分类 17)。当前已落地:
- `food-map.md` — 城市美食手绘地图(编号点位 + 图例 + 中心吉祥物)
- `travel-route-map.md` — 旅行路线图(多日行程 / 单日 city walk / 户外路线)
- `illustrated-city-map.md` — 城市风貌插画地图(地标 + 江山 + 文化元素)
- `store-distribution-map.md` — 品牌门店 / 服务覆盖分布图
- `itinerary-day-trip-map.md` — **一日游** split 海报(左 parchment 行程卡 + 右奇幻写实地图,5-7 站点严格对齐)
### 5. Slides & Visual Docs (`references/slides-and-visual-docs/`)
适合“一页讲清楚一件事”的视觉文档。当前已落地:
- `dense-explainer-slides.md` — Irasutoya × 霞关混合高密度讲解 Slide
- `policy-style-slide.md` — 政策 / 政府公告 / 白皮书风格说明 Slide
- `visual-report-page.md` — 商业报告执行摘要 / 投资人简报 / 年报概览页
- `educational-diagram-slide.md` — 教学示意图(概念 / 机制 / 流程分解)
### 6. Poster & Campaigns (`references/poster-and-campaigns/`)
适合“品牌主视觉 + campaign + banner + 杂志封面”。当前已落地:
- `brand-poster.md` — 品牌主海报(产品 / 人物 / 纯文字主张)
- `campaign-kv.md` — Campaign Key Visual + 衍生 layout 系统
- `banner-hero.md` — Web hero / 落地页 / app banner(横向构图 + CTA)
- `editorial-cover.md` — 杂志 / 期刊 / 出版物封面
- `biomimetic-concept-poster.md` — 仿生工业设计概念海报(自然原型 → 演化条 → hero render → 多视图技术图)
- `vintage-editorial-infographic.md` — 复古档案 / 1940s 编辑式信息图海报(人物 + 公式 + 时间轴 + 模型,Bell Labs 风)
- `character-catalog-poster.md` — 同一角色多版本信息图海报(星座 / 元素 / 朝代 / 人格系列卡片)
- `lineup-comparison-poster.md` — 系列产品 lineup 对比信息图海报(30+ SKU 同图 + 图例 + 等级 key)
### 7. Portraits & Characters (`references/portraits-and-characters/`)
适合“人物视觉”。当前已落地:
- `professional-portrait.md` — 职业级商务肖像(LinkedIn / 团队页 / 媒体配图)
- `founder-portrait.md` — 创始人媒体大片肖像(戏剧灯光 + 留标题位)
- `virtual-host.md` — VTuber / 虚拟主播个人卡 + 直播预览
- `character-sheet.md` — 角色综合设定稿(三视图 + 表情 + 服装 + 配色板)
- `pose-reference-sheet.md` — N×N 姿势 / 动作字典参考表(同一角色多姿势,舞蹈 / 战斗 / 健身)
### 8. Scenes & Illustrations (`references/scenes-and-illustrations/`)
适合 “氛围 + 故事 + 情绪” 的插画类视觉。当前已落地:
- `healing-scene.md` — 治愈系日常 / 季节场景插画
- `concept-scene.md` — 电影感概念大场景 / IP key art
- `picture-book-scene.md` — 童书 / 绘本内页 / 节日卡片
- `minimalist-mood-scene.md` — 极简留白氛围图 / 文学性壁纸
### 9. Editing Workflows (`references/editing-workflows/`)
适合“基于现有图片做编辑”的图改任务(对应 `scripts/edit.js`)。当前已落地:
- `background-replacement.md` — 背景替换(商品 / 人像 / 户外 / 棚景)
- `local-object-replacement.md` — 局部对象替换(配合或不配合蒙版)
- `object-removal.md` — 杂物 / 路人 / 电线 / 瑕疵去除
- `product-retouching.md` — 产品精修(光泽 / 标签 / 阴影 / 瑕疵)
- `portrait-local-edit.md` — 人像局部修改(发型 / 服装 / 妆容 / 配饰)
### 10. Avatars & Profile (`references/avatars-and-profile/`)
适合“风格化头像 / 人设 / 网格 / 贴纸 / 系列肖像”等"个人形象"类视觉。当前已落地:
- `style-transfer-selfie.md` — 把参考图人物转成 cosplay / 哥特 / 复古胶片 / 偶像写真等任意风格
- `character-grid-portrait.md` — 同一角色 n×n 网格肖像(多职业 / 多表情 / 多朝代 / 多风格)
- `themed-3d-icon.md` — Kawaii 3D / Minecraft / 拟物 3D 应用图标式头像
- `sticker-set.md` — 贴纸套装 / 表情包合集(独立元素 + 描边 + 标签)
- `cultural-portrait-series.md` — 朝代 / 神话 / 文学 / 民族系列肖像
### 11. Storyboards & Sequences (`references/storyboards-and-sequences/`)
适合“多分镜 / 漫画 / 关系图 / 流程步骤”等"叙事性序列"类视觉。当前已落地:
- `four-panel-comic.md` — 4 格漫画 / 讽刺漫画 / 段子漫画(起承转合 + 对话气泡)
- `manga-spread-page.md` — 单页 / 跨页漫画分镜(不规则格子 + 对话 + 心声)
- `anime-key-visual.md` — 单图动漫 KV / 轻小说封面 / IP 海报
- `character-relationship-diagram.md` — 角色关系图海报(卡片 + 关系连线 + 图例)
- `recipe-process-flowchart.md` — 食谱 / 教程 / 流程步骤图(编号 + 插图 + 说明)
- `product-tvc-storyboard.md` — 产品 TVC 商业广告分镜板(9-panel 实拍质感 + 镜头描述 + 时长)
- `cinematic-storyboard-grid.md` — **电影感叙事分镜** contact sheet(3×4 / 4×4,连续叙事 + cinematic still)
- `process-photo-board.md` — 真人 cinematic 流程板(装备穿戴 / 化妆 / 训练 / 操作分解,编号 + 步骤递进)
### 12. Grids & Collages (`references/grids-and-collages/`)
适合“多面板网格 / 拼贴 / 立项 board”类视觉。当前已落地:
- `banner-grid-2x2.md` — 2×2 营销 banner 套装(一次出 4 张统一系列设计)
- `lookbook-grid.md` — 7 日 lookbook / 9 宫 self-care / TOP N 清单图
- `mixed-style-multi-panel.md` — 多风格混合拼贴(同一主体不同画风演绎)
- `anime-pitch-board.md` — 动漫 / 游戏 / 影视立项 pitch board(KV + 角色 + 世界观 + 文案)
- `ad-banner-multi-grid.md` — 多行业 / 多主题混合广告 banner 网格(每格独立行业 + 风格 + 文案)
### 13. Branding & Packaging (`references/branding-and-packaging/`)
适合“品牌识别系统 / 吉祥物 / 包装设计”类视觉。当前已落地:
- `brand-identity-board.md` — 品牌识别系统板(logo + 配色 + 字体 + 应用 mockup)
- `mascot-brand-kit.md` — 吉祥物多面板品牌识别套装(主形象 + 三视图 + 表情 + 应用)
- `cosmetic-packaging.md` — 化妆品 / 护肤品 单瓶 / 系列 / 礼盒包装
- `beverage-label-design.md` — 饮料 / 食品 / 调味品标签设计(国潮 / 日式 / 西式)
- `full-mascot-brand-doc.md` — **18+ 模块大型品牌识别 + 吉祥物全流程文档**(DNA / moodboard / 草图 / 线稿 / 3D / 配色 / 材质 / 应用一图概览)
- `character-merch-board.md` — IP 角色 + 周边 / 包装 / 海报 / 社交 profile 多元素综合品牌板
### 14. Typography & Text Layout (`references/typography-and-text-layout/`)
适合“字面优先 / 双语版式”等"以文字为主视觉"的类型。当前已落地:
- `title-safe-poster.md` — 大字主张型海报(日式高能量 / 瑞士极简 / 复古印刷)
- `bilingual-layout-visual.md` — 中英 / 中日双语版式视觉(文化 / 学术 / 跨文化品牌)
### 15. Assets & Props (`references/assets-and-props/`)
适合“图标集 / 游戏截图”等"成套素材 / 游戏资产"类视觉。当前已落地:
- `retro-skeuomorphic-icons.md` — 拟物 / Y2K / 像素 图标集(成套统一风格)
- `game-screenshot-mockup.md` — 游戏内截图 mockup(HUD + 字幕 + 任务面板)
### 16. Academic Figures (`references/academic-figures/`)
适合“论文 / 顶会投稿 / 学术海报 / 答辩 PPT / 开题答辩 / 期刊投稿 Graphical Abstract”的配图。整体偏白底 + 出版物字体 + 几何精确 + 低饱和工程色(深蓝 / 灰蓝 / 黑灰为主,≤3 主色)+ 可单色印刷。**严格禁止虚构定量数据**(数值 / 等值线 / 色标范围 / 公式)。
CS / CV / ML 方向:
- `method-pipeline-overview.md` — 方法总览图 / pipeline figure(多 stage 块 + 数据流;变体 4 提供工程类左/中/右 三段式技术路线图)
- `neural-network-architecture.md` — 神经网络架构图(layer 块 + tensor shape + 跳连)
- `qualitative-comparison-grid.md` — 多方法 qualitative 对比网格(**行 = 样本,列 = 方法**)
工程 / 自然科学 / 答辩通用:
- `scientific-schematic.md` — 概念 / 原理 / 实验装置示意图(自由度高,自然语言模板)
- `mechanism-diagram.md` — 机理示意图 / 因果链路 / 转化路径(中心对象 + 多阶段转化 + 结果区;含三段式因果链 / 循环自激发 / 多分支竞争 三种变体)
- `multi-condition-comparison.md` — **多工况 / 多条件结果对比图**(同一对象在不同 condition 下的并列结果,2×2 / 1×N / M×N;强调 panel 间严格统一)
- `publication-chart.md` — publication-ready 数据图表(bar / line / scatter / heatmap / box)
总览 / 摘要 / 答辩首页:
- `graphical-abstract.md` — 期刊投稿 Graphical Abstract / 图形摘要(横向 4 段式 / 中心展开 / 方形 / 竖版四种变体)
- `research-overview-poster.md` — 开题 / 答辩 / 汇报首页研究总览图(上中下三层 + 五模块;含中心辐射 / 左右双栏 / 极简 三种变体)
> 选择策略:CS/CV/ML 论文首选 `method-pipeline-overview` + `qualitative-comparison-grid`;工程 / 能源 / 化工 / 材料方向首选 `method-pipeline-overview` 变体 4 + `mechanism-diagram` + `multi-condition-comparison`;投稿期刊摘要图用 `graphical-abstract`;答辩 PPT 首页用 `research-overview-poster`。
### 17. Infographics (`references/infographics/`)
适合“信息图 / 高密度科普 / 手绘信息图 / KPI 仪表盘”等"信息可视化大图"。当前已落地:
- `legend-heavy-infographic.md` — 高图例密度科普 / 因果链 / 演化 / 解剖图(双语)
- `hand-drawn-infographic.md` — **手绘风**信息图(macaron / morandi / 黑板 / 牛皮纸;自然语言模板)
- `bento-grid-infographic.md` — 便当格模块化信息图(高密度多模块 widget 排布)
- `comparison-infographic.md` — 二元 / 多元对比信息图(A vs B / 套餐档位 / 误区 vs 正解)
- `step-by-step-infographic.md` — 步骤教程信息图(插画感、温暖;非工程流程图)
- `kpi-dashboard-infographic.md` — KPI 仪表盘式信息图(年度回顾 / Wrapped / 业务 dashboard)
### 18. Technical Diagrams (`references/technical-diagrams/`)
适合“系统架构 / 流程 / 时序 / 状态机 / ER / 思维导图 / 网络拓扑”等工程示意图。统一暗色 grid 背景 + 等宽字体 + 角色编码配色,每个模板都附 light 变体。
⚠️ 注意:本目录生成的是 **PNG 位图**,**不是可编辑 SVG**;需要可编辑请改用 mermaid / draw.io / excalidraw / Figma。当前已落地:
- `system-architecture.md` — 系统架构图(前端 + 后端 + DB + 缓存 + 队列 + 外部)
- `flowchart-decision.md` — 流程图 / 决策图(BPMN 形状语义 + Yes/No 分支)
- `sequence-diagram.md` — 时序图(actor + lifeline + 消息箭头 + 激活条)
- `state-machine.md` — 状态机 / 生命周期图(state + transition + guard / action)
- `er-diagram.md` — ER 图 / 数据模型图(实体 + 字段 + PK/FK + crow's foot 关系)
- `mind-map-tech.md` — 技术主题思维导图(中央 + 放射式分支)
- `network-topology.md` — 网络拓扑图(设备 glyph + zone / VPC + 带宽 / 协议标)
## 提示词工作流(模式感知)
无论 A / B / C,**前 6 步是共用的**;区别只在第 7-8 步如何"出图"。
1. **跑 `check-mode.js` 确定模式**(A / B / C)。
2. 判断任务是生图还是改图。
3. 识别它属于哪个分类目录(参考下方"模板索引")。
4. 只读取对应的具体模板文件,**不要一次读整个 references/**。
5. 严格遵循模板格式:大部分模板用 JSON 主模板(结构化任务首选),少数模板(`infographics/hand-drawn-infographic.md`、`academic-figures/scientific-schematic.md` 等)使用「结构化自然语言 + 参数」混合形式,因为强行 JSON 会限制创作自由。
6. 把用户输入映射到模板参数;关键信息不足时主动发起有针对性的澄清问题。
到此 prompt 已渲染好。下面按模式分叉:
7-A. **Mode A**:把最终 prompt 保存到 `garden-gpt-image-2/prompt/`,调用 `scripts/generate.js` 或 `scripts/edit.js`,图片落到 `garden-gpt-image-2/image/`。
7-B. **Mode B**:把最终 prompt 直接传给宿主的图像工具调用;按需保存 prompt 副本到 `garden-gpt-image-2/prompt/`。
7-C. **Mode C**:把最终 prompt 保存到 `garden-gpt-image-2/prompt/<task-slug>-<timestamp>.md`,并把完整 prompt 在对话中展示给用户,附一句简短的"如何使用 / 推荐工具"建议。
8. 任务结束后用一句话告诉用户:当前模式是什么、prompt 落在哪、图(如有)落在哪。
## 重要约束
通用:
- 模板文件中的 JSON 是**提示词结构模板**,不是 API 请求体模板。
- 三种模式下,最终交给图像模型的都是"渲染后的 prompt 字符串"——可以是拍平的 JSON、可以是结构化自然语言段落,按模板原样使用。
- 除非用户明确要求,否则**不要把 SKILL.md 里的"模式说明"复制到最终 prompt 里**——那是给 Agent 看的元信息。
仅 Mode A 适用:
- 生成脚本使用 JSON body
- 编辑脚本使用 multipart form data
- 响应优先按 `data[0].b64_json` 解析,也兼容 `data[0].url`
- 除非上游接口明确要求,不额外引入特殊 query 参数
## 何时提问
只在这些信息缺失且会显著影响结果时提问:
- 没有 prompt 目标
- 改图时没有原图
- 主体身份或视觉类型决定结果走向
- 商品 / 价格 / 文案 / UI 文本是画面核心组成部分
- 用户同时表达了多个互相冲突的目标
除此之外,优先自己做合理默认并继续执行。
Tous les fichiers
103 fichiersInstaller gpt-image-2
Téléchargez et décompressez les fichiers de compétences dans votre répertoire .claude/skills/.
Télécharger le ZIPClonez le dépôt et copiez les fichiers de compétence dans votre projet.
git clone https://github.com/ConardLi/garden-skills/tree/main/skills/gpt-image-2 # Copy SKILL.md to your .claude/skills/ directory
Copier





Maison
