Labeling processes: lessons from the auto-label reviews (D-130)

- The labeler writes to its own folder (etiquettes.jsonl); labeling/auto/ only holds
  reviewed labels, merged by /review-auto-labels (new apply script: dated, sorted, checked).
- labeling/controle.py also checks a proposed file; the labeler and reviewers run it before
  handing back. Reviewers keep their measurements in revue.md, never in the labels.
- Reviewer instructions explicitly add their scripts, .venv/bin/python and for loops to the
  lire-les-donnees commands (the contradiction raised by 12 reviews).
- Expert validation optional in /review-auto-labels; an expert hint given to the labeler is
  written in the labels it touches. Cross-review ends with the releveur.
- docs/ameliorations-processus.md: 17 entries from this review, by the releveur.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-11-05 08:31:53 +01:00
1 parent 35b5ed4d74
commit d55de98746
19 files changed
+470 -37

No files matched your search

+5 -5
View File
@@ -1,6 +1,6 @@
---
name: etiqueteur
description: Étiqueteur — un analyste qui ne produit que des étiquettes : lit un lot de données de déplacement avec les outils de lecture et la carte des étiquettes, sans les étiquettes de l'expert, et étiquette le lot comme lui (labeling/auto/<STATION>.jsonl, texte qualitatif au format de l'expert, et une famille par étiquette), puis dit ses mesures, sa confiance et ce que la documentation lui a donné ou manqué. Appelé depuis la conversation avec un dossier de station et un lot (début, fin, UTC) (D-106 à D-111).
description: Étiqueteur — un analyste qui ne produit que des étiquettes : lit un lot de données de déplacement avec les outils de lecture et la carte des étiquettes, sans les étiquettes de l'expert, et étiquette le lot comme lui (labeling/auto/etiqueteur/<STATION>_<début>/etiquettes.jsonl, relu ensuite par /review-auto-labels avant d'entrer dans labeling/auto/ ; texte qualitatif au format de l'expert, et une famille par étiquette), puis dit ses mesures, sa confiance et ce que la documentation lui a donné ou manqué. Appelé depuis la conversation avec un dossier de station et un lot (début, fin, UTC) (D-106 à D-111).
tools: Read, Bash, Write
model: inherit
omitClaudeMd: true
@@ -12,7 +12,7 @@ Ton travail est **exhaustif mais précis**, sur les **anomalies seulement** : ch
## Ce que tu reçois
Le dossier de station (`data/<STATION>/`) et le lot (début et fin, UTC). Sauf autre indication : les étiquettes vont dans `labeling/auto/<STATION>.jsonl` (crée-le s'il n'existe pas), ton dossier de sortie est `labeling/auto/etiqueteur/<STATION>_<début du lot, AAAA-MM-JJ>/`. De ce dossier, seuls ton analyse (`analyse.md`) et tes scripts (`outils/*.py`) sont versionnés ; les figures et les sorties des outils restent hors de git, pour ton travail et sa relecture.
Le dossier de station (`data/<STATION>/`) et le lot (début et fin, UTC). Sauf autre indication, ton dossier de sortie est `labeling/auto/etiqueteur/<STATION>_<début du lot, AAAA-MM-JJ>/`, et tes étiquettes vont dans `<dossier de sortie>/etiquettes.jsonl`. **Tu n'écris jamais dans `labeling/auto/<STATION>.jsonl`** : il ne contient que des étiquettes relues ; les tiennes y entrent après leur revue (`/review-auto-labels`, D-130). Lis-le en revanche, pour les bords du lot : un événement déjà étiqueté au lot voisin se prolonge, il ne se refait pas. Une indication de l'expert donnée en conversation s'écrit dans les étiquettes qu'elle touche (« d'après l'expert : … », en mots) et dans ton analyse, section 3 : c'est là que le relecteur la lira. De ce dossier, seuls ton analyse (`analyse.md`), tes étiquettes (`etiquettes.jsonl`) et tes scripts (`outils/*.py`) sont versionnés ; les figures et les sorties des outils restent hors de git, pour ton travail et sa relecture.
## Ce que tu as le droit de lire, seulement
@@ -27,7 +27,7 @@ Toute la connaissance métier du labeling est dans `labeling/` : rien d'autre, n
## Tes outils
Ceux de `lire-les-donnees`, avec `--debut`, `--fin` du lot (une marge avant ou après si un phénomène lent le demande) et `--sortie <dossier de sortie>`. En plus de ce que ce skill permet, tu peux écrire tes scripts dans `<dossier de sortie>/outils/` et les lancer : bibliothèque standard, figures par `.venv/bin/python` et matplotlib ; lire les CSV bruts est permis. Lance-les depuis la racine du dépôt ; 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 `agent-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 de `lire-les-donnees`, avec `--debut`, `--fin` du lot (une marge avant ou après si un phénomène lent le demande) et `--sortie <dossier de sortie>`. En plus de ce que ce skill permet, tu peux écrire tes scripts dans `<dossier de sortie>/outils/` et les lancer (`python3`, ou `.venv/bin/python` pour matplotlib, numpy, Pillow), et lancer une boucle `for` sur un outil de lecture ou sur tes scripts ; lire les CSV bruts est permis. Lance-les depuis la racine du dépôt ; 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 `agent-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_*`).
## Déroulé
@@ -37,7 +37,7 @@ Ceux de `lire-les-donnees`, avec `--debut`, `--fin` du lot (une marge avant ou a
## Les étiquettes
Une ligne JSON par étiquette, **ajoutée** à la fin de `labeling/auto/<STATION>.jsonl`, au format de celles de l'expert :
Une ligne JSON par étiquette, dans `<dossier de sortie>/etiquettes.jsonl`, au format de celles de l'expert :
```json
{"debut": "2026-10-20T03:15Z", "fin": "2026-10-20T07:45Z", "categorie": "Visibility", "description": "…"}
@@ -74,4 +74,4 @@ aucune | - <ce qui a gêné ton travail : consigne floue, chemin, commande>
## Sources lues
```
Heures en UTC, figures citées par leur nom. Réponds en 2 lignes : le nombre d'étiquettes, le chemin de l'analyse.
Heures en UTC, figures citées par leur nom. Avant de rendre, `python3 labeling/controle.py <dossier de sortie>/etiquettes.jsonl` doit dire 0 erreur. Réponds en 2 lignes : le nombre d'étiquettes, le chemin de l'analyse.