Agent tools: reading tools moved to agent-tools/ (D-081)
The reading tools leave agents/diagnostic/outils/ for a root folder of their own; paths updated in skills, agents, detectors, scripts, case fiches, support/, contexts and CLAUDE.md; graphique, vignettes and gif find the repo root one level up; history keeps old paths. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
cb98818712
commit
56b93e9b82
55 files changed
+135
-127
No files matched your search
@@ -22,7 +22,7 @@ Journal du matin du client (D-056), le cap actuel : onglet `Journal` de la maque
|
||||
|
||||
Boucle automatique (D-057), lancée par l'utilisateur seul, sur les lots qu'il choisit : `/boucle <dossier de station> [--du … --au …]` fait juger les détecteurs du journal, lot après lot, par un analyste, les fait corriger par un upgrader contrôlé par un validateur, et ajoute les nouveautés à la base de cas par un builder ; une séance commitée directement sur `master` (D-070), ses rendus dans `boucle/<séance>_<STATION>/lot-NN/` (dont les étiquettes de l'analyste, `etiquettes.json`, D-061, et `score-avant.txt`, le score des détecteurs face à toutes les étiquettes, D-062) et son `bilan.md`, hors de tout dossier de station ; en fin de séance, la page `out/boucle_<séance>.html` montre l'analyste face aux détecteurs (D-066) ; à chaque lot et après chaque modification, le benchmark des détecteurs sur la base de cas (`.claude/skills/boucle/benchmark.py`, historique dans `benchmark/historique.csv`, D-069) ; avec `--ameliorer`, l'améliorateur corrige ensuite le skill et ses agents d'après les relevés du releveur (D-071) ; spec `contexte/boucle-automatique.md`.
|
||||
|
||||
Aiguiser la lecture (D-059), lancé par l'utilisateur seul, sur les lots qu'il choisit : `/aiguiser <dossier de station> [--du … --au …]` améliore les outils de lecture (`agents/diagnostic/outils/`) et leur mode d'emploi, le skill `lire-les-donnees`, que suivent l'analyste et l'agent de diagnostic : un lecteur lit le lot avec le skill, un correcteur le lit à fond avec ses propres scripts et mesure l'écart, un optimiseur modifie le skill, un changement sans gain est annulé ; commandes des fiches lancées en fin de séance (D-064) ; une séance commitée directement sur `master` (D-077), ses rendus dans `aiguiser/<séance>_<STATION>/lot-NN/` et `bilan.md`, hors de tout dossier de station ; avec `--ameliorer`, l'améliorateur corrige ensuite le skill et ses agents d'après les relevés du releveur (D-076) ; spec `contexte/aiguiser-la-lecture.md`.
|
||||
Aiguiser la lecture (D-059), lancé par l'utilisateur seul, sur les lots qu'il choisit : `/aiguiser <dossier de station> [--du … --au …]` améliore les outils de lecture (`agent-tools/`) et leur mode d'emploi, le skill `lire-les-donnees`, que suivent l'analyste et l'agent de diagnostic : un lecteur lit le lot avec le skill, un correcteur le lit à fond avec ses propres scripts et mesure l'écart, un optimiseur modifie le skill, un changement sans gain est annulé ; commandes des fiches lancées en fin de séance (D-064) ; une séance commitée directement sur `master` (D-077), ses rendus dans `aiguiser/<séance>_<STATION>/lot-NN/` et `bilan.md`, hors de tout dossier de station ; avec `--ameliorer`, l'améliorateur corrige ensuite le skill et ses agents d'après les relevés du releveur (D-076) ; spec `contexte/aiguiser-la-lecture.md`.
|
||||
|
||||
## Règles
|
||||
|
||||
|
||||
@@ -5,7 +5,7 @@ Usage : python3 vues-deplacements/aiguiser/voir.py data/NORDEND/ --debut 2026-09
|
||||
|
||||
Lance, avec les réglages du skill lire-les-donnees, inventaire, ensemble, resume, graphique et vignettes.
|
||||
La page est rangée dans out/voir/<STATION>_<début>_<fin>_<version des outils>/ ; la version est le hash
|
||||
git de agents/diagnostic/outils/ (« +modif » si le dossier a des changements non commités) : deux pages de
|
||||
git de agent-tools/ (« +modif » si le dossier a des changements non commités) : deux pages de
|
||||
versions différentes se comparent côte à côte. Sans --capteurs, les vignettes montrent les 3 capteurs qui
|
||||
s'écartent le plus de leur niveau habituel (error_value, en MAD) et le plus calme comme témoin.
|
||||
Rend ce que les outils rendent, aucun verdict.
|
||||
@@ -19,7 +19,7 @@ import subprocess
|
||||
import sys
|
||||
|
||||
RACINE = os.path.normpath(os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", ".."))
|
||||
OUTILS = os.path.join(RACINE, "agents", "diagnostic", "outils")
|
||||
OUTILS = os.path.join(RACINE, "agent-tools")
|
||||
sys.path.insert(0, OUTILS)
|
||||
from donnees import charger, est_reference, filtrer, heure_image, instant, iso, trouver # noqa: E402
|
||||
|
||||
@@ -31,8 +31,8 @@ NB_IMAGES = 5
|
||||
|
||||
def version_outils():
|
||||
sh = lambda *a: subprocess.run(["git", "-C", RACINE, *a], capture_output=True, text=True).stdout.strip()
|
||||
h = sh("rev-parse", "--short", "HEAD:agents/diagnostic/outils")
|
||||
return h + ("+modif" if sh("status", "--porcelain", "--", "agents/diagnostic/outils") else "")
|
||||
h = sh("rev-parse", "--short", "HEAD:agent-tools")
|
||||
return h + ("+modif" if sh("status", "--porcelain", "--", "agent-tools") else "")
|
||||
|
||||
|
||||
def ecarts(par, debut, fin):
|
||||
|
||||
@@ -31,7 +31,7 @@ On veut donc un autre processus automatique, à part de `/boucle`, qui ne travai
|
||||
|
||||
## 3. Ce qui existe
|
||||
|
||||
- **Les outils de lecture**, `agents/diagnostic/outils/` (419 lignes) : `donnees.py` (lecture commune des exports), `inventaire.py`, `resume.py`, `graphique.py` (PNG des séries), `vignettes.py` (gros plans des capteurs sur les images). Bibliothèque standard, matplotlib par `.venv` pour les figures. Ils rendent des valeurs, jamais des verdicts.
|
||||
- **Les outils de lecture**, `agent-tools/` (419 lignes) : `donnees.py` (lecture commune des exports), `inventaire.py`, `resume.py`, `graphique.py` (PNG des séries), `vignettes.py` (gros plans des capteurs sur les images). Bibliothèque standard, matplotlib par `.venv` pour les figures. Ils rendent des valeurs, jamais des verdicts.
|
||||
- **Leur mode d'emploi est recopié à deux endroits** : le tableau « Tes outils » et l'étape 1 de `.claude/skills/critiquer-lot/SKILL.md` (l'analyste), le §3 et une partie du §4 (étapes 1, 2 et 4) de `agents/diagnostic/instructions.md` (l'agent de diagnostic).
|
||||
- **Les cinq cas validés**, `events/C-001/` à `C-005/` : données (`displacement/`, `images/`), fiche `cas.md` (signature en critères, avec leurs commandes) et figures, dans le même dossier.
|
||||
- **Le modèle de `/boucle`** (D-057, `vues-deplacements/contexte/boucle-automatique.md`, skill `.claude/skills/boucle/SKILL.md`) : un skill orchestrateur dans la conversation principale, des sous-agents qui ne se parlent pas et écrivent chacun un rendu, une ligne `**Verdict** :` lue par `grep`, des commits par chemin, une branche par séance, un `bilan.md`. Un passage de l'analyste coûte environ 250 000 jetons et 8 min 30 (essai du 2026-10-24).
|
||||
@@ -48,7 +48,7 @@ Il ne contient ni catégorie, ni cas, ni hypothèse, ni verdict : c'est l'affair
|
||||
|
||||
**Ceux qui l'utilisent** : l'analyste (« Tes outils » et l'étape 1 de `critiquer-lot` renvoient au skill ; l'étape 1 garde la catégorie de la carte, ajoutée après la lecture), l'agent de diagnostic (le §3 de ses instructions renvoie au skill et garde la ligne `categories.py` et la remarque sur `--sortie` ; ses étapes de diagnostic ne changent pas) et le lecteur (§6). Les sous-agents le lisent par Read, comme l'analyste lit `critiquer-lot` *(choix de Claude)*.
|
||||
|
||||
**L'optimiseur touche à deux choses, et seulement à elles** : les scripts de `agents/diagnostic/outils/` (y compris un nouveau script) et `lire-les-donnees/SKILL.md`.
|
||||
**L'optimiseur touche à deux choses, et seulement à elles** : les scripts de `agent-tools/` (y compris un nouveau script) et `lire-les-donnees/SKILL.md`.
|
||||
|
||||
## 5. Une séance
|
||||
|
||||
@@ -95,7 +95,7 @@ Il teste le skill : il lit `lire-les-donnees/SKILL.md` et le suit, rien d'autre.
|
||||
|
||||
C'est le validateur des outils de lecture ; « correcteur » parce qu'il compare une copie à un corrigé (accepté). Outils : Read, Bash, Write. Deux demandes :
|
||||
|
||||
- **Lecture lente** : il lit le lot sans limite, avec **ses propres scripts** (bibliothèque standard, matplotlib par `.venv`), rangés avec ses figures dans `lot-NN/corrige/`, sur les exports bruts, et autant d'images qu'il le juge utile. Il peut lire `docs/domaine/` et la carte des événements. **Il n'utilise pas** `agents/diagnostic/outils/`, pas même `donnees.py` (une erreur de lecture commune passerait inaperçue) *(choix de Claude)*, ne lit pas `lire-les-donnees/SKILL.md`, ni les détecteurs, ni la base de cas, et il écrit `corrige.md` **avant** d'ouvrir la lecture. `corrige.md` a le même tableau que la lecture, pour comparer ligne à ligne *(choix de Claude)*. Puis il écrit l'écart (ci-dessous).
|
||||
- **Lecture lente** : il lit le lot sans limite, avec **ses propres scripts** (bibliothèque standard, matplotlib par `.venv`), rangés avec ses figures dans `lot-NN/corrige/`, sur les exports bruts, et autant d'images qu'il le juge utile. Il peut lire `docs/domaine/` et la carte des événements. **Il n'utilise pas** `agent-tools/`, pas même `donnees.py` (une erreur de lecture commune passerait inaperçue) *(choix de Claude)*, ne lit pas `lire-les-donnees/SKILL.md`, ni les détecteurs, ni la base de cas, et il écrit `corrige.md` **avant** d'ouvrir la lecture. `corrige.md` a le même tableau que la lecture, pour comparer ligne à ligne *(choix de Claude)*. Puis il écrit l'écart (ci-dessous).
|
||||
- **Écart seul** : `corrige.md`, la nouvelle lecture et le dernier écart ; il peut revenir aux données pour trancher (le lecteur a pu voir juste là où le corrigé s'est trompé : alors il corrige le corrigé et le dit).
|
||||
|
||||
`ecart-K.md` :
|
||||
@@ -130,7 +130,7 @@ aucune | - <moment, capteurs, ce qui le montre>
|
||||
|
||||
Il reprend les défauts du dernier écart (et la modification annulée, s'il y en a une) et modifie le skill. Outils : Read, Edit, Write, Bash. Il peut lire le corrigé, les scripts du correcteur, la partie « ce qui m'a manqué » des lectures et les données du lot.
|
||||
|
||||
- Il ne touche qu'à `agents/diagnostic/outils/` et à `lire-les-donnees/SKILL.md` (§4).
|
||||
- Il ne touche qu'à `agent-tools/` et à `lire-les-donnees/SKILL.md` (§4).
|
||||
- **Le plus simple d'abord** (accepté) : une phrase du mode d'emploi ou un réglage par défaut ; sinon une option d'un outil existant ; un nouvel outil en dernier recours.
|
||||
- **Interdits** (accepté) : aucun jugement dans ce que rend un outil (ni seuil, ni catégorie, ni « anomalie ») ; rien de propre à une station, à un capteur ou à une date ; aucun import des détecteurs (`vues-deplacements/detectors/`) ; bibliothèque standard, matplotlib pour les figures seulement.
|
||||
- **Ne rien casser** : les options et les sorties existantes restent ; une commande citée par une fiche de cas marche toujours *(constaté dans les fiches)*. Il relance l'outil modifié sur le lot, et une commande d'une fiche qui l'emploie.
|
||||
|
||||
@@ -32,7 +32,7 @@ L'analyste et le validateur ne laissent rien de durable eux-mêmes : ce sont les
|
||||
## 3. Ce qui existe et que la boucle réutilise
|
||||
|
||||
- Les détecteurs du journal : `vues-deplacements/detectors/*.py`, contrat `detect(mesures)`, classés en événements par `categories.py`. Le tri en lot existe (point 30, validé) : `python3 vues-deplacements/detectors/categories.py <dossier> --du AAAA-MM-JJ --au AAAA-MM-JJ --tranche 4 --historique 3`. Chaque lot est classé avec les 3 jours d'avant : c'est la règle pour la boucle (D-056).
|
||||
- Les outils de lecture des données, `agents/diagnostic/outils/` : `inventaire.py`, `resume.py`, `graphique.py` (PNG des séries), `vignettes.py` (gros plans des cibles sur les images) ; leur mode d'emploi est le skill `.claude/skills/lire-les-donnees/`, que suit l'analyste ; ils évoluent par `/aiguiser` (D-059, `aiguiser-la-lecture.md`), pas par la boucle. Seuls les outils servent : l'agent de diagnostic, lui, n'est pas appelé.
|
||||
- Les outils de lecture des données, `agent-tools/` : `inventaire.py`, `resume.py`, `graphique.py` (PNG des séries), `vignettes.py` (gros plans des cibles sur les images) ; leur mode d'emploi est le skill `.claude/skills/lire-les-donnees/`, que suit l'analyste ; ils évoluent par `/aiguiser` (D-059, `aiguiser-la-lecture.md`), pas par la boucle. Seuls les outils servent : l'agent de diagnostic, lui, n'est pas appelé.
|
||||
- La carte des événements, `events/carte-des-evenements.md` : ce qui peut arriver, en familles, et les catégories du journal (section 4).
|
||||
- La base de cas, `events/` : l'index `INDEX.md`, le modèle de fiche (§11.3 de `docs/agents/agent-diagnostic.md`), le skill `anonymiser-cas` (données copiées dans le dossier du cas, noms codés, D-049, D-050). Les cas existants ne se modifient jamais ; la boucle en ajoute.
|
||||
- Le registre des seuils, `vues-deplacements/contexte/seuils-du-journal.md` : une constante changée le met à jour dans le même changement.
|
||||
|
||||
@@ -4,7 +4,7 @@
|
||||
|
||||
## Recommandation
|
||||
|
||||
**Option A, avec un seul script** (`extraction/pomper.py`, essayé le 2026-10-26) : il réutilise les lectures de l'appli, ouvre un moteur PostgreSQL **en lecture seule** (comme `scripts/domain_diagnostics.py`, déjà lancé avec succès dans le container le 2026-10-21) et écrit, un fichier par jour, les métriques système (`data/<STATION>/metrics/<STATION>_<métrique>_….csv`, le format du téléchargement de la page System, que lit `common.stations`), `data/<STATION>/displacement/…_advanced_….csv` et `data/<STATION>/images/…jpg`, les formats que `agents/diagnostic/outils/donnees.py` (`trouver`, `heure_image`) lit déjà (point 43 du plan). B n'est pas une autre solution : c'est ce même script lancé depuis WSL, si la base y est joignable (non vérifié). C (une route d'export) vient seulement si la boucle prouve sa valeur.
|
||||
**Option A, avec un seul script** (`extraction/pomper.py`, essayé le 2026-10-26) : il réutilise les lectures de l'appli, ouvre un moteur PostgreSQL **en lecture seule** (comme `scripts/domain_diagnostics.py`, déjà lancé avec succès dans le container le 2026-10-21) et écrit, un fichier par jour, les métriques système (`data/<STATION>/metrics/<STATION>_<métrique>_….csv`, le format du téléchargement de la page System, que lit `common.stations`), `data/<STATION>/displacement/…_advanced_….csv` et `data/<STATION>/images/…jpg`, les formats que `agent-tools/donnees.py` (`trouver`, `heure_image`) lit déjà (point 43 du plan). B n'est pas une autre solution : c'est ce même script lancé depuis WSL, si la base y est joignable (non vérifié). C (une route d'export) vient seulement si la boucle prouve sa valeur.
|
||||
|
||||
## Ce que j'ai trouvé
|
||||
|
||||
|
||||
@@ -19,7 +19,7 @@ import statistics
|
||||
import sys
|
||||
from datetime import timedelta
|
||||
|
||||
sys.path.insert(0, os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "..", "..", "agents", "diagnostic", "outils"))
|
||||
sys.path.insert(0, os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "..", "..", "agent-tools"))
|
||||
from donnees import charger, iso # noqa: E402
|
||||
|
||||
NIVEAU = 0.2 # provisoire, réglé sur NORDEND d'octobre (buée du 08/10 : 10 à 20 % rejetées), C-002 (toile : 30 à 40 %)
|
||||
|
||||
@@ -23,7 +23,7 @@ import sys
|
||||
from datetime import datetime, timedelta, timezone
|
||||
from pathlib import Path
|
||||
|
||||
sys.path.insert(0, os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "..", "agents", "diagnostic", "outils"))
|
||||
sys.path.insert(0, os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "..", "agent-tools"))
|
||||
from donnees import charger, iso # noqa: E402
|
||||
|
||||
# ignore : zone grisée (None : comme le dit le détecteur, la turbulence n'est grisée que forte) ; process : bouton
|
||||
|
||||
@@ -22,7 +22,7 @@ import os
|
||||
import statistics
|
||||
import sys
|
||||
|
||||
sys.path.insert(0, os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "..", "agents", "diagnostic", "outils"))
|
||||
sys.path.insert(0, os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "..", "agent-tools"))
|
||||
from donnees import charger, est_reference, iso # noqa: E402
|
||||
|
||||
CALME = 0.25 # part des autres capteurs rejetés au plus, pour un instant calme
|
||||
|
||||
@@ -14,7 +14,7 @@ import os
|
||||
import statistics
|
||||
import sys
|
||||
|
||||
sys.path.insert(0, os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "..", "agents", "diagnostic", "outils"))
|
||||
sys.path.insert(0, os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "..", "agent-tools"))
|
||||
from donnees import charger, est_reference, iso # noqa: E402
|
||||
|
||||
HEURES = 20 # un jour compte s'il a au moins 20 heures mesurées (comme D-055)
|
||||
|
||||
@@ -56,7 +56,7 @@ import sys
|
||||
from datetime import timedelta
|
||||
from pathlib import Path
|
||||
|
||||
sys.path.insert(0, str(Path(__file__).resolve().parents[2] / "agents" / "diagnostic" / "outils"))
|
||||
sys.path.insert(0, str(Path(__file__).resolve().parents[2] / "agent-tools"))
|
||||
import donnees # noqa: E402
|
||||
|
||||
K = 20 # provisoire, réglé sur C-001 : à 15, deux cibles saines y sont grisées (17 et 18 bruits) ; les trains de
|
||||
|
||||
@@ -45,7 +45,7 @@ import statistics
|
||||
import sys
|
||||
from datetime import datetime, timedelta, timezone
|
||||
|
||||
sys.path.insert(0, os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "..", "agents", "diagnostic", "outils"))
|
||||
sys.path.insert(0, os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "..", "agent-tools"))
|
||||
from donnees import charger, iso # noqa: E402
|
||||
|
||||
HEURES_MIN = 20 # provisoire : un jour UTC compte s'il a au moins 20 heures mesurées
|
||||
|
||||
@@ -11,7 +11,7 @@ import os
|
||||
import statistics
|
||||
import sys
|
||||
|
||||
sys.path.insert(0, os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "..", "agents", "diagnostic", "outils"))
|
||||
sys.path.insert(0, os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "..", "agent-tools"))
|
||||
from donnees import charger, iso # noqa: E402
|
||||
|
||||
MISSING = 2 # au-delà de 2 pas manquants, c'est un trou (consigne de l'utilisateur, 2026-10-23)
|
||||
|
||||
@@ -22,7 +22,7 @@ import statistics
|
||||
import sys
|
||||
from datetime import timedelta
|
||||
|
||||
sys.path.insert(0, os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "..", "agents", "diagnostic", "outils"))
|
||||
sys.path.insert(0, os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "..", "agent-tools"))
|
||||
from donnees import charger, iso # noqa: E402
|
||||
|
||||
RATIO = 1.5 # provisoire, réglé sur C-003 (WILDSTRUBEL : de jour, corr ×1,7 à ×3 la nuit)
|
||||
|
||||
@@ -54,7 +54,7 @@ import statistics
|
||||
import sys
|
||||
from datetime import timedelta
|
||||
|
||||
sys.path.insert(0, os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "..", "agents", "diagnostic", "outils"))
|
||||
sys.path.insert(0, os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "..", "agent-tools"))
|
||||
from donnees import charger, iso # noqa: E402
|
||||
|
||||
K_MAD = 10 # provisoire, réglé sur C-001 (buée : 11 à 57 MAD) et C-005 (pluie, trains : 10 à 70 MAD)
|
||||
|
||||
@@ -22,7 +22,7 @@ ROOT = HERE.parents[1]
|
||||
OUT = ROOT / "out"
|
||||
DEFAULT = ROOT / "vues-deplacements" / "cas" / "2026-10_NORDEND" / "NORDEND"
|
||||
sys.path.insert(0, str(ROOT / "src"))
|
||||
sys.path.insert(0, str(ROOT / "agents" / "diagnostic" / "outils"))
|
||||
sys.path.insert(0, str(ROOT / "agent-tools"))
|
||||
sys.path.insert(0, str(ROOT / "vues-deplacements" / "detectors"))
|
||||
from common.page import AUTOSCALE_Y_JS, open_html # noqa: E402 (bascule seule sur .venv si plotly manque)
|
||||
import donnees # noqa: E402 (lecture des exports, bibliothèque standard)
|
||||
|
||||
@@ -133,7 +133,7 @@ Le « journal du matin » du client (utilisateur, 2026-10-23) : il ouvre Explore
|
||||
## Fichiers et flux
|
||||
|
||||
- `vues-deplacements/maquette/explore.py [dossier de station]` (défaut `vues-deplacements/cas/2026-10_NORDEND/NORDEND/`) :
|
||||
- lit l'export « advanced » avec `agents/diagnostic/outils/donnees.py` (`charger`, `trouver`, `heure_image`), sans le copier ;
|
||||
- lit l'export « advanced » avec `agent-tools/donnees.py` (`charger`, `trouver`, `heure_image`), sans le copier ;
|
||||
- lit l'export horaire (déplacements en mm, heure suisse convertie en UTC), calcule la position médiane de chaque capteur et liste les images avec leur heure ;
|
||||
- injecte un JSON dans `explore_template.html` et écrit `out/vues_deplacements_<STATION>.html` (`<STATION>` : nom du dossier ; pour un dossier de cas, le nom du cas, par exemple `2026-10_NORDEND`), puis l'ouvre (`src/common/page.py`, `open_html`).
|
||||
- `vues-deplacements/maquette/explore_template.html` : habillage, onglets, plotly.js 4.1.1 par CDN (comme les maquettes existantes), JS de la liaison.
|
||||
|
||||
Reference in new issue
Block a user