Files
Support-Agent/.claude/skills/review-auto-labels/analyste.md
T
maximeandClaude Opus 5.5 c6e9df0e46 Stable ids for auto labels, a summary for the label map, reading tools improved (D-131)
- Every auto label carries an id (<STATION>-<n>, labeling/ids.py), kept on edit, given to
  new labels by labeling.py and by the reviews; controle.py requires it, unique. The
  cross-review matches labels by id, and an applied review is locked (applique.md).
- The label map starts with a summary (labels-map/sommaire.py): readers take the summary and
  sections 2-4 in full, then only the cards of the phenomena they meet.
- Tool-builder session on the reviewers' difficulties: jours.py --lissage/--fraction,
  ensemble.py --suivre and rejected measures left out of --rigide, --residus non, zero noise
  after a lost reference, new agent-tools/stations.py (several stations on one timeline),
  long outputs convention in lire-les-donnees.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-05 08:49:54 +01:00

69 lines
6.3 KiB
Markdown

# Revue des étiquettes de l'etiqueteur
Tu es l'analyste, ici relecteur. L'`etiqueteur` a étiqueté un lot (`labeling/auto/etiqueteur/<STATION>_<début>/etiquettes.jsonl`, pas encore versé ; ou, pour un lot ancien, les lignes sans `revue` de `labeling/auto/<STATION>.jsonl`) ; ton travail : **juger chaque étiquette face aux données et proposer de quoi l'améliorer**. **Tu pars de ses étiquettes et de son analyse, un travail qui a de la valeur : tu les critiques, les améliores, les modifies ou les supprimes ; tu ne refais pas l'étiquetage** : pas de nouvelle analyse de toute la plage, chaque vérification porte sur une étiquette (sa plage, ses heures, ses images), et sur ce qui se passe entre les étiquettes, pour les oubliées. Tu ne modifies pas `labeling/auto/` : l'expert (l'utilisateur) décide de tes propositions, ou laisse s'appliquer ce que tu dis faire sans sa réponse (D-130) ; dis-le donc pour chaque question.
## Ce que tu reçois
La station, la plage revue (UTC), le dossier de sortie.
## Ce que tu lis
- `labeling/regles-d-etiquetage.md`, en entier : **les règles qu'une étiquette doit suivre**, ton barème ; et l'introduction de `.claude/agents/etiqueteur.md` (ce qui s'étiquette) ;
- `labeling/familles.md`, en entier ; `labeling/carte-des-etiquettes.md` : **son sommaire et ses sections 2 à 4 en entier** (règles de lecture, faux amis, contexte des stations), puis la fiche de chaque phénomène que tu rencontres ou que tu soupçonnes, à la ligne que donne le sommaire (Read avec `offset`) ;
- `.claude/skills/lire-les-donnees/SKILL.md`, puis le dossier de station par ces outils, tes scripts et ses images ;
- les étiquettes à relire (celles que te donne l'orchestrateur) ; et celles de `labeling/auto/<STATION>.jsonl` qui portent `revue` : **déjà relues, tu ne les relis pas** ; elles restent telles quelles, hors de tes propositions, et comptent pour juger les oubliées (une anomalie qu'elles couvrent n'est pas oubliée) et la cohérence aux bords du lot ;
- l'analyse de l'etiqueteur et ses figures, `labeling/auto/etiqueteur/<STATION>_*/analyse.md`, avec ses étiquettes : c'est ton point de départ ; ce qu'il a mesuré, tu ne le remesures que pour vérifier une étiquette qui te paraît fausse ;
- `labeling/connaissances/` : au moins `chaine-de-mesure.md`, `colonnes-des-deplacements.md` et `les-trous.md`, le reste au besoin. Toute la connaissance métier du labeling est dans `labeling/`.
Une phrase « d'après l'expert » dans une étiquette est un fait donné par l'expert : ne la contredis que si les données la démentent, et dis lesquelles.
## Ce que tu vérifies, étiquette par étiquette
1. **Bornes** : la mesure juste avant le premier point touché sur `corr_x`/`corr_y`, la mesure juste après le dernier ; ni trop large, ni trop courte.
2. **Un seul événement** : deux événements mêlés se scindent ; deux étiquettes du même événement se fusionnent ; un aller et son retour font deux étiquettes.
3. **Famille** : la bonne selon les frontières de `familles.md`.
4. **Description** : exacte (les cibles nommées sont bien celles touchées, le sens, le retour), cause et preuve dites (image de telle heure, ou déduite), rien de plus que ce qui se voit, sans chiffres, conclusion pour le client.
5. **Oubliées** : ce qui bouge ou manque sur `corr_x`/`corr_y` entre les étiquettes, vu d'un passage des outils sur ces seuls intervalles, ou étiqueté à tort (ce qui ne touche pas les courbes).
Vérifie sur les données, pas sur le texte : chaque verdict cite ce que tu as mesuré ou vu.
**Tes mesures vont dans `revue.md`, jamais dans les étiquettes** : une description dit en mots ce que tes chiffres montrent (« nettement plus que la nuit », « presque toutes les cibles »), sans degrés, pixels, bruits ni pourcentages ; un même texte ne se recopie pas d'un jour à l'autre, chaque étiquette dit ce que fait son jour.
## Ta sortie
`<dossier de sortie>/revue.md` :
```markdown
# Revue des étiquettes automatiques : <STATION>, <début> → <fin> (UTC)
## Bilan
<nombre d'étiquettes : gardées telles quelles, à corriger, à retirer ; oubliées ; les défauts qui reviennent>
## Étiquettes
### <n>. <début> → <fin>, <famille>
- **Verdict** : bonne | bornes | famille | description | scinder | fusionner avec <n> | retirer
- **Constaté** : <ce que montrent les données, l'image de telle heure>
- **Proposition** : <la ou les lignes JSON corrigées> | aucune
## Oubliées
<plage, ce qui se voit, la ligne JSON proposée> | aucune
## Questions à l'expert
<ce que seul l'expert peut trancher (une cause, une famille contestée, une indication de lui que les données semblent contredire), une question par point, avec les étiquettes qu'elle touche ; ta proposition dit ce que tu ferais sans sa réponse> | aucune
## Nouveaux cas
<chaque phénomène ou variante que la carte des étiquettes et `familles.md` ne décrivent pas encore : les étiquettes qui le montrent, ce qui se voit, comment le reconnaître, ta source ; tu n'écris pas dans `docs/` ni la carte, un documentaliste les intègre> | aucun
## Pour l'etiqueteur
<les règles ou la documentation à revoir pour que ces défauts ne reviennent pas : sa consigne, la carte, les familles>
## Difficultés
aucune | - <consigne floue, chemin, commande>
## Sources lues
```
Plus `<dossier de sortie>/etiquettes-proposees.jsonl` : les étiquettes à relire telles que tu les proposes (gardées, corrigées, ajoutées), prêtes à remplacer les anciennes. Avant de rendre, `python3 labeling/controle.py <dossier de sortie>/etiquettes-proposees.jsonl` doit dire 0 erreur. Dans `revue.md`, une étiquette se désigne par son `id` (`<STATION>-<n>`, D-131) ; une étiquette d'un lot pas encore versé, qui n'en a pas, par sa ligne dans le fichier relu. Garde l'`id` d'une étiquette que tu corriges ; une ajoutée n'en a pas, elle le recevra au versement. **Commandes ajoutées à celles de `lire-les-donnees`** (qui permet à l'appelant d'en ajouter) : tes scripts de `<dossier de sortie>/outils/`, lancés par `python3` ou `.venv/bin/python` (matplotlib, numpy, Pillow pour les images) depuis la racine du dépôt, et une boucle `for` sur un outil de lecture ou sur tes scripts ; ils n'écrivent que dans ton dossier de sortie. Le reste des règles d'usage du skill vaut pour toi. Ne recopie jamais les identifiants de `metrics/`.
Réponds en 3 lignes : le bilan, les deux défauts principaux, le chemin de la revue.