À propos du projet

fireworks-tech-graph est une compétence d'agent qui fonctionne sans modification dans Codex et Claude Code. Elle convertit des descriptions en langage naturel (anglais ou chinois) en diagrammes SVG vérifiés géométriquement, des exportations PNG haute résolution, des animations sémantiques SVG vers GIF validées, et un fichier HTML interactif hors ligne unique. Capacités principales - 12 styles visuels : 11 profils basés sur des générateurs plus un style créé par IA (Dark Luxury). Quatre styles orientés ingénierie ajoutent des contrats exécutables pour les revues C4, les déploiements cloud, les flux d'événements et les enquêtes de fiabilité. - 14 types de diagrammes avec prise en charge UML complète : Classe, Composant, Déploiement, Package, Structure Composite, Objet, Cas d'utilisation, Activité, Machine à états, Séquence, Communication, Timing, Aperçu d'interaction et Diagramme ER, ainsi que des modèles de domaine IA/Agent tels que RAG, Recherche Agentique, Mem0, Multi-Agent et Appel d'outil. - Vocabulaire sémantique : les formes encodent les rôles (LLM comme rectangle à double bordure, Agent comme hexagone, Magasin de vecteurs comme cylindre annelé) et la couleur/largeur des flèches encode la signification (écriture, lecture, asynchrone, boucle). - Routage et disposition : routes orthogonales déterministes avec points de passage exacts, ports distincts, repositionnement automatique de la légende, étiquettes maintenues dans le canevas, et sauts de pont vérifiés pour les croisements inévitables. - Validation : un IR de diagramme versionné normalise le JSON hérité vers le schéma v1 et échoue en cas d'identifiants dupliqués, de références pendantes, de points de passage malformés ou de géométrie non finie ; des vérifications SVG structurées couvrent l'intégrité XML et des marqueurs ainsi que les conditions de nœud, de région réservée, d'étiquette, de canevas, de chevauchement d'arêtes et de croisement d'arêtes. - Sortie : SVG pour l'édition et PNG 1920px pour l'intégration ; SVG en ligne pur sans récupération de police externe, destiné à être rendu dans cairosvg, rsvg-convert et Chrome sans tête. Une CLI unifiée prend en charge render, validate, check, export-html et animate, et l'exportation HTML ajoute le panoramique/zoom, les thèmes clair/sombre, la copie de source et les téléchargements SVG/PNG/JPEG/WebP à 1x-4x. - Mouvement : la commande animate accepte un SVG sémantique généré portant l'un des douze contrats de mouvement approuvés et émet un GIF plus un rapport de vérification motion.json. La valeur par défaut documentée est 960px, 5,75 secondes, 20fps, 115 échantillons de trame, avec les connecteurs dessinés dans l'ordre sémantique ; des chronologies plus courtes de 75 et 55 trames sont également prises en charge. - Porte de revue visuelle : les PNG exportés sont inspectés pour détecter le recadrage, le chevauchement, le placement des étiquettes et les régressions de routage, avec au plus deux passes de correction ciblées par défaut ; si le runtime ne peut pas lire les images, la compétence signale visual_review comme ignoré plutôt que de prétendre à une vérification. - Icônes de produits : plus de 40 produits avec couleurs de marque, plus un regroupement automatique en couloirs pour les architectures complexes. Installation et exigences L'installation se fait via la CLI des compétences en utilisant le chemin imbriqué skills/fireworks-tech-graph, ou en clonant le dépôt dans ~/.agents/skills (Codex) ou ~/.claude/skills (Claude Code) ; un partage avec des liens symboliques est également documenté. Python 3.9+ est requis. Les scripts SVG/PNG nécessitent cairosvg (recommandé) ou rsvg-convert ; l'exportation GIF optionnelle nécessite FFmpeg/FFprobe, Chrome/Chromium et puppeteer ou puppeteer-core, avec Node.js 22.12+ pour le chemin Puppeteer. Le README positionne le projet par rapport à Mermaid et draw.io, notant qu'il accepte une entrée en langage naturel, inclut des modèles de domaine IA/Agent, fournit des styles intégrés, exporte automatiquement des PNG haute résolution et ne nécessite aucun outil en ligne. Il est publié sous licence MIT.