1.8 KiB
tools
Le harnais de lecture : les méthodes données à l'agent pour appréhender les données d'une station AIMsight. Chaque outil répond à une question que se pose l'analyste et rend des valeurs, des plages datées, une figure ou des vignettes ; il montre, il ne juge pas.
scripts/: les outils, un script chacun ;GUIDE.md: quel outil pour quelle question, et comment lire ce qu'il rend. L'agent le lit en premier.scripts/donnees.py: la lecture commune des données (aussi celle de l'app Diagnostic-App, qui passe ces mesures aux détecteurs) ; les détecteurs gardent la leur (detectors/scripts/data.py), pour rester autonomes : une correction de lecture dans l'une se reporte dans l'autre.- Les outils :
inventaire,resume,plages,jours,ensemble,metriques,qualite,stations,graphique,vignettes,gif(le détail dans le guide).
S'en servir
Le dépôt appelant y pointe par un lien tools -> ~/tools (ignoré par git), à côté de ses liens data/ et labeling/, et lance les outils depuis sa racine :
python3 tools/scripts/inventaire.py data/NORDEND --debut 2026-11-05T00:00Z --fin 2026-11-06T00:00Z
.venv/bin/python tools/scripts/graphique.py data/NORDEND --debut 2026-11-05T00:00Z --fin 2026-11-06T00:00Z --sortie out/diagnostic
Sans --sortie, les figures vont dans out/diagnostic/ du dossier courant. Bibliothèque standard ; matplotlib (par le .venv de l'appelant) pour les figures seulement.
Qui le fait évoluer
Seul le tool-builder (dépôt agents) y écrit, après une analyse : il fait entrer les scripts utiles de l'analyste dans les outils, il optimise ou ajoute, il ne retire rien.
Copié de Diagnostic-App (agent-tools/ et le skill lire-les-donnees, commit dd6f1bf) le 2026-11-16. L'architecture des dépôts : ~/Diagnostic-App/docs/architecture.drawio.