opción

Genera y edita imágenes mediante GPT Image 2 en tres modos diferentes: generación directa a través de una API compatible con OpenAI, ingeniería de prompts para herramientas de imagen nativas del sistema operativo o asesoramiento puro sobre prompts. Incluye más de 80 plantillas estructuradas para carteles, maquetas de interfaz de usuario, imágenes de productos, mapas, diapositivas y mucho más.

...Expandir todo
0
Tiempo actualizado 30 de septiembre de 2026

GPT Image 2

Esta es una habilidad específica para GPT Image 2 que funciona en tres entornos distintos, aunque su comportamiento varía considerablemente en cada uno de ellos. El primer paso consiste en determinar el modo de funcionamiento actual.

Solo realiza dos tipos de tareas relacionadas con imágenes:

  • Generación de imágenes: POST /images/generations
  • Edición de imágenes: POST /images/edits

Este documento recoge: el modo de funcionamiento, la estructura de la habilidad, las variables de entorno, las reglas de guardado y nomenclatura, el índice de plantillas y el flujo de trabajo sensible al modo. Todas las plantillas detalladas se encuentran en la carpeta «references/», organizadas en niveles:

  • Nivel 1: directorios de categorías
  • Nivel 2: archivos Markdown de plantillas individuales

Modo de ejecución (lectura obligatoria; hay que determinarlo antes de hacer nada)

Esta Skill incluye un script de detección ligero; ejecútalo primero y, según los resultados, decide cómo proceder:

node skills/ gpt-image-2/scripts/check-mode.js
# Si se desea obtener resultados estructurados para utilizarlos en un programa de nivel superior:
node skills/ gpt-image-2/scripts/check-mode.js --json

La salida mostrará «mode = A / A? / B-or-C» junto con una recomendación. Los tres modos se definen de la siguiente manera:

Modo A · Generación de imágenes local con Garden

Condiciones de activación: la variable de entorno ENABLE_GARDEN_IMAGEGEN es verdadera ( 1 / true / yes / on ) y existe OPENAI_API_KEY.

Comportamiento: se ejecuta de principio a fin todo el proceso: «seleccionar plantilla → escribir prompt → ejecutar el script → generar la imagen y guardarla en el disco».

  • Utiliza scripts/generate.js para generar imágenes a partir de texto y scripts/edit.js para editar imágenes existentes.
  • Por defecto, las indicaciones se guardan en garden- gpt-image-2/prompt/, y las imágenes en garden- gpt-image-2/image /.
  • Este es el modo más potente: tú eres el «propietario» de la herramienta de imágenes.

Modo B · Host-Native: delegar la generación de imágenes al agente anfitrión

Condiciones de activación: Garden no está habilitado ( ENABLE_GARDEN_IMAGEGEN no está configurado o es falso), pero el agente anfitrión actual incorpora una herramienta de generación de imágenes o un MCP de imágenes.

Señales típicas de identificación (deberías comprobarlo tú mismo):

  • En tu conjunto de herramientas aparecen nombres similares a image_generation / imagegen / dalle / nano_banana / mcp__*image* / make_image /
  • El usuario invoca esta Skill en clientes que admiten la generación nativa de imágenes, como ChatGPT, Codex, Gemini o Cursor
  • El usuario dice explícitamente «genera la imagen con tu propia herramienta»

Comportamiento: esta habilidad se reduce a una guía de ingeniería de prompts,

  1. Sigue el proceso habitual: «seleccionar plantilla → rellenar campos → generar el prompt final».
  2. No se deben invocar los scripts de Node ni generate.js (no hay clave API, por lo que fallará inevitablemente).
  3. Accede directamente a la herramienta de imágenes integrada en el sistema anfitrión y utiliza el prompt renderizado como entrada.
  4. Si el usuario lo desea, puede guardar el archivo de la indicación en garden- gpt-image-2/prompt/, pero el destino de la imagen lo decide el anfitrión; no es obligatorio.

Modo C · Asesor de prompts puros

Condiciones de activación: Garden no está habilitado y el agente anfitrión tampoco dispone de ninguna herramienta de generación de imágenes.

Comportamiento: esta Skill se reduce a un «asesor para la redacción de prompts de alta calidad» —

  1. siguiendo el proceso «seleccionar plantilla → rellenar campos → generar el prompt final»; si falta información, se pregunta al usuario.
  2. Muestra el prompt final directamente al usuario y guarda una copia en garden- gpt-image-2/prompt/ - .md.
  3. Añade una breve recomendación sobre «cómo utilizarlo» (por ejemplo: «introdúcelo en ChatGPT / Midjourney / DALL·E / Sora / Nano Banana / tu propio backend / una pasarela GPT Image 2 de terceros»).
  4. No simules que la generación de la imagen ha tenido éxito. Indica claramente al usuario: «Se ha generado un prompt de alta calidad listo para su uso inmediato; por favor, ejecútalo con tu herramienta de imágenes».

Tabla de decisiones de patrones

Condición Patrón ¿Se ejecuta el script? ¿Guardar el prompt en el disco? ¿Imagen de «discos en el plato»?
ENABLE_GARDEN_IMAGEGEN=1 + con clave A ✅ generate.js / edit.js ✅ Automático ✅ Automático
ENABLE_GARDEN_IMAGEGEN=1 pero sin clave A? ❌ (primero hace falta la clave) — —
No está activado + el host dispone de herramientas de imagen B ❌ (utilizar la herramienta del host) Opcional A decisión del anfitrión
No activado + el host no dispone de herramientas de imagen C ❌ ✅ Obligatorio ❌ (no es posible)

Cuando el modo no está claro

  • Si no tienes claro si eres B o C, pregunta directamente al usuario: «¿Quieres que genere la imagen con las herramientas de tu entorno o basta con que escriba la indicación?».
  • Si falla la ejecución del script en el modo A (401 / red / cuota) → mostrar un mensaje de error y preguntar: «¿Cambias al modo B o C?».

El usuario indica la herramienta

Cuando esta habilidad necesite hacer una pregunta al usuario, sigue las siguientes reglas:

  1. Da prioridad a la herramienta de entrada de usuario que ofrezca el entorno de ejecución actual.
  2. Si no hay ninguna herramienta adecuada, formula preguntas breves con números en texto sin formato.
  3. Si es posible agrupar las preguntas, se formularán todas de una sola vez.

Estructura de la habilidad

  • scripts/check-mode.js: se ejecuta primero para detectar el modo de funcionamiento (A / B / C)
  • scripts/generate.js: generación de imágenes a partir de texto (solo se utiliza en el modo A)
  • scripts/edit.js: edición de imágenes a partir de la imagen original o una máscara (solo se utiliza en el modo A)
  • scripts/shared.js: lógica para compartir solicitudes, guardar y leer variables de entorno
  • references/: plantillas de prompts estructuradas por niveles (utilizadas en los tres modos: A, B y C)

Variables de entorno

La configuración se lee en el siguiente orden:

  1. Parámetros de la CLI
  2. process.env
  3. /.env
  4. /.gateway.env
  5. ~/.gateway.env

Variables principales:

  • ENABLE_GARDEN_IMAGEGEN — Conmutador de modo. Cuando se establece en 1 / true / yes / on, se activa el Modo A; si no se configura o se establece en cualquier otro valor, se activa el Modo B / C.
  • OPENAI_API_KEY — Obligatorio en el Modo A; no es necesario en los Modos B y C.
  • OPENAI_BASE_URL — Por defecto, https://api.openai.com/v1; puede apuntar a una pasarela compatible de terceros.
  • OPENAI_IMAGE_MODEL — Por defecto gpt-image-2 , se puede cambiar por un modelo compatible con la pasarela (por ejemplo, gpt-image-1 / dall-e-3 ).

La implementación predeterminada funciona según la interfaz compatible con OpenAI, sin especificar ninguna pasarela de terceros de forma fija.

Directorio de salida predeterminado

Si el usuario no especifica explícitamente la ruta de salida, se utilizará de forma unificada la siguiente, ubicada en el espacio de trabajo actual:

  • Directorio de prompts: garden- gpt-image-2/prompt/ ( se recomienda su uso en los tres modos A, B y C, para facilitar la reutilización y la gestión de versiones)
  • Directorio de imágenes: garden- gpt-image-2/image/ ( solo se utiliza en el Modo A; en el Modo B lo decide el anfitrión, y en el Modo C no se generan imágenes)

Si el directorio no existe, el script (Modo A) debe crearlo automáticamente; en los Modos B y C, hay que ejecutar manualmente «mkdir -p » antes de escribir el prompt.

Reglas de nomenclatura predeterminadas

Si el usuario no especifica explícitamente un nombre de archivo, el script debe generar automáticamente un nombre relacionado con la tarea actual y añadirle la marca de tiempo actual, para evitar nombres duplicados.

Reglas de nomenclatura:

  • Prompt: garden- gpt-image-2/prompt/ - .md
  • Imágenes: garden- gpt-image-2/image/ - .png

En este caso:

  • : extrae automáticamente un nombre corto relevante según la solicitud del usuario actual
  • : marca de tiempo actual, por ejemplo, 20260424-153045

Ejemplo:

  • 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/vista-desmontada-de-casco-vr-20260424-153102.md
  • garden- gpt-image-2/image/vr-headset-exploded-view-20260424-153102.png

Reglas de guardado de Prompt

Modo ¿Es obligatorio guardar el prompt? Descripción
Modo A ✅ Obligatorio Se debe guardar en el disco para iniciar el proceso de generación o edición
Modo B Recomendado Se recomienda guardarlo de forma predeterminada para facilitar su reutilización; si el usuario indica que «no es necesario», se omite
Modo C ✅ Obligatorio El usuario debe copiar el prompt y ejecutarlo por su cuenta; si no se guarda en el disco, no sirve de nada

Reglas generales (aplicables a los tres modos):

  1. Si el usuario proporciona explícitamente la ruta del archivo de prompt, se puede utilizar directamente dicho archivo como entrada.
  2. Si el usuario proporciona directamente un prompt de texto, también debe guardar primero el prompt final en garden- gpt-image-2/prompt /.
  3. Si el usuario especifica explícitamente --prompt- output, se respetará la ruta indicada por el usuario.
  4. De lo contrario, se guardará automáticamente siguiendo la regla de nomenclatura predeterminada.

Reglas de guardado de imágenes (solo en el Modo A)

  1. Si el usuario especifica explícitamente --image o --output, se respetará la ruta indicada por el usuario.
  2. De lo contrario, se guardarán por defecto en garden- gpt-image-2/image /.
  3. El nombre del archivo debe estar relacionado con la semántica de la tarea actual e incluir una marca de tiempo.

En el Modo B, la herramienta de imágenes del host determina el método de guardado; en el Modo C no se generan imágenes.

Uso rápido

0. Detectar el modo de ejecución ( primer paso de cualquier tarea )

node skills/ gpt-image-2/scripts/check-mode.js

La salida te indicará si actualmente estás en el Modo A, B o C, lo que determinará si se debe llamar a generate.js o edit.js a continuación. Los pasos 1 a 4 que se indican a continuación solo se utilizan en el Modo A.

1. Generación de imágenes a partir de texto (Modo A)

node skills/ gpt-image-2/scripts/generate.js \
  --prompt "Una linda cría de nutria marina" \
  --size 1024x1024 \
  --quality high

2. Generación de imágenes con un archivo de indicaciones (Modo A)

node skills/ gpt-image-2/scripts/generate.js \
  --promptfile garden- gpt-image-2/prompt/poster-20260424-153045.md

3. Editar una imagen existente (Modo A)

node skills/ gpt-image-2/scripts/edit.js \
  --image assets/source.png \
  --prompt "Reemplaza el fondo por un escenario de estudio limpio"

4. Edición parcial con máscara (Modo A)

node skills/ gpt-image-2/scripts/edit.js \
  --image assets/source.png \
  --mask assets/mask.png \
  --prompt "Sustituye solo el área enmascarada por un jarrón de cristal"

5. «Uso» de los modos B y C

No hay acceso desde la línea de comandos; en este caso, esta Skill solo sirve como guía de ingeniería de prompts:

  • Modo B: renderizar la indicación final → invocar la herramienta de tipo «image_generation» integrada en el sistema anfitrión (pasando la indicación como parámetro) → obtener la imagen.
  • Modo C: generar la indicación final → guardarla en garden- gpt-image-2/prompt/ - .md → mostrar el contenido directamente al usuario → indicar al usuario en qué herramientas de imágenes puede reutilizarla directamente.

Funcionamiento de las plantillas JSON

Cuando se proporcionan plantillas JSON en la carpeta «references/», se utilizan según las siguientes reglas:

  1. En primer lugar, busca en SKILL.md la categoría más cercana.
  2. A continuación, localiza el archivo de plantilla concreto.
  3. En la plantilla, {argument ...} indica un parámetro sustituible.
  4. Los valores proporcionados explícitamente por el usuario se introducen directamente.
  5. Si el usuario no ha proporcionado ningún valor, pero la plantilla indica «default», se puede utilizar primero el valor por defecto.
  6. Si la falta de información afecta significativamente al resultado, consulta al usuario de forma proactiva.
  7. El usuario también puede indicar expresamente «genera aleatoriamente»; en ese caso, se pueden mantener los valores por defecto o realizar una aleatorización razonable dentro de los límites permitidos por la plantilla.

Normas para las preguntas

Cuando falte una variable clave en la plantilla, no se debe preguntar de forma genérica «¿qué estilo prefieres?». Se deben formular preguntas precisas en función de los campos de la plantilla.

Por ejemplo, si en una plantilla de interfaz de usuario para retransmisiones en directo falta el tema principal, se debe preguntar en primer lugar:

  • ¿Quién es el presentador?
  • ¿Se utilizará una foto real, el nombre de un famoso, una descripción del personaje o se generará de forma totalmente aleatoria?

Si falta información sobre el producto, se debe preguntar:

  • ¿Cuál es el nombre del producto?
  • ¿Se ha especificado el precio del producto?
  • ¿Quieres que complete automáticamente el contenido de los comentarios y los regalos?

Índice de plantillas

Lee solo los archivos de plantillas específicos más cercanos según el tipo de tarea; no leas todo el directorio «references/» de una sola vez.

1. Documentación general sobre metodología

Leer primero:

  • references/prompt-writing.md

Aplicable a:

  • Aún no has decidido cómo estructurar la plantilla JSON
  • Necesitas determinar qué campos debes solicitar, cuáles pueden tener valores por defecto y cuáles pueden ser aleatorios
  • Necesitas abstraer los casos en plantillas reutilizables

2. Maquetas de interfaz de usuario ( references/ui-mockups/ )

Adecuadas para maquetas visuales de todo tipo de «interfaz + contenido». Actualmente disponibles:

  • live-commerce-ui.md — Maqueta de captura de pantalla de una venta en directo de comercio electrónico (presentador + zona de chat + zona de regalos + ficha de producto)
  • social-interface-mockup.md — Maqueta de la página de detalles de publicaciones en redes sociales (Twitter/X, Xiaohongshu, Weibo, Threads, etc.)
  • product-card-overlay.md — Imagen principal de la página de destino o de detalles (persona + producto + argumentos de venta + precio)
  • chat-interface-scene.md — Maqueta de la interfaz de chat o conversación (iMessage, WeChat, chats grupales, asistente de IA)
  • short-video-cover-ui.md — Portada de vídeos cortos / Miniaturas de retransmisiones en directo (YouTube, Douyin, Bilibili, retransmisiones de VTuber)
  • landing-page-case-study.md — Maqueta de la interfaz de usuario de una página larga de un caso práctico de SaaS o marketing en modo oscuro (varias secciones + narrativa con desplazamiento + fichas de datos + CTA)

3. Imágenes del producto ( references/product-visuals/ )

Imágenes adecuadas para un «enfoque visual centrado en el producto». Actualmente implementadas:

  • exploded-view-poster.md — Cartel con vista desmontada del producto (elemento principal apilado verticalmente + llamada de atención + logotipo en la parte superior + zona de marca en la parte inferior)
  • white-background-product.md — Imagen principal para comercio electrónico con fondo blanco puro (producto individual / múltiples ángulos / superposición minimalista de marketing)
  • premium-studio-product.md — Imagen comercial de producto en estudio de alta calidad (ambiente propio de un anuncio de revista)
  • packaging-showcase.md — Imágenes de presentación de cajas de regalo y embalajes (caja exterior + presentación del contenido)
  • lifestyle-product-scene.md — Imágenes de productos en entornos de estilo de vida (el producto aparece en un entorno real)
  • ecommerce-marketing-board.md — Cartel de ventas multifuncional al estilo chino para comercio electrónico (imagen principal + página de detalles + argumentos de venta + pasos de uso + escenarios + storyboard de TVC, todo en una sola imagen)

4. Mapas ( references/maps/ )

Adecuado para «elementos visuales de tipo mapa» (las infografías se han extraído a una categoría independiente: 17). Actualmente implementado:

  • food-map.md — Mapa gastronómico de la ciudad dibujado a mano (puntos numerados + leyenda + mascota central)
  • travel-route-map.md — Mapa de rutas de viaje (itinerarios de varios días / paseos urbanos de un día / rutas al aire libre)
  • illustrated-city-map.md — Mapa ilustrado del paisaje urbano (lugares emblemáticos + paisajes + elementos culturales)
  • store-distribution-map.md — Mapa de distribución de tiendas de la marca / cobertura de servicios
  • itinerary-day-trip-map.md — Cartel dividido para excursiones de un día (a la izquierda, tarjeta de itinerario en papel pergamino; a la derecha, mapa de estilo fantástico-realista; con 5-7 paradas alineadas con precisión)

5. Diapositivas y documentos visuales ( references/slides-and-visual-docs/ )

Documentos visuales adecuados para «explicar una cosa en una sola página». Actualmente se han implementado:

  • dense-explainer-slides.md — Diapositivas explicativas de alta densidad que combinan Irasutoya y Kasumigaseki
  • policy-style-slide.md — Diapositiva explicativa al estilo de políticas, anuncios gubernamentales o libros blancos
  • visual-report-page.md — Página de resumen ejecutivo de informes empresariales / presentaciones para inversores / resumen de informes anuales
  • educational-diagram-slide.md — Diagrama didáctico (conceptos / mecanismos / desglose de procesos)

6. Carteles y campañas ( references/poster-and-campaigns/ )

Adecuado para «imagen visual principal de la marca + campaña + banner + portada de revista». Actualmente se han implementado:

  • brand-poster.md — Cartel principal de marca (producto / persona / mensaje de texto puro)
  • campaign-kv.md — Imagen clave de la campaña + sistema de maquetación derivado
  • banner-hero.md — Imagen principal web / página de destino / banner de aplicación (composición horizontal + CTA)
  • editorial-cover.md — Portadas de revistas, publicaciones periódicas y otras publicaciones
  • biomimetic-concept-poster.md — Cartel conceptual de diseño industrial biomimético (prototipo natural → barra de evolución → renderización principal → diagramas técnicos con múltiples vistas)
  • vintage-editorial-infographic.md — Archivo vintage / Cartel informativo editorial al estilo de los años 40 (personajes + fórmulas + línea temporal + maquetas, estilo Bell Labs)
  • character-catalog-poster.md — Cartel infográfico con múltiples versiones de un mismo personaje (tarjetas de series de signos del zodiaco / elementos / dinastías / personalidades)
  • lineup-comparison-poster.md — Cartel infográfico comparativo de una gama de productos (más de 30 referencias en una misma imagen + leyenda + clave de clasificación)

7. Retratos y personajes ( references/portraits-and-characters/ )

Adecuado para «imágenes de personas». Actualmente implementado:

  • professional-portrait.md — Retrato profesional de nivel empresarial (LinkedIn / página del equipo / imágenes para medios de comunicación)
  • founder-portrait.md — Retrato de fundador con estilo cinematográfico (iluminación teatral + espacio para el título)
  • virtual-host.md — Ficha personal de VTuber / presentador virtual + vista previa de la retransmisión
  • character-sheet.md — Ficha completa del personaje (tres vistas + expresiones faciales + vestuario + paleta de colores)
  • pose-reference-sheet.md — Tabla de referencia N×N de posturas y movimientos (varias posturas del mismo personaje: danza / combate / entrenamiento)

8. Escenas e ilustraciones ( references/scenes-and-illustrations/ )

Imágenes ilustrativas adecuadas para «ambiente + historia + emociones». Actualmente disponibles:

  • healing-scene.md — Ilustraciones de escenas cotidianas o estacionales de carácter reconfortante
  • concept-scene.md — Escenas conceptuales de gran formato con estilo cinematográfico / arte clave de la propiedad intelectual
  • picture-book-scene.md — Libros infantiles / Páginas de cuentos ilustrados / Tarjetas festivas
  • minimalist-mood-scene.md — Imágenes atmosféricas minimalistas con espacios en blanco / fondos de pantalla de carácter literario

9. Flujos de trabajo de edición ( references/editing-workflows/ )

Tareas de edición de imágenes adecuadas para «editar a partir de imágenes existentes» (correspondientes a scripts/edit.js ). Actualmente implementadas:

  • background-replacement.md — Sustitución de fondo (productos / retratos / exteriores / escenas de estudio)
  • local-object-replacement.md — Sustitución de objetos locales (con o sin máscara)
  • object-removal.md — Eliminación de elementos superfluos / transeúntes / cables / imperfecciones
  • product-retouching.md — Retoque de productos (brillo / etiquetas / sombras / imperfecciones)
  • portrait-local-edit.md — Edición local de retratos (peinado / ropa / maquillaje / complementos)

10. Avatares y perfiles ( references/avatars-and-profile/ )

Adecuado para imágenes de «imagen personal» como «avatares estilizados / personajes / cuadrículas / pegatinas / series de retratos». Actualmente se ha implementado:

  • style-transfer-selfie.md — Convierte a la persona de la imagen de referencia en cualquier estilo: cosplay, gótico, película retro, fotos de ídolos, etc.
  • character-grid-portrait.md — Retratos de un mismo personaje en una cuadrícula n×n (varias profesiones / varias expresiones / varias épocas / varios estilos)
  • themed-3d-icon.md — Avatares tipo iconos de aplicación en 3D kawaii, Minecraft o 3D objetual
  • sticker-set.md — Conjuntos de pegatinas / colecciones de emojis (elementos independientes + contornos + etiquetas)
  • cultural-portrait-series.md — Retratos de series temáticas: dinastías, mitología, literatura y etnias

11. Guiones gráficos y secuencias ( references/storyboards-and-sequences/ )

Adecuado para elementos visuales de «secuencias narrativas», como «guiones gráficos / cómics / diagramas de relaciones / pasos de un proceso». Actualmente disponibles:

  • four-panel-comic.md — Cómic de 4 viñetas / viñeta satírica / chiste gráfico (introducción, desarrollo, giro y conclusión + bocadillos de diálogo)
  • manga-spread-page.md — Guiones gráficos de una página o a doble página (cuadros irregulares + diálogos + pensamientos)
  • anime-key-visual.md — Imagen clave de anime / Portada de novela ligera / Cartel de propiedad intelectual
  • character-relationship-diagram.md — Póster con diagrama de relaciones entre personajes (fichas + líneas de relación + leyenda)
  • recipe-process-flowchart.md — Recetas / tutoriales / diagramas de pasos (numeración + ilustraciones + explicaciones)
  • product-tvc-storyboard.md — Guion gráfico de un anuncio televisivo de producto (9 viñetas con aspecto de toma real + descripción de planos + duración)
  • cinematic-storyboard-grid.md — Planilla de contacto de guion gráfico narrativo de estilo cinematográfico (3×4 / 4×4, narrativa continua + fotogramas cinematográficos)
  • process-photo-board.md — Tablero de proceso cinematográfico con personas reales (equipamiento / maquillaje / entrenamiento / desglose de operaciones, numeración + pasos progresivos)

12. Cuadrículas y collages ( references/grids-and-collages/ )

Adecuadas para elementos visuales del tipo «cuadrículas de varios paneles / collages / tableros de proyectos». Actualmente implementadas:

  • banner-grid-2x2.md — Conjunto de banners de marketing 2×2 (4 diseños de una misma serie en una sola entrega)
  • lookbook-grid.md — Lookbook de 7 días / Cuadrícula de 9 casillas de autocuidado / Lista de los N mejores
  • mixed-style-multi-panel.md — Collage mixto de varios estilos (interpretaciones de un mismo tema en diferentes estilos artísticos)
  • anime-pitch-board.md — Tablero de presentación de proyectos de anime, videojuegos y cine (imagen clave + personajes + universo + texto publicitario)
  • ad-banner-multi-grid.md — Cuadrícula de banners publicitarios mixtos de diversos sectores y temas (cada casilla con un sector, estilo y texto publicitario independientes)

13. Branding y packaging ( references/branding-and-packaging/ )

Adecuado para elementos visuales del tipo «sistema de identidad de marca / mascotas / diseño de envases». Actualmente implementado:

  • brand-identity-board.md — Tablero de identidad de marca (logotipo + paleta de colores + tipografía + maquetas de aplicación)
  • mascot-brand-kit.md — Kit de identidad de marca de varias páginas para mascotas (imagen principal + vistas en tres perspectivas + expresiones + aplicaciones)
  • cosmetic-packaging.md — Embalaje de cosméticos y productos para el cuidado de la piel: frascos individuales, series y cajas de regalo
  • beverage-label-design.md — Diseño de etiquetas para bebidas, alimentos y condimentos (estilo chino contemporáneo, japonés y occidental)
  • full-mascot-brand-doc.md — Identidad de marca a gran escala con más de 18 módulos + documentación completa del proceso de creación de la mascota (ADN / moodboard / bocetos / dibujos lineales / 3D / paleta de colores / materiales / resumen gráfico de aplicaciones)
  • character-merch-board.md — Tablero de marca integral con múltiples elementos: personajes de IP + productos derivados / embalajes / carteles / perfiles en redes sociales

14. Tipografía y maquetación de texto ( references/typography-and-text-layout/ )

Adecuado para tipos de diseño en los que «el texto es el elemento visual principal», como «prioridad al texto» o «maquetación bilingüe». Ya implementado:

  • title-safe-poster.md — Carteles con mensajes en letras grandes (estilo japonés enérgico / minimalismo suizo / impresión retro)
  • bilingual-layout-visual.md — Diseño visual bilingüe chino-inglés / chino-japonés (marcas culturales / académicas / interculturales)

15. Recursos y elementos ( references/assets-and-props/ )

Adecuado para elementos visuales del tipo «conjuntos de recursos / activos de videojuegos», como «conjuntos de iconos / capturas de pantalla de videojuegos». Actualmente se han implementado:

  • retro-skeuomorphic-icons.md — Conjunto de iconos esqueuomórficos / estilo Y2K / pixelados (con un estilo uniforme en todo el conjunto)
  • game-screenshot-mockup.md — Maqueta de captura de pantalla del juego (HUD + subtítulos + panel de misiones)

16. Figuras académicas ( references/academic-figures/ )

Imágenes adecuadas para «artículos de investigación / envíos a conferencias de prestigio / pósteres académicos / presentaciones de defensa / presentaciones de defensa de proyectos / resúmenes gráficos para envíos a revistas».En general, fondo blanco + tipografía de publicación + precisión geométrica + colores técnicos de baja saturación (principalmente azul oscuro / azul grisáceo / gris oscuro, ≤3 colores principales) + aptos para impresión en un solo color. Queda estrictamente prohibido inventar datos cuantitativos (valores / curvas de nivel / rangos de escala de colores / fórmulas).

Áreas de CS / CV / ML:

  • method-pipeline-overview.md — Diagrama general del método / figura del pipeline (bloques de múltiples etapas + flujo de datos; la variante 4 ofrece una hoja de ruta técnica de tres secciones —izquierda, centro y derecha— de tipo ingenieril)
  • neural-network-architecture.md — Diagrama de la arquitectura de la red neuronal (bloques de capas + forma de los tensores + conexiones saltadas)
  • qualitative-comparison-grid.md — Cuadrícula de comparación cualitativa de múltiples métodos ( filas = muestras, columnas = métodos )

Común a ingeniería, ciencias naturales y defensas de tesis:

  • scientific-schematic.md — Esquema conceptual / de principios / de un dispositivo experimental (alto grado de libertad, plantilla en lenguaje natural)
  • mechanism-diagram.md — Diagrama de mecanismos / relaciones causales / vías de transformación (objeto central + transformación en varias etapas + zona de resultados; incluye tres variantes: cadena causal de tres etapas, autoexcitación cíclica y competencia multirrama)
  • multi-condition-comparison.md — Gráfico comparativo de resultados en múltiples condiciones (resultados en paralelo del mismo objeto en diferentes condiciones, 2×2 / 1×N / M×N; se hace hincapié en la estricta uniformidad entre paneles)
  • publication-chart.md — Gráficos de datos listos para su publicación (de barras / de líneas / de dispersión / de mapa de calor / de cajas)

Resumen general / Resumen / Página de inicio de la defensa:

  • graphical-abstract.md — Resumen gráfico para el envío a revistas (cuatro variantes: horizontal de cuatro secciones, despliegue central, cuadrado y vertical)
  • research-overview-poster.md — Página de inicio de la presentación del tema, la defensa o el informe: diagrama de visión general de la investigación (tres niveles: superior, medio e inferior + cinco módulos; incluye tres variantes: radial con centro, dos columnas a izquierda y derecha y minimalista)

Estrategia de selección: para artículos de CS/CV/ML, se recomienda «method-pipeline-overview» + «qualitative-comparison-grid»; para ingeniería, energía, ingeniería química y materiales, se recomienda la variante 4 de «method-pipeline-overview» + «mechanism-diagram» + «multi-condition-comparison»;Para los resúmenes de las revistas a las que se envía el artículo, utilizar «resumen gráfico»; para la primera diapositiva de la presentación de la defensa, utilizar «póster de resumen de la investigación ».

17. Infografías ( references/infographics/ )

Adecuado para «infografías / divulgación científica de alta densidad / infografías dibujadas a mano / paneles de control de KPI» y otras «imágenes grandes de visualización de información». Actualmente se han implementado:

  • legend-heavy-infographic.md — Divulgación científica con gran densidad de leyendas / cadenas causales / evolución / diagramas anatómicos (bilingües)
  • hand-drawn-infographic.md — Infografías de estilo dibujado a mano (macaron / morandi / pizarra / papel kraft; plantillas en lenguaje natural)
  • bento-grid-infographic.md — Infografía modular tipo «bento» (disposición de widgets de alta densidad y múltiples módulos)
  • comparison-infographic.md — Infografías de comparación binaria o múltiple (A frente a B / niveles de tarifas / conceptos erróneos frente a respuestas correctas)
  • step-by-step-infographic.md — Infografía tutorial paso a paso (estilo ilustrado, acogedor; no es un diagrama de flujo de ingeniería)
  • kpi-dashboard-infographic.md — Infografía tipo cuadro de mando de KPI (resumen anual / «Wrapped» / cuadro de mando empresarial)

18. Diagramas técnicos ( references/technical-diagrams/ )

Adecuadas para esquemas de ingeniería como «arquitectura de sistemas / procesos / secuencias temporales / máquinas de estados / diagramas ER / mapas mentales / topologías de red». Fondo de cuadrícula oscuro uniforme + fuente de ancho fijo + combinación de colores codificada por elementos; cada plantilla incluye una variante en tonos claros.

⚠️ Atención: este directorio genera imágenes bitmap en formato PNG,no archivos SVG editables; si necesitas archivos editables, utiliza mermaid, draw.io, excalidraw o Figma. Actualmente se han implementado:

  • system-architecture.md — Diagrama de arquitectura del sistema (front-end + back-end + base de datos + caché + colas + elementos externos)
  • flowchart-decision.md — Diagrama de flujo / diagrama de decisión (semántica de formas BPMN + ramificaciones Sí/No)
  • sequence-diagram.md — Diagrama de secuencia (actor + línea de vida + flechas de mensaje + barra de activación)
  • state-machine.md — Máquina de estados / diagrama de ciclo de vida (estado + transición + condición / acción)
  • er-diagram.md — Diagrama ER / Diagrama de modelo de datos (entidad + campo + PK/FK + relación «pata de gallo»)
  • mind-map-tech.md — Mapa mental sobre temas tecnológicos (centro + ramificaciones radiales)
  • network-topology.md — Diagrama de topología de red (símbolo de dispositivo + zona / VPC + ancho de banda / etiqueta de protocolo)

Flujo de trabajo de palabras clave (sensible a patrones)

Independientemente de si se trata de A, B o C, los seis primeros pasos son comunes; la única diferencia radica en cómo se «genera el diagrama» en los pasos 7 y 8.

  1. Ejecuta check-mode.js para determinar el modo (A / B / C).
  2. Determina si la tarea consiste en generar un diagrama o modificarlo.
  3. Identifica a qué categoría pertenece (consulta el «Índice de plantillas» más abajo).
  4. Lee únicamente el archivo de plantilla específico correspondiente; no leas todo el directorio references/ de una sola vez.
  5. Sigue estrictamente el formato de las plantillas: la mayoría utiliza una plantilla principal en JSON (preferible para tareas estructuradas), mientras que unas pocas (como infographics/hand-drawn-infographic.md o academic-figures/scientific-schematic.md, entre otras) emplean un formato mixto de «lenguaje natural estructurado + parámetros», ya que imponer el uso de JSON limitaría la libertad creativa.
  6. Asigna la entrada del usuario a los parámetros de la plantilla; cuando falte información clave, formula de forma proactiva preguntas de aclaración específicas.

Llegados a este punto, la indicación ya se ha generado. A continuación, se bifurca según el modo:

7-A. Modo A: guardar la indicación final en garden- gpt-image-2/prompt/; ejecutar scripts/generate.js o scripts/edit.js; la imagen se guardará en garden- gpt-image-2/image/. 7-B. Modo B: pasar la indicación final directamente a la herramienta de imágenes del host para su ejecución;Guarda una copia del prompt en garden- gpt-image-2/prompt/ si es necesario. 7-C. Modo C: guarda el prompt final en garden- gpt-image-2/prompt/ - .md, y muestra el prompt completo al usuario en el diálogo, junto con una breve sugerencia sobre «cómo utilizarlo / herramientas recomendadas».

  1. Una vez finalizada la tarea, indica al usuario en una sola frase: cuál es el modo actual, dónde se encuentra el prompt y dónde están las imágenes (si las hay).

Restricciones importantes

General:

  • El JSON del archivo de plantilla es una plantilla de estructura de prompt, no una plantilla del cuerpo de la solicitud de la API.
  • En los tres modos, lo que finalmente se envía al modelo de imágenes es la «cadena de la indicación renderizada»: puede ser un JSON «aplanado» o un párrafo estructurado en lenguaje natural; utilízala tal y como aparece en la plantilla.
  • A menos que el usuario lo solicite expresamente, no copies la «descripción del modo» de SKILL.md en la indicación final, ya que se trata de metainformación destinada al agente.

Aplicable únicamente al Modo A:

  • El script de generación utiliza un cuerpo JSON
  • El script de edición utiliza datos de formulario multiparte
  • La respuesta se analiza preferentemente como data[0].b64_json, aunque también es compatible con data[0].url
  • A menos que la interfaz de origen lo requiera expresamente, no se deben introducir parámetros de consulta especiales adicionales

Cuándo plantear preguntas

Solo se deben formular preguntas cuando falte esta información y ello afecte significativamente al resultado:

  • No hay objetivo de prompt
  • No hay imagen original al modificar una imagen
  • La identidad del sujeto o el tipo visual determinan la dirección de los resultados
  • El producto, el precio, el texto publicitario o el texto de la interfaz de usuario son componentes fundamentales de la imagen
  • El usuario ha expresado varios objetivos que entran en conflicto entre sí

Aparte de eso, es preferible establecer un valor predeterminado razonable por cuenta propia y seguir adelante con él.

Ver en GitHub
---
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 文本是画面核心组成部分
- 用户同时表达了多个互相冲突的目标

除此之外,优先自己做合理默认并继续执行。

Todos los archivos

103 archivos
README.md 18.8k
Ver

Instalar gpt-image-2

Descarga y descomprime los archivos de habilidades en tu directorio .claude/skills/.

Descargar ZIP

Clona el repositorio y copia los archivos de la habilidad a tu proyecto.

git clone https://github.com/ConardLi/garden-skills/tree/main/skills/gpt-image-2 # Copy SKILL.md to your .claude/skills/ directory

Copiar Copiar
Configuración rápida: Copia la carpeta de la habilidad en .claude/skills/ Claude detectará y utilizará automáticamente la habilidad

Habilidades relacionadas

web-search
Tiempo actualizado 29 de junio de 2026
webapp-testing
Tiempo actualizado 29 de junio de 2026
lark-base
Tiempo actualizado 5 de julio de 2026
agentmail
Tiempo actualizado 29 de junio de 2026
OR