fireworks-tech-graph : générer des schémas techniques SVG/PNG vérifiés géométriquement à partir du langage naturel

À qui ça s'adresse

Si tu veux décrire une architecture ou un flux en langage naturel et obtenir un SVG vérifié géométriquement plus un PNG haute résolution, cet Agent Skill convient mieux. Le même skill marche dans Codex et Claude Code sans changement. Il peut aussi faire une animation sémantique SVG vers GIF validée, et du HTML interactif hors ligne.

Tu dois déjà pouvoir appeler ce skill dans ces assistants de code, et ta machine doit avoir python3 et trouver $SKILL_ROOT/scripts/fireworks.py. Si tu veux seulement dessiner à la main et ne comptes pas laisser un Agent écrire des fichiers, le gain est limité. La page ne nomme que Codex et Claude Code, pas d'autres clients. Ne laisse pas un décompte de styles éventuellement plus ancien dans le titre du dépôt écraser le corps : 11 styles générateur plus 1 style d'écriture IA (Dark Luxury).

Premier essai en 3 minutes

La page ne donne pas de commande d'installation marketplace à part. Commence par une vérif en lecture seule : quand la racine du skill est déjà prête, exécute

python3 "$SKILL_ROOT/scripts/fireworks.py" version

Le signal de succès : la commande passe et affiche des infos de version. Elle n'écrit pas de fichiers de schéma. Si $SKILL_ROOT n'existe pas encore, arrête : le texte de page disponible ne dit pas comment installer le skill dans Codex ou Claude Code ; n'invente pas un installeur.

Après le succès de version, fais un rendu contrôlé. L'exemple officiel est l'utilisateur qui dit “Generate a Mem0 memory architecture diagram, dark style”. Le skill classe ça en Memory Architecture Diagram, Style 2, génère un SVG avec couloirs, cylindres et flèches sémantiques, exporte un PNG 1920px, et signale mem0-architecture.svg / mem0-architecture.png. Avant d'écrire les fichiers, fais répéter ces deux chemins à l'Agent, et génère seulement après confirmation. Ne commence pas par GIF ou HTML : le texte de page disponible mentionne ces artefacts sans sous-commandes correspondantes.

Cas d'usage

Cas 1 : Produire un schéma d'architecture en langage naturel. Reprends l'exemple Mem0 ci-dessus pour vérifier toute la chaîne : classer → SVG → PNG 1920px → signaler les noms de fichiers. Il ne documente pas tous les paramètres visuels de Style 2, ni d'où vient la connaissance domaine Mem0. L'acceptation vérifie seulement : la classification est dite, et ces deux noms apparaissent dans le rapport. Si l'Agent se met à changer ton code métier, il a déjà quitté la tâche de schéma.

Cas 2 : Exporter un PNG depuis un SVG existant. Le CLI officiel est

python3 "$SKILL_ROOT/scripts/fireworks.py" export-png diagram.svg diagram.png --width 1920

Cela écrase ou crée diagram.png. Confirme d'abord que le SVG d'entrée existe et que le chemin de sortie est inscriptible. Pour éviter le texte coupé, ajoute "text_policy": "strict" à la configuration : il refuse la troncature visible avant d'écrire, garde les libellés source complets dans le rapport et explique comment rétablir ; les descriptions chinoises utilisent la deuxième ligne disponible. Le texte de page disponible ne donne pas de nom de fichier JSON complet. Tu ne peux confirmer que ce champ et la deuxième ligne chinoise ; n'invente pas d'autres valeurs de politique.

Limites d'usage

Les effectifs de styles suivent le corps : 11 styles générateur, plus Dark Luxury. Il y a aussi quatre styles plus ingénierie qui donnent des conventions exécutables pour revue C4, déploiement cloud, flux d'événements et diagnostic de fiabilité, plus des motifs de domaine AI/Agent profonds et les 14 types de diagrammes UML. La page ne nomme pas les 14 UML, ni les noms courts de ces quatre styles ingénierie. S'il manque le nom, ne l'appelle pas.

Les commandes copiables sont seulement version et export-png. GIF et HTML interactif sont écrits comme capacités, sans ligne de commande. N'ajoute pas un second installeur à côté. Les clients s'arrêtent à Codex et Claude Code.

Le premier arrêt est version, ou un PNG dont le chemin est déjà confirmé. Tout rendu en lot, tout champ inconnu hors text_policy, ou toute génération GIF/HTML doit d'abord faire expliquer la base et les fichiers à écrire ; tu confirmes, puis ça continue.