Move the reading method into a shared lire-les-donnees skill
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
4d14f5ea5d
commit
a0550869aa
3 files changed
+64
-24
No files matched your search
@@ -14,8 +14,9 @@ Tu reçois : le dossier de station, le lot (début et fin, UTC), la commande du
|
||||
|
||||
## Ce que tu as le droit de lire, seulement
|
||||
|
||||
- le dossier de station, par tes outils, et ses images avec Read ;
|
||||
- `docs/domaine/colonnes-des-deplacements.md` (lis-le en premier) et `docs/domaine/pieges-des-donnees.md` ;
|
||||
- `.claude/skills/lire-les-donnees/SKILL.md` (lis-le en premier) : tes outils et ta façon de lire ;
|
||||
- le dossier de station, par ces outils, et ses images avec Read ;
|
||||
- `docs/domaine/colonnes-des-deplacements.md` et `docs/domaine/pieges-des-donnees.md`, que ce skill cite ;
|
||||
- `docs/displacement/domaine/carte-des-evenements.md` : ce qui peut arriver, en familles, et les catégories du journal (section 4) ;
|
||||
- à l'étape 4 seulement, jamais avant : `agents/diagnostic/cas/INDEX.md`, puis les fiches `cas.md` qu'il cite et leurs figures.
|
||||
|
||||
@@ -23,21 +24,11 @@ Rien d'autre : ni `CLAUDE.md`, ni `docs/decisions.md`, ni les plans, ni rien dan
|
||||
|
||||
## Tes outils
|
||||
|
||||
Lance-les depuis la racine du dépôt ; ils rendent des valeurs, c'est toi qui juges. Instants : `2026-10-05T00:00Z`.
|
||||
|
||||
| Commande | Ce qu'elle rend |
|
||||
|---|---|
|
||||
| `python3 agents/diagnostic/outils/inventaire.py <dossier>` | Fichiers, images (heures couvertes), période, cadence, mesures manquantes, capteurs (référence ou cible, seuil d'erreur, rejets) |
|
||||
| `python3 agents/diagnostic/outils/resume.py <dossier> [--colonne C] [--stat median\|min\|max] [--pas 1h] [--capteurs A,B] [--debut T] [--fin T]` | Niveau habituel de chaque capteur (médiane, MAD, min, max), puis un tableau par pas de temps. Colonnes : `error_value`, `corr_x`, `corr_y`, `relative_x`, `relative_y`, `x`, `y`, `sigma0`, `reproj_err` |
|
||||
| `.venv/bin/python agents/diagnostic/outils/graphique.py <dossier> [--capteurs A,B] [--colonnes C1,C2] [--debut T] [--fin T] [--zone T1/T2 ...] --sortie <dossier de sortie>` | Un PNG des séries, chaque `--zone` grisée ; **regarde-le avec Read** |
|
||||
| `.venv/bin/python agents/diagnostic/outils/vignettes.py <dossier> --capteurs A,B --heures T1,T2 [--rayon 100] --sortie <dossier de sortie>` | Gros plans des capteurs sur les images, à pleine résolution ; **regarde-la avec Read** |
|
||||
| `ls <dossier>/images/`, puis Read sur une image | L'image entière, pour la scène (occultation, éclairage, météo) |
|
||||
|
||||
Bash ne sert qu'à lancer ces outils, la commande du lot, `ls`, `grep` et `date`. N'écris aucun autre script.
|
||||
Ceux de `lire-les-donnees`, avec `--debut` et `--fin` du lot et `--sortie <dossier de sortie>` pour tes figures. Bash sert aussi à lancer la commande du lot. N'écris aucun autre script.
|
||||
|
||||
## Déroulé
|
||||
|
||||
1. **Ta lecture, sans les détecteurs.** Inventaire ; courbes du lot (`error_value`, puis `corr_x`, `corr_y` ou `relative_x`, `relative_y`, références et cibles) ; vignettes espacées, une toutes les 2 à 3 h, plus serrées là où les courbes bougent ; images entières pour la scène. Note chaque moment : début, fin, capteurs, ce que tu vois, la catégorie de la carte qui conviendrait, ou « aucune catégorie ». **Écris cette partie dans ton fichier avant l'étape 2.**
|
||||
1. **Ta lecture, sans les détecteurs.** Lis le lot comme le dit `lire-les-donnees`. À chaque moment de son tableau, ajoute la catégorie de la carte qui conviendrait, ou « aucune catégorie ». **Écris cette partie dans ton fichier avant l'étape 2.**
|
||||
2. **Les détecteurs.** Lance la commande du lot telle qu'elle est donnée ; colle sa sortie.
|
||||
3. **Comparaison**, événement par événement et moment par moment : juste ; catégorie fausse ; en trop ; bornes fausses (en retard, trop tôt, trop large) ; manquant. Une ligne chacun, avec pourquoi.
|
||||
4. **Cas connus**, après les faits : lis l'index, ouvre au plus 3 fiches proches de tes moments. Ce que la base connaît déjà, cas marqués « (appris) » compris.
|
||||
@@ -54,7 +45,7 @@ Bash ne sert qu'à lancer ces outils, la commande du lot, `ls`, `grep` et `date`
|
||||
**Verdict** : d'accord | suggestions
|
||||
|
||||
## 1. Ma lecture
|
||||
| Début | Fin | Capteurs | Ce que je vois | Catégorie |
|
||||
| Début | Fin | Capteurs | Colonnes | Ce que je vois | Images | Catégorie |
|
||||
|
||||
## 2. Ce qu'ont trouvé les détecteurs
|
||||
<sortie de la commande du lot>
|
||||
|
||||
@@ -0,0 +1,54 @@
|
||||
---
|
||||
name: lire-les-donnees
|
||||
description: Lire un dossier de données de déplacement d'une station AIMsight, courbes et images, avec les outils de lecture — ce qu'ils rendent et comment s'en servir. Suivi par l'analyste (critiquer-lot), l'agent de diagnostic et le lecteur de /aiguiser ; amélioré par /aiguiser.
|
||||
---
|
||||
|
||||
# Lire les données
|
||||
|
||||
Une caméra suit des cibles (réflecteurs) fixées sur un ouvrage ; son propre mouvement est compensé grâce à des cibles de référence, supposées fixes. Ce skill dit comment lire les données d'une station : ce que montrent les courbes et les images, moment par moment. Il ne dit pas ce qu'elles veulent dire : catégorie, cas connu, hypothèse et verdict sont l'affaire de celui qui t'appelle.
|
||||
|
||||
## À lire d'abord
|
||||
|
||||
- `docs/domaine/colonnes-des-deplacements.md` : formats des exports et sens des colonnes (**en premier**) ;
|
||||
- `docs/domaine/pieges-des-donnees.md`.
|
||||
|
||||
## Les outils
|
||||
|
||||
Lance-les depuis la racine du dépôt. Ils rendent des valeurs, jamais des verdicts : c'est toi qui juges.
|
||||
|
||||
| Commande | Ce qu'elle rend |
|
||||
|---|---|
|
||||
| `python3 agents/diagnostic/outils/inventaire.py <dossier>` | Fichiers par type, images (heures couvertes), période, cadence, mesures manquantes, capteurs (référence ou cible, seuil d'erreur, mesures rejetées) |
|
||||
| `python3 agents/diagnostic/outils/resume.py <dossier> [--colonne C] [--stat median\|min\|max] [--pas 1h] [--capteurs A,B] [--debut T] [--fin T]` | Niveau habituel de chaque capteur sur toute la période (médiane, MAD, min, max), puis un tableau par pas de temps. Colonnes : `error_value`, `corr_x`, `corr_y`, `relative_x`, `relative_y`, `x`, `y`, `sigma0`, `reproj_err` |
|
||||
| `.venv/bin/python agents/diagnostic/outils/graphique.py <dossier> [--capteurs A,B] [--colonnes C1,C2] [--debut T] [--fin T] [--zone T1/T2 ...] [--sortie D]` | Un PNG des séries ; chaque `--zone` est grisée ; il imprime son chemin. **Regarde-le avec Read** : tu lis mieux un graphique qu'un tableau |
|
||||
| `.venv/bin/python agents/diagnostic/outils/vignettes.py <dossier> --capteurs A,B --heures T1,T2 [--rayon 100] [--sortie D]` | Une planche de vignettes à pleine résolution : une ligne par capteur, une colonne par heure, centrées sur la position brute (`x`, `y`) du capteur ; pixels non retouchés, l'éclat se compare d'une vignette à l'autre. **Regarde-la avec Read** : une image entière lue par Read est réduite, un petit réflecteur y devient illisible |
|
||||
| `ls <dossier>/images/`, puis Read sur `<AAAAMMJJ>T<HHMM>Z_*.jpg` | L'image entière de la caméra à cette heure (UTC), pour la scène (occultation, éclairage, météo) |
|
||||
|
||||
`--sortie <dossier>` : là où celui qui t'appelle range tes figures ; il te le donne.
|
||||
|
||||
## Conventions
|
||||
|
||||
- Instants : `2026-01-01T00:00Z` ; une heure sans fuseau est lue en UTC ; `--fin` inclut la minute indiquée. Sur un lot, `--debut` et `--fin` du lot.
|
||||
- Bash ne sert qu'à lancer ces outils, `ls`, `grep` et `date`, une commande par appel, sans boucle `for` (un tube vers `grep` est permis) : les permissions sont accordées commande par commande. N'écris aucun autre script. Celui qui t'appelle peut ajouter des commandes à cette liste.
|
||||
- Chaque PNG se regarde avec Read : un PNG que tu n'as pas regardé n'a rien montré.
|
||||
|
||||
## La méthode
|
||||
|
||||
1. **Inventaire** : ce qui est disponible, ce qui manque (fichiers, images, période, cadence, capteurs).
|
||||
2. **Large d'abord** : `graphique.py` sur tous les capteurs, `error_value` puis `corr_x`, `corr_y` (ou `relative_x`, `relative_y`), références et cibles ; `resume.py` sur ces colonnes avec un pas large (6h ou 1d).
|
||||
3. **Puis zoome** : `resume.py` à 1h ou 15min, et `graphique.py` sur les fenêtres et les capteurs qui bougent.
|
||||
4. **Chaque capteur face à son propre niveau habituel** (sa médiane et sa MAD), jamais à un seuil absolu.
|
||||
5. **Les images** : vignettes espacées, une toutes les 2 à 3 h, plus serrées là où les courbes bougent, toujours avec un capteur témoin non touché, à une heure avant, pendant et après (à la même heure de la journée si possible) ; l'image entière pour la scène (occultation, éclairage, météo).
|
||||
|
||||
## Ce que la lecture rend
|
||||
|
||||
Une ligne par moment. Un moment : un capteur ou un groupe de capteurs qui sort de son niveau habituel pendant une fenêtre que tu peux dater.
|
||||
|
||||
| Début | Fin | Capteurs | Colonnes | Ce que je vois | Images |
|
||||
|---|---|---|---|---|---|
|
||||
|
||||
- **Capteurs** : références ou cibles, combien, lesquels.
|
||||
- **Ce que je vois** : la forme (pic d'un pas, palier, montée lente, agitation), l'ampleur face au niveau habituel (en MAD ou en fois la médiane), le retour à la normale ou non, ce que font les autres capteurs.
|
||||
- **Images** : ce que montrent les vignettes et l'image entière à ce moment, ou « pas d'image ».
|
||||
|
||||
Heures en UTC.
|
||||
@@ -14,6 +14,7 @@ Tu reçois un dossier de `data/` (ex. `data/PS_DES_COUDRES/`) et, parfois, une q
|
||||
|
||||
Toute la connaissance du projet sur les déplacements, autant qu'il en faut pour ton cas :
|
||||
|
||||
- `.claude/skills/lire-les-donnees/SKILL.md` : tes outils et ta façon de lire les données (§3) ;
|
||||
- les fichiers du dossier fourni, par tes outils (§3), et ses images avec Read ;
|
||||
- `docs/domaine/` : `colonnes-des-deplacements.md`, formats des exports et sens des colonnes (**lis-le en premier**), `pieges-des-donnees.md`, `ce-que-mesure-la-station.md` ;
|
||||
- `docs/displacement/` : `cadrage.md` et les notes de `domaine/`, dont `carte-des-evenements.md` : ce qui peut arriver, en familles, et le sens des catégories des détecteurs (section 4) ;
|
||||
@@ -27,20 +28,15 @@ Pour un long fichier, trouve la section avec `grep -n '^#' <fichier>`, puis lis-
|
||||
|
||||
## 3. Tes outils
|
||||
|
||||
Lance-les depuis la racine du dépôt. Ils rendent des valeurs, jamais des verdicts : c'est toi qui juges.
|
||||
Ceux de `.claude/skills/lire-les-donnees/SKILL.md` (lis-le avant tout) : ce qu'ils rendent, leurs conventions et la façon de lire. En plus :
|
||||
|
||||
| Commande | Ce qu'elle rend |
|
||||
|---|---|
|
||||
| `python3 agents/diagnostic/outils/inventaire.py <dossier>` | Fichiers par type, images (heures couvertes), période, cadence, mesures manquantes, capteurs (référence ou cible, seuil d'erreur, mesures rejetées) |
|
||||
| `python3 agents/diagnostic/outils/resume.py <dossier> [--colonne C] [--stat median\|min\|max] [--pas 1h] [--capteurs A,B] [--debut T] [--fin T]` | Niveau habituel de chaque capteur sur toute la période (médiane, MAD, min, max), puis un tableau par pas de temps. Colonnes : `error_value`, `corr_x`, `corr_y`, `relative_x`, `relative_y`, `x`, `y`, `sigma0`, `reproj_err` |
|
||||
| `.venv/bin/python agents/diagnostic/outils/graphique.py <dossier> [--capteurs A,B] [--colonnes C1,C2] [--debut T] [--fin T] [--zone T1/T2 ...] [--sortie D]` | Un PNG des séries ; chaque `--zone` est grisée ; il imprime son chemin. **Regarde-le avec Read** : tu lis mieux un graphique qu'un tableau |
|
||||
| `.venv/bin/python agents/diagnostic/outils/vignettes.py <dossier> --capteurs A,B --heures T1,T2 [--rayon 100] [--sortie D]` | Une planche de vignettes à pleine résolution : une ligne par capteur, une colonne par heure, centrées sur la position brute (`x`, `y`) du capteur ; pixels non retouchés, l'éclat se compare d'une vignette à l'autre. **Regarde-la avec Read** : une image entière lue par Read est réduite, un petit réflecteur y devient illisible |
|
||||
| `python3 vues-deplacements/journal/categories.py <dossier>` | Les événements des détecteurs du journal du matin, une ligne chacun : début, fin, catégorie (sens : section 4 de la carte des événements), grisé (données à ignorer) ou gardé, nombre de capteurs. Des repères calculés, réglés sur les cas de la base : pars d'eux sans les juger ; ils ne disent ni quels capteurs, ni pourquoi |
|
||||
| `ls <dossier>/images/`, puis Read sur `<AAAAMMJJ>T<HHMM>Z_*.jpg` | L'image entière de la caméra à cette heure (UTC), pour la scène (occultation, éclairage, météo) |
|
||||
|
||||
Sans `--sortie`, les PNG vont dans `out/diagnostic/` : c'est ton brouillon d'exploration. Avec `--sortie <dossier du rapport>` (§6), ils deviennent des preuves du rapport.
|
||||
|
||||
Instants : `2026-01-01T00:00Z` (une heure sans fuseau est lue en UTC ; `--fin` inclut la minute indiquée). Bash ne sert qu'à lancer ces outils, `ls`, `grep`, `pdftotext` et `date`, une commande par appel, sans boucle `for` (un tube vers `grep` est permis) : les permissions sont accordées commande par commande. N'écris aucun autre script.
|
||||
Bash sert aussi à lancer `categories.py` et `pdftotext`, aux mêmes règles que les outils (une commande par appel, sans boucle `for`). N'écris aucun autre script.
|
||||
|
||||
## 4. Déroulé
|
||||
|
||||
@@ -49,8 +45,7 @@ Ton enquête est complète ; ton rapport ne garde que ce qui sert la conclusion.
|
||||
1. **Inventaire** (`inventaire.py`) : ce qui est disponible, ce qui manque, et ce que ce manque empêche de conclure (par exemple, sans métriques système, un arrêt de la station ne peut pas être écarté).
|
||||
2. **Repérage** : commence large, puis zoome.
|
||||
- les détecteurs (`categories.py`) d'abord : leurs événements sont un premier repérage, que tu précises avec tes outils ;
|
||||
- `graphique.py` sur tous les capteurs, puis `resume.py` sur `error_value`, `corr_x`, `corr_y` avec un pas large (6h ou 1d), puis 1h ou 15min sur les fenêtres intéressantes ;
|
||||
- compare chaque capteur **à son propre niveau habituel** (sa médiane et sa MAD), jamais à un seuil absolu ;
|
||||
- puis lis la période comme le dit `lire-les-donnees` : large, puis zoom, chaque capteur face **à son propre niveau habituel** ;
|
||||
- un seuil de repérage (ex. « au-dessus de médiane + 6 MAD ») est un choix d'exploration : annonce-le, et ne t'en sers jamais comme critère de conclusion.
|
||||
3. **Tri : anomalie ou non.**
|
||||
- Une **anomalie** : un capteur ou un groupe de capteurs sort de son propre comportement habituel pendant une fenêtre que tu peux dater.
|
||||
|
||||
Reference in new issue
Block a user