Prompt to Canvas
Habilidad de sistema de diseño para crear lienzos Excalidraw editables y pulidos a partir de contenido proporcionado por el usuario. El agente compone la disposición, utiliza el catálogo de estilos incluido para la dirección visual, construye una fuente SVG, la convierte en JSON de escena Excalidraw editable y la abre en el editor local.
Esto no es un generador automático de gráficos ni un rellenador de plantillas. El estilo proporciona paleta y ambiente; el agente decide la tesis, estructura, agrupación, jerarquía, etiquetas y conectores.
Utiliza el idioma principal de interacción del usuario para el texto visible en el lienzo, encabezados, etiquetas de sección, anotaciones y pies de ilustración, a menos que el usuario solicite explícitamente otro idioma. Mantén los términos técnicos, nombres de productos, nombres de API, acrónimos, identificadores de código, métricas y frases fuente entrecomilladas en su idioma original cuando sea más claro.
Cuándo usarlo
- El usuario quiere un lienzo editable, infografía, diagrama, gráfico de arquitectura, línea de tiempo, comparación, panel de control, mapa conceptual o gráfico listo para presentación.
- El usuario proporciona contenido y pide "dibujar", "visualizar", "convertir esto en un lienzo", "hacer un tablero de portafolio" o nombra esta habilidad.
- El resultado debe ser pulido, editable, exportable y visualmente estilizado.
Paso 0: requisitos previos
Ejecuta scripts/preflight.sh o verifica manualmente:
- Node 20 o más reciente.
assets/editor/index.htmlexiste.scripts/svg-to-scene.mjs,scripts/validate-scene.mjsyscripts/open-editor.mjsexisten.CATALOG.md,RULES.md,templates/yassets/styles/existen.
Si falta algo, indícale al usuario qué falta y detente.
Cómo ejecutar la conversación
- Comprender el lienzo. Identifica el contenido, propósito y audiencia. Si no está lo suficientemente claro como para cambiar el tablero, haz una pregunta breve antes de construir.
- Cuando el anfitrión soporte opciones estructuradas o seleccionables, úsalas. De lo contrario, haz una pregunta de texto compacta.
- Ofrece 2-3 opciones inferidas, coloca la opción recomendada primero e incluye una opción "el agente elige" en el idioma del usuario cuando el mensaje ya tenga suficiente contexto.
- Preguntar por el ambiente. Pregunta por el estilo visual: tranquilo, profesional, divertido, audaz, similar a una marca, preferencia de color o ambiente. Ofrece elegir si el usuario no tiene preferencia. Omite esto si el usuario ya nombró un estilo o ambiente claro.
- Usa opciones seleccionables cuando el anfitrión las soporte.
- Mapea las opciones a los niveles del catálogo: Restrained, Balanced o Bold.
- Elegir un estilo. Usa
CATALOG.mdpara elegir un estilo. Elige solo de la tabla del catálogo; no compares varios archivosdesign.md. Indica al usuario el estilo elegido y el porqué en una línea. - Construirlo. Lee
RULES.md,rules/canvas-rules.md,rules/visualization-strategy.mdy solo eltemplates/<slug>/design.mdseleccionado, luego:- Usa
rules/analysis-prompt.mdcomo lista de verificación editorial privada: decide la audiencia, el trabajo del artefacto, la tesis central, las entidades clave, las relaciones, las compensaciones y 3-6 afirmaciones que merezcan espacio en el lienzo. - Iguala el texto visible del lienzo, encabezados, etiquetas de sección, anotaciones y pies de ilustración al idioma principal de interacción del usuario a menos que el usuario pida otra cosa. Los términos técnicos, nombres de productos, nombres de API, acrónimos, identificadores de código, métricas y frases fuente entrecomilladas pueden permanecer en su idioma original cuando sea más claro.
- Compón primero
diagram.svgen un espacio lógico de aproximadamente 1600-1700 px de ancho. Usa formas SVG nativas:rect,circle,ellipse,line,polylineytext. Mantén cada etiqueta visible como texto. - Mantén el fondo del lienzo infinito de Excalidraw en blanco. Si el estilo elegido tiene un fondo/papel de color, dibújalo como un rectángulo editable dentro de la escena; nunca pongas ese color en
appState.viewBackgroundColor. - Mantén la selección de estilo independiente del fondo del lienzo de Excalidraw. Elige por contenido, audiencia, formalidad y ambiente; el color de papel/fondo de la plantilla sigue siendo parte del artefacto visual como un rectángulo editable dentro de la escena.
- Coloca solo el contenido del artefacto terminado en el lienzo. El contexto sobre mensajes, fuentes, rutas de archivos, estilo elegido o proceso pertenece a la respuesta del chat.
- Aplica el estilo seleccionado como un sistema visual: paleta, densidad, trazo, tratamiento de esquinas, jerarquía, disciplina de acento y ambiente de disposición.
- Convierte el SVG en JSON de escena Excalidraw editable:
- Usa
node scripts/svg-to-scene.mjs --svg diagram.svg --out scene.json
- Valida la escena:
node scripts/validate-scene.mjs --scene scene.json
Cuando exista una expectativa clara de idioma/escritura, valídala también:
node scripts/validate-scene.mjs --scene scene.json --expected-language <código-de-idioma>
- Inspecciona el editor abierto o la exportación renderizada. Corrige recortes de texto, espaciado apretado, jerarquía débil, superposiciones accidentales, texto de muestra desactualizado y desviación de estilo. Prefiere corregir
diagram.svgy reconvertir; usa ediciones en el JSON de la escena solo para limpieza específica de Excalidraw.
- Abrir el editor. Usa:
node scripts/open-editor.mjs --scene scene.json
Cada llamada inicia una URL de editor local independiente. Haz esto para cada nuevo lienzo, plantilla alternativa o versión regenerada en lugar de reutilizar una URL antigua. Por defecto, el script avanza a un puerto disponible fresco y sirve la escena desde una URL única sin caché. Un puerto se libera cuando ese proceso open-editor.mjs se detiene o la sesión del anfitrión termina.
- Entregar. Dale al usuario la URL local impresa. Menciona que el editor soporta cambio de interfaz entre chino/inglés, autoguardado local a prueba de actualizaciones y exportación a PNG/SVG. Ofrece volver a renderizar el mismo contenido en otro estilo.
Archivos
CATALOG.md: 35 estilos con ambiente, formalidad y firma de paleta.RULES.md: reglas del medio SVG compartidas por el sistema de estilo.templates/<slug>/design.md: una guía de paleta y ambiente por estilo.assets/styles/: imágenes de previsualización de estilo.rules/analysis-prompt.md: lista de verificación privada para dar forma al contenido.rules/canvas-rules.md: reglas de escena y verificación de Excalidraw.rules/visualization-strategy.md: guía de disposición y fidelidad al estilo.scripts/preflight.sh: verificación de dependencias y recursos.scripts/svg-to-scene.mjs: conversor de SVG a Excalidraw editable.scripts/validate-scene.mjs: validador de esquema de escena.scripts/open-editor.mjs: servidor de editor local y cargador de escena. Por defecto asigna un puerto fresco para generaciones separadas.
Prueba rápida
scripts/preflight.sh
node scripts/svg-to-scene.mjs --svg test-diagram.svg --out test-scene.json
node scripts/validate-scene.mjs --scene test-scene.json
node scripts/open-editor.mjs --scene test-scene.json --no-open