- 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>
5.7 KiB
name, description, argument-hint
| name | description | argument-hint |
|---|---|---|
| review-auto-labels | 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>. | <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 :
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.mdoulabeling/familles.md; - commit sur sa validation : les étiquettes,
revue.mdetetiquettes-proposees.jsonl(les figures restent hors de git).