Sobre el proyecto

fireworks-tech-graph es una habilidad de agente que se ejecuta sin cambios en Codex y Claude Code. Convierte descripciones en lenguaje natural (inglés o chino) en diagramas SVG verificados geométricamente, exportaciones PNG de alta resolución, movimiento semántico validado de SVG a GIF y un único archivo HTML interactivo offline. Capacidades principales - 12 estilos visuales: 11 perfiles respaldados por generadores más un estilo creado por IA (Dark Luxury). Cuatro estilos de ingeniería añaden contratos ejecutables para revisiones C4, despliegues en la nube, flujos de eventos e investigaciones de fiabilidad. - 14 tipos de diagramas con soporte UML completo: Clase, Componente, Despliegue, Paquete, Estructura Compuesta, Objeto, Caso de Uso, Actividad, Máquina de Estados, Secuencia, Comunicación, Temporización, Resumen de Interacción y Diagrama ER, junto con patrones de dominio de IA/Agentes como RAG, Búsqueda Agéntica, Mem0, Multi-Agente y Llamada de Herramientas. - Vocabulario semántico: las formas codifican roles (LLM como rectángulo de doble borde, Agente como hexágono, Almacén Vectorial como cilindro anillado) y el color/diseño de las flechas codifica significado (escritura, lectura, asíncrono, bucle). - Enrutamiento y diseño: rutas ortogonales deterministas con puntos de paso exactos, puertos distintos, reubicación automática de leyendas, etiquetas mantenidas dentro del lienzo y saltos de puente verificados para cruces inevitables. - Validación: un IR de diagramas versionado normaliza JSON heredado al esquema v1 y falla ante IDs duplicados, referencias colgantes, puntos de paso malformados o geometría no finita; las comprobaciones SVG estructuradas cubren integridad XML y de marcadores, además de condiciones de nodo, región reservada, etiqueta, lienzo, superposición de bordes y cruce de bordes. - Salida: SVG para edición y PNG de 1920px para incrustación; SVG en línea puro sin obtención de fuentes externas, destinado a renderizarse en cairosvg, rsvg-convert y Chrome sin interfaz. Un CLI unificado admite render, validate, check, export-html y animate, y la exportación HTML añade pan/zoom, temas claro/oscuro, copia de fuente y descargas SVG/PNG/JPEG/WebP a 1x-4x. - Movimiento: el comando animate acepta un SVG semántico generado que lleva uno de doce contratos de movimiento aprobados y emite un GIF más un informe de verificación motion.json. El valor predeterminado documentado es 960px, 5.75 segundos, 20fps, 115 muestras de fotogramas, con conectores dibujados en orden semántico; también se admiten líneas de tiempo más cortas de 75 y 55 fotogramas. - Puerta de revisión visual: los PNG exportados se inspeccionan para detectar recortes, superposiciones, colocación de etiquetas y regresiones de enrutamiento, con un máximo de dos pasadas de corrección enfocadas por defecto; si el tiempo de ejecución no puede leer imágenes, la habilidad informa visual_review como omitido en lugar de afirmar verificación. - Iconos de productos: más de 40 productos con colores de marca, más agrupación automática en carriles para arquitecturas complejas. Instalación y requisitos La instalación se realiza mediante el CLI de habilidades usando la ruta anidada skills/fireworks-tech-graph, o clonando el repositorio en ~/.agents/skills (Codex) o ~/.claude/skills (Claude Code); también se documenta un checkout compartido con enlaces simbólicos. Se requiere Python 3.9+. Los scripts SVG/PNG necesitan cairosvg (recomendado) o rsvg-convert; la exportación GIF opcional necesita FFmpeg/FFprobe, Chrome/Chromium y puppeteer o puppeteer-core, con Node.js 22.12+ para la ruta de Puppeteer. El README posiciona el proyecto frente a Mermaid y draw.io, señalando que acepta entrada en lenguaje natural, incluye patrones de dominio de IA/Agentes, incorpora estilos integrados, exporta PNG de alta resolución automáticamente y no necesita herramientas en línea. Se publica bajo la licencia MIT.