CommunityImagegithub.com

reconstruction-figure-scientifique

Comprendre une référence ou une description scientifique et la redessiner en objets SVG propres et indépendamment modifiables. Utiliser la vision et le raisonnement de l'hôte appelant avec des outils de géométrie/rendu/édition déterministes ; aucune API de modèle ou interface graphique supplémentaire n'est requise.

Qu'est-ce que reconstruction-figure-scientifique ?

Cette compétence, neutre vis-à-vis du fournisseur, permet à un hôte (par exemple, Claude Code ou un autre agent) de dessiner des figures scientifiques à partir d'une référence visuelle ou d'une description textuelle. L'utilisateur décrit ce qu'il veut dessiner ; le moteur exécute la géométrie, applique les couleurs et les calques, édite et exporte une figure vectorielle (SVG) et son rendu PNG. Elle est conçue pour les scientifiques, les ingénieurs et les développeurs qui ont besoin de figures claires, modifiables et reproductibles sans dépendre d'API de modèles externes ou d'interfaces graphiques lourdes. La compétence fonctionne via l'environnement Anaconda `ScientificFigure_skill` et la commande `figure-cli`. Elle supporte deux flux de travail principaux : la reconstruction à partir d'une référence et la conception à partir d'un texte en langage naturel. Le moteur inclut des contrôles de qualité (QA) pour la mise en page, la police de caractères et la géométrie, ainsi qu'un mode de correction automatisé en trois tours maximum. L'hôte peut écrire des programmes de dessin en Python ou JavaScript, mais l'export final repose sur une validation par le moteur. La compétence encourage un fonctionnement autonome par défaut, mais peut être utilisée en mode interactif pour des validations par étapes. Elle gère les polices, les calques, les annotations et les légendes, et produit des SVG auxquels on peut faire confiance pour une édition indépendante.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/w1-23/scientific-figure/tree/HEAD

Installed? Explore more Image skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Reconstruction & Dessin de Figures Scientifiques

Une compétence indépendante et neutre vis-à-vis du fournisseur. L'hôte appelant décide ce qu'il faut dessiner ; le moteur exécute la géométrie déclarée, les peintures, les calques, les éditions et les exportations déclarés. Fournir un SVG ainsi qu'un PNG rendu à partir de ce SVG. Utiliser Anaconda ScientificFigure_skill et le figure-cli installé.

Guide 0.10 : deux tâches, un seul hôte et Scene

Le moteur actuel 0.10.0 ajoute un QA de mise en page déterministe (layout-audit), des réparations de mise en page bornées (--fix) et une pré-vérification du profil de police par-dessus la base 0.9. FigurePlan 0.1 et Scene 0.3 sont inchangés, et la base d'exécution, d'édition et de rendu 0.8 est préservée. L'hôte appelant est déjà le modèle qui effectue l'interprétation et la révision visuelle ; n'ajoutez pas de second modèle ou Agent. Voir le plan 0.10 et le contrat QA ; le plan 0.9, les capacités 0.8 et la planification sémantique / nouveau workflow CLI restent en vigueur pour tout ce qui suit. La page de workflow définit les points d'entrée implémentés et les contrats de fichiers exacts ; les notes de livraison consignent la vérification réelle et les limites.

Choisissez le guide de tâche avant de construire une figure complexe :

  • Reconstruction de référence : lire reference-reconstruction. Établir la structure de l'information et l'ordre de lecture, les parties essentielles, les relations et les inconnues spécifiques avant la géométrie. Séparer les entités, les flèches de processus, les lignes de repère pour les annotations, les vues agrandies, les légendes et la décoration. Ne pas remplir les régions illisibles à partir de connaissances thématiques.
  • Conception en langage naturel : lire text-design. Séparer le contenu explicite de l'utilisateur, les choix de conception et les hypothèses scientifiques. Concevoir la hiérarchie autour du mécanisme demandé ; ne pas inventer des conditions de préparation, d'administration ou expérimentales.
  • Les deux tâches : utiliser construction-selection lorsque la méthode est incertaine. Choisir en fonction de la forme requise, des pièces, de la répétition, des trous, de l'occlusion et du style, puis comparer les ressources réellement disponibles. Un objet plat simple peut passer directement d'une courte note d'intention/inconnue à la géométrie et à l'aperçu ; pas de recherche ou de fichiers de planification multiples obligatoires.

Travailler de manière autonome par défaut ; ne faire une pause que lorsqu'on le lui demande

ModeDébut lorsqueComportement de l'hôte
autonomous (par défaut)l'utilisateur demande la figure ou dit de la terminerdessiner, inspecter, corriger et livrer ; ne pas faire de pause pour approbation à chaque étape
interactivel'utilisateur demande à voir un échantillon, à confirmer chaque page ou à participerpublier le point de contrôle convenu et attendre un retour ou une approbation
  • Ouvrir une page de révision n'oblige pas à une pause. En mode autonome, lire les nouveaux retours au prochain point de contrôle sûr ; si l'utilisateur demande d'arrêter, arrêter de publier des candidats et traiter d'abord leurs modifications.
  • En mode interactif, terminer et publier la première page convenue, attendre, puis continuer. Pour un travail multi-page, la première page approuvée fixe la typographie partagée, l'espacement, le style de carte et les règles de palette ; les pages suivantes partagent ces règles, non une mise en page identique imposée.
  • Un hôte qui ne peut pas lire les images peut utiliser la géométrie et les vérifications structurelles mais doit laisser la révision visuelle not_executed.
  • Approuver une version SVG n'est pas une révision scientifique et n'approuve pas une version ultérieure.

Par défaut : comprendre, sélectionner, construire, inspecter, corriger

  1. Énoncer l'objectif, la taille d'affichage prévue, les modules et l'ordre de lecture. Lister les objets, les parties internes indispensables, les unités modifiables, les étiquettes, les significations des couleurs et les relations. Garder le contenu non résolu explicite. Pour une figure complexe, rendre ce brouillon inspectable avant d'écrire une géométrie extensive. Utiliser les modules/objets/relations FigurePlan existants lorsque cela est utile ; les constructions non sélectionnées peuvent rester unresolved. Ce sont des étapes d'une entrée de planification, non un autre arbre Scene.
  2. Ne poser que les questions locales qui affectent une décision : par exemple, si une zone pâle est une ouverture ou une surface, ou où se termine un repère. Inspecter l'original et les recadrages pertinents ; n'utiliser les preuves liées à la source que si nécessaire. Préserver les ROI et les mappages de coordonnées. Les mesures et les scores de similarité sont des observations, non des identités d'objets ou une confiance scientifique ; il n'y a pas d'OCR implicite.
  3. Choisir recipe/asset/direct/program en fonction de la structure et du style. Vérifier les paramètres réels de Recipe et les clés de parties modifiables ou les droits d'importation d'actifs. Le catalogue contient 15 familles de Recipe, deux entrées de métadonnées de famille de symboles et un actif Twemoji lemon ; n'inventez pas de Recipes de souris/flacon/avatar. Si un Recipe omet des parties requises, rejeter cette construction et revenir à un programme libre, en combinant éventuellement des sous-parties appropriées. Utiliser des coordonnées locales, des courbes, des transformations, des fonctions de dessin existantes et des bibliothèques matures. Scene direct, Plan sémantique 0.3 hérité et SceneBuilder restent valides ; ne pas exiger un grand JSON manuscrit avant de dessiner.
  4. Construire d'abord la structure principale et les parties internes requises, puis les connecteurs et les étiquettes. Préserver les ID d'objets/parties stables. Utiliser des surfaces remplies, des traits, de vrais trous, des masques/occlusions bornés, la répétition et des dégradés lorsque cela est approprié ; n'ajoutez pas d'éclairage volumétrique à un art plat. L'hôte exécute explicitement des programmes via des outils ordinaires et fournit des fragments Scene générés ; la vérification/compilation et le chargement de projet n'exécutent pas de source sauvegardée. Garder les nouveaux candidats séparés d'un projet modifié et utiliser la fusion B/U/C avant l'acceptation.
  5. Lire le preview.png réel à la taille d'affichage prévue et inspecter les régions agrandies clés. Vérifier les modules et les connexions → silhouette/proportions/trous → structure interne nécessaire → couches/calques → texte. Comparer la référence à la même échelle ; lors du remplacement d'un dessin antérieur, comparer référence/ancien/nouveau ensemble. Un plan valide, un chemin nommé ou un test réussi ne peuvent pas établir que la structure prévue a été correctement dessinée.
  6. Attacher chaque constatation à un ID et à une action concrète : changer la méthode de construction, remplacer un candidat, ajuster la géométrie/les paramètres, obtenir des preuves locales ou conserver l'incertitude. Corriger par rapport à la révision actuelle ou régénérer un candidat et fusionner ; rendre et inspecter à nouveau. Par défaut, au plus trois séries de corrections ciblées. Préserver les objets acceptés et les modifications de l'utilisateur. Lier l'évaluation visuelle à la scène/aperçu actuel ; la géométrie, les ressources ou le rendu modifiés rendent caduques les anciennes évaluations. Signaler les omissions et les révisions non exécutées. La révision scientifique reste séparée et non exécutée lorsqu'elle n'est pas demandée.

Le succès signifie une figure bien dessinée, structurellement claire, avec des parties principales indépendamment modifiables. Les tests établissent le comportement technique, non la qualité du dessin. Les ablations indépendantes de l'hôte, les campagnes de référence retenues, les panels humains, la certification par domaine, l'intégration runtime, la migration de modèles entre versions et le développement expérimental de décalage/largeur variable sont en dehors du périmètre de travail actuel. Ne les transformez pas en prérequis ou en tâches suivantes non sollicitées. Signaler la réutilisation réelle séparément comme œuvre d'art externe, réutilisation de code de dessin et réutilisation de bibliothèque de géométrie/rendu ; le fait d'avoir un actif dans le Registry ne signifie pas que ce dessin l'a utilisé.

L'hôte peut écrire des programmes de dessin en Python ou JavaScript. Utiliser des variables ordinaires, des fonctions, des coordonnées locales, des transformations, la répétition et des bibliothèques de géométrie matures pour calculer les formes ; utiliser les assistants du moteur stables lorsqu'ils sont disponibles. Un programme de dessin spécifique à la figure est autorisé ; ne transformez pas quelques figures de référence en algorithmes de moteur spécifiques à un sujet ou ne traitez pas les exemples de plan comme une bibliothèque de modèles scientifiques. Envoyer les candidats Scene/Plan générés via la validation du moteur, le rendu et les transactions du projet. Lors de la réexécution sur un projet modifié, comparer la dernière base générée, la scène actuelle et le nouveau candidat avant d'accepter les modifications ; préserver les modifications de l'utilisateur et signaler les conflits. Utiliser les assistants de construction et le protocole de génération disponibles : generation diff PROJECT --candidate SOURCE --output DIFF, inspecter l'aperçu proposé et les conflits, puis generation accept PROJECT --candidate DIFF --base-revision N. La source sauvegardée est inerte ; l'acceptation recalcule la fusion et vérifie la révision/le contenu/le reçu actuels. Ne jamais écraser un projet modifié avec une sortie de script pur. Ne pas intégrer d'images raster, tracer chaque texture en minuscules chemins, ou remplacer une structure manquante par un remplissage attrayant.

Choisir entre la reconstruction à partir de la référence fournie et la réutilisation de ressources autorisée avant de dessiner. Divulguer séparément : les œuvres d'art externes (source, licence, version/hash et modifications) ; le code de dessin réutilisé, y compris vos propres fonctions (fichier/version, parties réutilisées et modifications) ; et les bibliothèques de géométrie/rendu (bibliothèque/version réelle et rôle). Une fonction écrite localement n'est pas un actif externe, et un appel de bibliothèque n'est pas une œuvre d'art empruntée. Enregistrer l'inspiration de méthode séparément du code copié ; le code externe copié nécessite sa révision source fixe, ses fichiers, sa licence et ses mentions. Pour une comparaison raster explicitement figée, ne jamais substituer un SVG source officiel. Inspecter la structure principale, la géométrie/les trous/l'occlusion, puis le style/le texte dans les aperçus réels dans le même budget de correction. Les patchs de couverture de couleur de fond n'établissent pas de vrais trous ou d'entrelacement modifiable. Les sources du programme sont des entrées de reproductibilité ; la scène acceptée est la seule autorité modifiable actuelle. L'ouverture d'un projet ou d'un bundle ne doit pas exécuter un programme de dessin.

Exécuter avec des fichiers, sans service de modèle

conda run -n ScientificFigure_skill figure-cli doctor --json

Utiliser inspect reference.png pour la taille/hash de la source. Les plans liés à la source déclarent SHA-256, taille et ROI. L'exécution sémantique du Plan hérité 0.3 n'exécute pas implicitement la segmentation des couleurs, la recherche de candidats par pixel ou l'analyse de squelette. Les anciennes entrées Plan 0.1/0.2 conservent leur comportement.

conda run -n ScientificFigure_skill figure-cli reconstruct reference.png --plan plan.json --output work/figure

Boucle d'aperçu de l'ébauche et minutage des étapes

draw et reconstruct acceptent --preview : ils écrivent uniquement figure.svg, preview.png et preview.json, rendent à l'échelle 1 sauf si --scale indique le contraire, et peuvent remplacer leur propre aperçu précédent. Ce n'est pas un projet ou un livrable — pas de reçu, de manifeste d'objet, d'enregistrement QA, de liaison de révision ou de comparaison de référence — donc l'utiliser pour le premier coup d'œil et pour chaque tour de correction, puis exécuter la même commande sans --preview une fois la structure correcte.

conda run -n ScientificFigure_skill figure-cli draw plan.json --output work/quick --preview

Les deux chemins retournent timings en secondes : validate, to_svg, render, inventory, qa, publish, total ; un aperçu omet les étapes de livraison et le reçu enregistre les mêmes étapes pré-publiation. Sur cet hôte, une scène de 501 objets prend environ 0,33 s en tant qu'aperçu et 1,16 s en tant que projet complet, la plupart de la différence étant due au rendu PNG à l'échelle 1 par rapport à 3. Le moteur ne peut pas voir le temps côté modèle : lors de la mesure d'une reconstruction, enregistrer la première inférence de l'hôte, les jetons de sortie et les tours de correction à côté de ces nombres, et n'attribuer jamais les secondes du moteur à la latence du modèle ou l'inverse.

Vérifier le texte et les polices avant une construction complexe

Collecter chaque chaîne que la figure dessinera — étiquettes, formules, unités, texte d'axe, légendes — en une seule requête et exécuter ceci avant la géométrie :

{"schema_version": "0.1", "texts": ["Cell membrane", "H₂O → O₂", "细胞膜"]}
conda run -n ScientificFigure_skill figure-cli font-probe texts.json --output work/fonts

status: ok sélectionne une police locale réelle et écrit font-probe.json plus font-probe-sample.png ; needs_input liste les caractères manquants et la couverture par face. --font PATH ajoute un fichier spécifique. --profile (nom par défaut scientific-default) résout en outre la recommandation packagée (Times New Roman / Microsoft YaHei / Cambria Math) par rapport aux polices installées et signale le chemin, la face, le digest et les caractères d'échantillon manquants de chaque rôle ; une famille absente est signalée comme manquante, jamais substituée. Le moteur rend une famille, donc ne revendiquez pas de repli de police mixte : définissez SCIENTIFIC_FIGURE_FONT sur le chemin sélectionné vous-même, ou simplifiez le texte. Pour plusieurs pages, sonder l'union de toutes les pages une fois, avant la page 1. Un glyphe manquant est une décision de construction, non une erreur d'export de dernière minute.

Afficher la figure pendant le dessin

conda run -n ScientificFigure_skill figure-cli draw plan.json --output work/quick --preview
conda run -n ScientificFigure_skill figure-cli review-serve work/quick --open
conda run -n ScientificFigure_skill figure-cli review-status work/quick-review

review-serve sert le figure.svg le plus récent et publié avec succès sur 127.0.0.1 avec un jeton aléatoire et imprime l'URL avant de se bloquer. La page conserve le zoom, le panoramique et les épingles non envoyées entre les rechargements, et permet à l'utilisateur d'épingler un commentaire à un ID d'objet ou à un espace vide. review-status lit le journal des retours. Ajoutez --wait --timeout N pour bloquer jusqu'à l'arrivée d'un nouveau tour ; sans cela, arrêter avec Ctrl-C. Le serveur lit uniquement la figure et écrit les retours ; il ne modifie jamais le projet.

Les retours sont stockés dans <preview>-review/feedback.json, en dehors du répertoire d'aperçu remplaçable, et chaque soumission est liée au SHA256 et à la révision SVG qui étaient affichés. Une soumission provenant d'une version plus ancienne est rejetée avec HTTP 409, jamais appliquée silencieusement. Appliquer les commentaires acceptés via un correctif normal ou une fusion de génération, puis publier un nouvel aperçu. La page locale est un repli de navigateur ; elle ne crée pas de barre latérale VS Code, et un hôte intégré doit toujours traiter les retours comme ce fichier versionné.

Livrer des SVG graphiques uniquement et finaux

conda run -n ScientificFigure_skill figure-cli export-variants work/figure --output deliverables/figure

Ceci lit un projet validé et écrit figure.final.svg plus figure.graphics.svg (sans texte) et variants.json. Les deux proviennent de la même scène, donc les ID partagés conservent une géométrie et un style identiques ; rien n'est redessiné. Le texte…

Skills associés