Files
Support-Agent/.claude/skills/cross-review-labels/SKILL.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

4.8 KiB

name, description, argument-hint
name description argument-hint
cross-review-labels Revue croisée des étiquettes automatiques (labeling/auto/*.jsonl) sur toutes les stations à la fois — un analyste par famille compare les stations entre elles, pour qu'un même phénomène porte la même étiquette partout, tranche les règles où les revues par station ont divergé et trouve les étiquettes rangées dans une autre famille ; l'orchestrateur applique, règle les conflits, puis une passe de finition reprend ce qui reste. Lancé par l'utilisateur, /cross-review-labels [FAMILLE], après les revues par station (/review-auto-labels). [FAMILLE]

Revue croisée des étiquettes automatiques

Les revues par station (/review-auto-labels, D-128) relisent la même tranche que l'étiqueteur et retrouvent, station après station, les mêmes défauts. La revue croisée change de granularité : une famille, toutes les stations (D-130). Chaque analyste part des étiquettes et des revues et les améliore ; il ne refait pas l'étiquetage. Tu es l'orchestrateur : tu prépares la table, lances les analystes, appliques, règles les conflits. Tu ne juges pas les étiquettes toi-même.

Dossier : labeling/auto/revue-croisee/<AAAA-MM-JJ>/. Ses outils : outils/table.py (la table), outils/appliquer.py (l'application) ; copie-les de la dernière revue croisée dans le nouveau dossier, ne les lance jamais dans l'ancien. Une revue ne s'applique qu'une fois : appliquer.py écrit applique.md et refuse de rejouer.

1. La table

python3 labeling/auto/revue-croisee/<date>/outils/table.py

Elle écrit index.tsv (toutes les étiquettes, description coupée) et par-famille/<famille>.md (en entier), avec pour chacune son id stable <STATION>-<n> (labeling/ids.py, D-131), sa durée et les stations étiquetées au même moment. Copie labeling/auto/*.jsonl dans ton dossier temporaire : c'est l'état d'avant, pour revenir. Une étiquette qu'une autre session modifie pendant la revue garde son id : l'application la retrouve ; mais n'écris rien d'autre dans labeling/auto/ jusque-là, pour que les analystes jugent ce qui sera modifié.

2. Les analystes

Un agent analyste par famille (les six, ou celle de l'argument), en parallèle, prompt :

Revue croisée des étiquettes automatiques, pas un lot de la boucle. Tes consignes : .claude/skills/cross-review-labels/analyste.md. Famille : <famille> (<n> étiquettes, toutes les stations). Dossier de la revue croisée : <dossier> (par-famille/<Famille>.md, index.tsv). Dossier de sortie : <dossier>/<famille>/.

Ajoute au prompt les questions où les revues par station ont divergé pour cette famille (lis leurs « Défauts qui reviennent » et « Questions à l'expert ») : ce sont elles qui font la valeur de la revue croisée. Deux familles partagent une frontière (thermique et visibilité, par exemple) : dis à chacun que l'autre la traite aussi.

3. Appliquer

Quand tous ont rendu :

  1. Vérifie que labeling/auto/ n'a pas changé depuis la table (comparaison à la copie) ; si une autre session y a écrit, ne l'écrase pas : refais la table et relance les analystes touchés.
  2. Cherche les conflits (une étiquette touchée par deux analystes) et les ajouts qui doublent une étiquette ; appliquer.py n'applique pas une étiquette en conflit, tranche-la (id=<famille>).
  3. python3 <dossier>/outils/appliquer.py : les étiquettes modifiées ou ajoutées portent revue à la date du jour. Puis python3 labeling/controle.py : 0 erreur ; s'il en reste, renvoie l'étiquette à son analyste.

4. La finition

Les rendus disent ce qu'un analyste a laissé de côté (« laissé tel quel », « pour un autre relecteur ») : note chaque point dans <dossier>/reste-a-faire.md au fil des rendus. Puis une passe de finition, un analyste par station touchée, avec une table refaite (<dossier>/finition/, même méthode, ids du fichier du moment) et les règles tranchées des revues croisées.

5. Après

  • Les descriptions restent sans valeurs chiffrées (labeling/regles-d-etiquetage.md, section 5) : les mesures vont dans les revue.md, pas dans les étiquettes. labeling/controle.py les compte après chaque application ; s'il en reste, une réécriture en mots, station par station, où seule la description change (vérifiée par script).
  • Les règles tranchées entrent dans labeling/regles-d-etiquetage.md, les frontières dans labeling/familles.md, les nouveaux cas dans la carte (/labels-map).
  • Le releveur en fin de processus (règle des processus automatiques, D-060) : il note dans docs/ameliorations-processus.md les sections « Difficultés » des revues et les tiennes.
  • Commit sur l'accord de l'utilisateur : les étiquettes, les revue.md, modifications.jsonl, reste-a-faire.md (les figures restent hors de git).