schemdraw — Schémas Scientifiques Modifiables avec Traçabilité des Sources
Chemin du script : Cette compétence est installée dans
/skills/weekly-skill/, le chemin absolu du script est/skills/weekly-skill/scripts/(le répertoire de travail est/app/work, ne pas utiliser de chemins relatifs).
Produisez une figure qui est correcte, modifiable et conforme à l'exportation : chaque entité/relation est traçable jusqu'au matériel source, la légende correspond aux données, le texte reste sélectionnable, et les exportations respectent la résolution cible. Le mode d'échec que cette compétence vise à prévenir : une jolie image avec des relations d'entités erronées, des noms de gènes ou des concentrations inventés, une légende en désaccord avec les données, et une sortie uniquement bitmap qui ne peut pas être modifiée.
Méthode en une ligne : extraire les entités/relations du matériel → les disposer en SVG superposé (groupé, texte sélectionnable, direction des flèches selon le type de relation) → construire le graphique à partir des mêmes données sources avec une légende/carte de couleurs explicite → exporter PDF+PNG → valider la traçabilité et le contrat d'exportation.
Quand l'utiliser
- Entrée : un fichier de cas (par défaut
/input/case.json) contenant le matériel scientifique, des listes optionnelles d'entités/relations, des données de graphique et des spécifications d'exportation. - Sortie : dans
/app/output—figure.svg,chart.svg,figure.pdf,figure.png,entities.json,export_report.json,validation.json,result.json. - Le SVG est la source modifiable ; PDF/PNG sont les exportations.
Pipeline (à exécuter dans l'ordre)
Phase 1 — Extraction et dessin
python3 /skills/weekly-skill/scripts/schem.py --case /input/case.json --work /app/work
- Lit chaque matériel (texte/Markdown), fusionne les
entités/relationsfournies avec les relations extraites à partir de motifs :X active|promeut|renforce Y,X inhibe|supprime|bloque Y,X -> Y,X --| Y,X se lie|interagit avec Y,X contient|inclut Y. - Chaque relation porte une
provenance(text-pattern+ la citation source) ou provient de la liste fournie. - Écrit
entities.jsonet unfigure.svgsuperposé :<g id="arrows">avecdata-source/data-target/data-type,<g id="nodes">avec un groupe par entité et des libellés<text>. La couleur/le pointillé des flèches encode le type de relation (vert = activation, rouge = inhibition, pointillé = contenance). - Si le cas contient des données de graphique, écrit
chart.svgdont les barres portentdata-label/data-valueet dont la légende utilise le même index de palette que les barres.
Phase 2 — Exportation
python3 /skills/weekly-skill/scripts/export.py --work /app/work --dpi 300
LibreOffice en mode sans tête convertit SVG → PDF (vectoriel, texte sélectionnable) ; PyMuPDF rastérise le PDF → PNG à la résolution demandée. Écrit export_report.json. Si LibreOffice est manquant, le rapport l'indique et le statut devient partial — jamais un échec silencieux.
Phase 3 — Validation
python3 /skills/weekly-skill/scripts/validate.py --case /input/case.json --work /app/work
Vérifications :
- chaque extrémité de relation est une entité déclarée (pas de flèches pendantes) ;
- chaque relation a une provenance ou une citation source ;
- les étiquettes et les valeurs de la légende du graphique correspondent exactement aux données sources ;
- le SVG a du
<text>(sélectionnable) et ≥2 couches ; - les exportations PDF et PNG existent et le PNG n'est pas anormalement petit.
Phase 4 — Copie des livrables
mkdir -p /app/output
cp /app/work/figure.svg /app/work/chart.svg /app/work/figure.pdf /app/work/figure.png \
/app/work/entities.json /app/work/export_report.json /app/work/result.json /app/output/
# validation.json est écrit par validate.py ; le copier aussi s'il est présent
Règles impératives
- Les entités proviennent du matériel. Pas de noms de gènes, concentrations ou points temporels inventés ; tout ce que le modèle ajoute doit être sourcé et marqué.
- La direction des relations est une donnée.
A active Best dessiné A → B, jamais inversé ; le type de flèche suit le type de relation. - Cohérence légende ⇄ données. Les étiquettes et couleurs de la légende proviennent du même tableau que les barres ; modifier les données modifie la légende.
- Source modifiable + exportation conforme. Toujours livrer le SVG (modifiable) et le PDF/PNG (exportation) ensemble.
- L'exportation est vérifiée, pas supposée. La résolution, l'incorporation des polices et l'existence des fichiers sont enregistrées ; un échec d'exportation est signalé.
Gestion des exceptions
| Situation | Comportement |
|---|---|
| Pas de matériel / vide | liste d'entités vide ; SVG toujours écrit avec un titre |
| Extrémité de relation inconnue | conservée dans entities (ajoutée à partir du motif) et dessinée |
| Données de graphique manquantes | chart.svg ignoré ; entities.json.chart_svg = null |
| LibreOffice manquant | PDF/PNG manquants, export_report.status = partial, limitation enregistrée |
| Pas de relations | SVG avec nœuds uniquement ; la validation note 0 relations |
Auto-vérification
python3 /skills/weekly-skill/scripts/validate.py --case /input/case.json --work /app/work
python3 -c "import json;e=json.load(open('/app/work/entities.json'));print(len(e['entities']), len(e['relations']), e['relation_counts'])"
valid: true est requis ; le modèle doit remplir toute entité/relation que l'extracteur déterministe aurait manquée, toujours avec une source.