- 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>
56 lines
5.7 KiB
Markdown
56 lines
5.7 KiB
Markdown
---
|
|
name: review-auto-labels
|
|
description: Revue des étiquettes de l'etiqueteur sur une plage choisie par l'utilisateur (un lot pas encore versé, labeling/auto/etiqueteur/<STATION>_<début>/etiquettes.jsonl, ou les étiquettes non relues de labeling/auto/<STATION>.jsonl) — l'analyste juge chaque étiquette face aux données (bornes, un seul événement, famille, description, oubliées) et propose des étiquettes corrigées ; l'expert répond à ses questions, ou laisse s'appliquer les choix de l'analyste ; les étiquettes relues entrent dans labeling/auto/. Lancé par l'utilisateur, /review-auto-labels <STATION> <début> <fin>.
|
|
argument-hint: "<STATION> <début> <fin>"
|
|
---
|
|
|
|
# Revue des étiquettes automatiques
|
|
|
|
L'`etiqueteur` étiquette seul, dans son dossier (`labeling/auto/etiqueteur/`, D-105, D-106, D-130) ; ses étiquettes sont la vérité des détecteurs (D-118). Ici, l'agent `analyste` les relit sur une plage pour en améliorer la qualité ; l'expert, c'est l'utilisateur, décide. Tu es l'orchestrateur : tu lances l'analyste, relaies ses questions, appliques ce que l'expert valide. **Tu ne juges pas la revue toi-même.**
|
|
|
|
## 1. La plage
|
|
|
|
Arguments : la station et la plage (`début`, `fin`, UTC, au jour ou à l'heure), choisie par l'utilisateur ; s'il en manque, demande-les. Les étiquettes à relire : celles d'un lot de l'etiqueteur pas encore versé (`labeling/auto/etiqueteur/<STATION>_<début>/etiquettes.jsonl`, D-130 : l'etiqueteur n'écrit plus dans `labeling/auto/`), ou, pour un lot ancien, celles de `labeling/auto/<STATION>.jsonl` dont le `debut` tombe dans la plage et qui ne portent pas `revue`. Celles qui le portent sont déjà relues : elles ne se relisent pas et restent telles quelles. Aucune à relire : dis-le et arrête. Dossier de sortie : `labeling/auto/revue/<STATION>_<début, AAAA-MM-JJ>/`.
|
|
|
|
## 2. L'analyste relit
|
|
|
|
L'outil Agent, `subagent_type: analyste`, prompt :
|
|
|
|
`Revue des étiquettes de l'etiqueteur, pas un lot de la boucle. Tes consignes : .claude/skills/review-auto-labels/analyste.md. Station : data/<STATION>/. Plage revue : <début> → <fin> ; <n> étiquettes à relire dans <le fichier du lot, ou labeling/auto/<STATION>.jsonl (celles sans `revue`)>, analyses de l'etiqueteur dans labeling/auto/etiqueteur/<STATION>_*/. Dossier de sortie : <dossier>.`
|
|
|
|
Attends sa notification.
|
|
|
|
**Plusieurs stations voisines** (même bâtiment, même site, d'après l'expert), déjà relues une à une : un seul analyste vérifie leur cohérence, consignes `.claude/skills/review-auto-labels/coherence.md`, dossier `labeling/auto/revue/coherence_<STATIONS>_<début>/`, une proposition par station touchée (`etiquettes-proposees-<STATION>.jsonl`, toutes les étiquettes de la plage). Ses étiquettes portent déjà `revue` : sur l'accord de l'expert, elles remplacent toutes celles de la plage.
|
|
|
|
## 3. L'expert tranche
|
|
|
|
Si l'utilisateur a dit d'appliquer sans sa validation (D-130), saute les questions : les choix que l'analyste dit faire sans réponse s'appliquent ; donne-lui seulement le bilan et les choix qui le touchent (une indication de lui que les données contredisent). Sinon, donne à l'utilisateur le bilan de la revue et ses deux défauts principaux, puis les questions de la section « Questions à l'expert », numérotées, chacune avec les étiquettes qu'elle touche, et le lien vers `revue.md`. Il répond dans la conversation ; il peut aussi refuser une correction.
|
|
|
|
Puis mets `etiquettes-proposees.jsonl` en accord avec ses réponses : la famille qu'il a tranchée, sa réponse dite dans la description (« d'après l'expert : … »), une correction refusée remise comme avant. Chaque étiquette appliquée porte `"revue": "<AAAA-MM-JJ>"`, la date du jour (le script de l'étape 4 l'ajoute), comme les étiquettes manuelles revues (D-103) : c'est par ce champ que `/labels-map` les fait entrer dans la carte.
|
|
|
|
## 4. Appliquer
|
|
|
|
Contrôle d'abord les proposées : `python3 labeling/controle.py <dossier>/etiquettes-proposees.jsonl`, 0 erreur attendue ; sinon renvoie-les à l'analyste. Puis, sur l'accord de l'utilisateur (ou d'office s'il a dit d'appliquer sans validation), remplace les étiquettes non revues de la plage par les proposées, datées et triées, en gardant les autres (hors plage, ou déjà revues) ; un lot pas encore versé n'a rien à remplacer, ses étiquettes s'ajoutent :
|
|
|
|
```bash
|
|
python3 - <STATION> <début> <fin> <dossier> <AAAA-MM-JJ> <<'EOF'
|
|
import json, sys
|
|
st, du, au, d, date = sys.argv[1:]
|
|
p = f'labeling/auto/{st}.jsonl'
|
|
def relue(e): return du <= e['debut'] < au and 'revue' not in e
|
|
anciennes = [json.loads(l) for l in open(p) if l.strip()] if __import__('os').path.exists(p) else []
|
|
garde = [e for e in anciennes if not relue(e)]
|
|
neuves = [dict(json.loads(l), revue=date) for l in open(f'{d}/etiquettes-proposees.jsonl') if l.strip()]
|
|
toutes = sorted(garde + neuves, key=lambda e: (e['debut'], e['fin']))
|
|
open(p, 'w').writelines(json.dumps(e, ensure_ascii=False) + '\n' for e in toutes)
|
|
print(len(anciennes) - len(garde), 'remplacées,', len(garde), 'gardées,', len(neuves), 'appliquées')
|
|
EOF
|
|
```
|
|
|
|
Puis `python3 labeling/ids.py <STATION>` (un id stable aux étiquettes versées, D-131) et `python3 labeling/controle.py <STATION>` : 0 erreur.
|
|
|
|
`<début>` et `<fin>` au format des étiquettes (`AAAA-MM-JJTHH:MMZ`). Puis :
|
|
- les réponses de l'expert qui valent au-delà de ces étiquettes (une règle de lecture, un contexte de station) : dis-lui qu'elles entreront dans la carte au prochain `/labels-map` ;
|
|
- la section « Pour l'etiqueteur » de la revue : propose-la à l'utilisateur, sans l'appliquer ; une leçon retenue va dans `labeling/regles-d-etiquetage.md` ou `labeling/familles.md` ;
|
|
- commit sur sa validation : les étiquettes, `revue.md` et `etiquettes-proposees.jsonl` (les figures restent hors de git).
|