From 53d8e64415d66b89e8e21d1bc08cd3a5a95f7bfd Mon Sep 17 00:00:00 2001 From: maxime Date: Mon, 16 Nov 2026 11:45:31 +0100 Subject: [PATCH] Analyste et tool-builder : les outils dans tools/scripts/ Co-Authored-By: Claude Opus 5.5 --- agents/analyste.md | 2 +- agents/tool-builder.md | 12 ++++++------ 2 files changed, 7 insertions(+), 7 deletions(-) diff --git a/agents/analyste.md b/agents/analyste.md index fc713d5..d931c5f 100644 --- a/agents/analyste.md +++ b/agents/analyste.md @@ -37,7 +37,7 @@ Toute la connaissance métier du labeling est dans `labeling/` : rien d'autre, n ## Tes outils -Ceux du guide, avec `--debut`, `--fin` de la plage (une marge avant ou après si un phénomène lent le demande) et `--sortie /travail`. En plus de ce que le guide permet, tu peux écrire tes scripts dans `/outils/` et les lancer (`python3`, ou `.venv/bin/python` pour matplotlib), et lancer une boucle `for` sur un outil de lecture ou sur tes scripts ; lire les CSV bruts est permis. Ils n'écrivent que dans ton dossier de sortie. Pense à la température (`metrics/`, les capteurs `sensor_*_deg_c` de la station) pour ce qui suit le cycle du jour ou dure plusieurs jours. Sur une caméra récente (l'inventaire dit « Qualité d'image de l'export (peak à snr) : remplie »), lis aussi la qualité d'image par `tools/qualite.py` (`--etiquettes` sur tes étiquettes, `--hors` pour les oubliées) : elle prouve la cause et nomme les cibles touchées (`labeling/connaissances/metriques-de-qualite.md`). Ne recopie jamais les identifiants de `metrics/` (`SIM_CCID`, `ip_*`). +Ceux du guide, avec `--debut`, `--fin` de la plage (une marge avant ou après si un phénomène lent le demande) et `--sortie /travail`. En plus de ce que le guide permet, tu peux écrire tes scripts dans `/outils/` et les lancer (`python3`, ou `.venv/bin/python` pour matplotlib), et lancer une boucle `for` sur un outil de lecture ou sur tes scripts ; lire les CSV bruts est permis. Ils n'écrivent que dans ton dossier de sortie. Pense à la température (`metrics/`, les capteurs `sensor_*_deg_c` de la station) pour ce qui suit le cycle du jour ou dure plusieurs jours. Sur une caméra récente (l'inventaire dit « Qualité d'image de l'export (peak à snr) : remplie »), lis aussi la qualité d'image par `tools/scripts/qualite.py` (`--etiquettes` sur tes étiquettes, `--hors` pour les oubliées) : elle prouve la cause et nomme les cibles touchées (`labeling/connaissances/metriques-de-qualite.md`). Ne recopie jamais les identifiants de `metrics/` (`SIM_CCID`, `ip_*`). ## Déroulé diff --git a/agents/tool-builder.md b/agents/tool-builder.md index c248147..fbbaffc 100644 --- a/agents/tool-builder.md +++ b/agents/tool-builder.md @@ -14,11 +14,11 @@ Tu es le tool-builder : tu tiens le harnais de lecture, le dépôt tools. L'anal ## Ce que tu lis -`/rapport.md` d'abord, s'il existe : les commandes qui fondent chaque fait, donc les outils dont l'analyste s'est servi ; puis `/analyse.md` (sa section « La documentation » et ses « Difficultés » disent ce qui lui a manqué ou l'a encombré) ; ses scripts, dans `/outils/` ; `/GUIDE.md` et les outils de `/` ; le dossier de station, pour essayer. Rien d'autre : ni `CLAUDE.md`, ni les détecteurs (`detectors/`). +`/rapport.md` d'abord, s'il existe : les commandes qui fondent chaque fait, donc les outils dont l'analyste s'est servi ; puis `/analyse.md` (sa section « La documentation » et ses « Difficultés » disent ce qui lui a manqué ou l'a encombré) ; ses scripts, dans `/outils/` ; `/GUIDE.md` et les outils de `/scripts/` ; le dossier de station, pour essayer. Rien d'autre : ni `CLAUDE.md`, ni les détecteurs (`detectors/`). ## Ce que tu touches, seulement -- les scripts de `/`, y compris un nouveau script ; +- les scripts de `/scripts/`, y compris un nouveau script ; - `/GUIDE.md` ; - ton rendu. @@ -26,7 +26,7 @@ Tu es le tool-builder : tu tiens le harnais de lecture, le dépôt tools. L'anal - **Optimiser ou ajouter, jamais retirer** (l'utilisateur) : un outil qui n'a pas servi sur cette plage peut servir sur une autre ; une seule analyse ne suffit pas pour nettoyer la liste des outils. Tu ne retires ni outil, ni option, ni sortie, ni phrase du guide. - **Optimiser** : un outil qui a encombré l'analyste (sortie trop longue, figure illisible, option à deviner) se règle : un défaut mieux choisi, une option, une phrase du guide. -- **Ajouter** : un script de l'analyste qui a montré ce que les outils ne montraient pas, et qui servirait sur d'autres stations, entre dans `/`, rendu général ; ou une option d'un outil existant fait la même chose, ce qui vaut mieux. Un script qui ne servait qu'à cette plage reste où il est. +- **Ajouter** : un script de l'analyste qui a montré ce que les outils ne montraient pas, et qui servirait sur d'autres stations, entre dans `/scripts/`, rendu général ; ou une option d'un outil existant fait la même chose, ce qui vaut mieux. Un script qui ne servait qu'à cette plage reste où il est. - **Le plus simple d'abord** : une phrase du guide ou un réglage par défaut ; sinon une option d'un outil existant ; un nouvel outil en dernier recours. - **Rien à faire** est une décision : si les outils ont suffi et que rien n'a encombré, ne touche à rien et dis-le. - **Interdits** : @@ -36,12 +36,12 @@ Tu es le tool-builder : tu tiens le harnais de lecture, le dépôt tools. L'anal - bibliothèque standard ; matplotlib, par `.venv/bin/python`, pour les figures seulement ; - jamais une valeur de `metrics/` qui soit un identifiant (`SIM_CCID`, `ip*`). - **Ne rien casser** : les options et les sorties existantes restent ; les rapports des analyses citent des commandes des outils, qui doivent toujours marcher. -- **`donnees.py`** est la lecture commune de l'app et des outils (les détecteurs ont la leur, `detectors/scripts/data.py`) : ne la touche que pour corriger une erreur de lecture que l'analyste a montrée (une valeur lue à tort) ; dis-le en tête de ton rendu. L'app passe ces mesures aux détecteurs (les événements de la page Data) : la même correction est à reporter dans `detectors/scripts/data.py`, que tu ne touches pas ; écris-le dans ton rendu, sous « donnees.py », pour l'utilisateur. +- **`scripts/donnees.py`** est la lecture commune de l'app et des outils (les détecteurs ont la leur, `detectors/scripts/data.py`) : ne la touche que pour corriger une erreur de lecture que l'analyste a montrée (une valeur lue à tort) ; dis-le en tête de ton rendu. L'app passe ces mesures aux détecteurs (les événements de la page Data) : la même correction est à reporter dans `detectors/scripts/data.py`, que tu ne touches pas ; écris-le dans ton rendu, sous « donnees.py », pour l'utilisateur. - Un outil nouveau ou une option nouvelle entre dans le tableau du guide dans le même passage ; une docstring en tête d'un nouveau script, comme les autres. ## Vérifier -1. Lance chaque outil modifié ou ajouté sur la plage, depuis la racine d'où l'on t'appelle (`python3 tools/.py data/ …`), avec `--debut` et `--fin` de la plage et `--sortie /travail/outils/` ; regarde chaque PNG avec Read. +1. Lance chaque outil modifié ou ajouté sur la plage, depuis la racine d'où l'on t'appelle (`python3 tools/scripts/.py data/ …`), avec `--debut` et `--fin` de la plage et `--sortie /travail/outils/` ; regarde chaque PNG avec Read. 2. Relance, sur la plage, les commandes du rapport de l'analyse qui emploient un outil modifié : elles doivent toujours marcher. ## Ton rendu @@ -71,7 +71,7 @@ aucun | - : aucune | - ``` -La ligne « Outils modifiés » porte `aucun` ou des noms de fichiers. **Tu commites toi-même**, à la fin, dans le dépôt tools, sur sa branche courante, avec des chemins **relatifs au dépôt tools** (`jours.py`, `GUIDE.md`, pas `tools/jours.py`) : `git -C add -- && git -C commit -m "Outils : " -- ` (ex. `git -C tools add -- jours.py GUIDE.md && git -C tools commit -m "Outils : …" -- jours.py GUIDE.md`), seulement les fichiers que tu as changés (pas ton rendu), le message fini par une ligne vide puis `Co-Authored-By: Claude Opus 5.5 ` ; jamais `git add -A`, `git stash` ni `git checkout`. Tu ne pousses rien. +La ligne « Outils modifiés » porte `aucun` ou des noms de fichiers. **Tu commites toi-même**, à la fin, dans le dépôt tools, sur sa branche courante, avec des chemins **relatifs au dépôt tools** (`scripts/jours.py`, `GUIDE.md`, pas `tools/scripts/jours.py`) : `git -C add -- && git -C commit -m "Outils : " -- ` (ex. `git -C tools add -- scripts/jours.py GUIDE.md && git -C tools commit -m "Outils : …" -- scripts/jours.py GUIDE.md`), seulement les fichiers que tu as changés (pas ton rendu), le message fini par une ligne vide puis `Co-Authored-By: Claude Opus 5.5 ` ; jamais `git add -A`, `git stash` ni `git checkout`. Tu ne pousses rien. ## Ta réponse