Files
Support-Agent/.claude/skills/detector-learner/SKILL.md
T
maximeandClaude Opus 5.5 d55de98746 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>
2026-11-05 08:31:53 +01:00

11 KiB

name, description, disable-model-invocation, argument-hint
name description disable-model-invocation argument-hint
detector-learner Séance automatique d'amélioration des détecteurs du journal du matin sur les étiquettes de l'etiqueteur déjà produites (labeling/auto/), la seule vérité (D-116, D-118) — detectors-critic, detectors-upgrader, detectors-control ; le but, des détecteurs alignés sur toutes les étiquettes de labeling/auto/ ; le garde-fou, le benchmark sur les autres stations étiquetées. Lancé par l'utilisateur seulement, avec /detector-learner. true data/<STATION> [--ameliorer]

detector-learner : les détecteurs face aux étiquettes

Tu es l'orchestrateur. La vérité de la séance, ce sont les étiquettes de labeling/auto/, écrites en amont par l'etiqueteur et relues (D-106, D-130) : le diagnostic est déjà fait, il n'y a ni analyste ni autre vérité ici (D-116, D-118). Le but est d'aligner les détecteurs le mieux possible sur l'ensemble des étiquettes de labeling/auto/ ; la station de la séance montre où regarder. Tu appelles les trois agents des détecteurs dans l'ordre, tu transmets leurs rendus et tu commites ; en fin de séance, le releveur note leurs difficultés. Tu ne juges rien toi-même : tu lis seulement les lignes de verdict. Tu ne poses aucune question à l'utilisateur : la séance tourne seule jusqu'au bout.

1. Mise en place

  • Arguments : le dossier de station ; un nom seul (« Nordend ») désigne data/<NOM EN MAJUSCULES>/. --ameliorer (facultatif) : en fin de séance, l'améliorateur corrige le processus d'après les relevés du releveur (§4, D-071). Un argument pas net ([--ameliorer] entre crochets vaut l'option) : lis-le au mieux et note sous « Erreurs » du bilan comment.
  • STATION = le nom du dossier ; labeling/auto/<STATION>.jsonl sans étiquette, ou absent : dis-le et arrête-toi, sans commit. La plage de la séance : toutes les étiquettes de la station, du jour de la première à minuit après la dernière (python3 -c "import sys; sys.path.insert(0, '.claude/skills/detector-learner'); import regression; print(regression.plage('labeling/auto/<STATION>.jsonl'))"), ci-dessous <début> et <fin>, celle du bloc de la station dans le benchmark.
  • SEANCE = date -u +%Y-%m-%dT%H%MZ ; dossier de séance detector-learner/<SEANCE>_<STATION>/, ci-dessous <séance>.
  • Commits directement sur master (D-070) : git branch --show-current doit dire master, sinon dis-le et arrête-toi. Note la base de la séance : git rev-parse HEAD. Tu commites toujours par chemin (git add <chemins> && git commit -m "<message>" -- <chemins>), jamais git add -A, git stash ni git checkout hors de tes chemins : une autre session peut travailler dans ce dépôt. Avant chaque commit, git branch --show-current ; si ce n'est plus master, ne commite plus rien et passe au bilan. Chaque message finit par une ligne vide puis Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>.
  • git status --porcelain -- detectors/ vues-deplacements/contexte/seuils-du-journal.md labeling/auto/ labeling/familles.md (familles.md : les familles, une par détecteur, que compte le benchmark) : les fichiers déjà modifiés y restent tels quels, ni commités ni annulés ; liste-les sous « Erreurs » du bilan (les mesures tournent sur eux).

Commande du journal, donnée telle quelle aux agents : python3 detectors/categories.py <dossier> --du <début> --au <fin>. Commande des capteurs, pour le critique : python3 .claude/skills/detector-learner/capteurs.py <dossier> --du <début> --au <fin> (la cadence des mesures, puis les capteurs de chaque événement, dont la commande du journal ne donne que le nombre).

Le benchmark, la seule mesure de la séance : python3 .claude/skills/detector-learner/regression.py --seance <SEANCE>_<STATION> --etape <étape> > <séance>/benchmark-<étape>.txt 2>&1. Le score par famille et par instant sur chaque station de labeling/auto/, puis leur Total, versé dans detector-learner/historique.csv, qui dit si les détecteurs font mieux d'une séance à l'autre. Le bloc <STATION> est le score de la séance, et ses instants signalés à tort, une non-régression ; les autres blocs, la non-régression (D-123).

2. Dans l'ordre

Chaque agent est appelé par l'outil Agent avec son subagent_type et la demande ci-dessous, rien d'autre, sauf une consigne de l'utilisateur arrivée en cours de séance : ajoute-la telle quelle à la demande des agents suivants (Consigne de l'utilisateur : …) et note-la au bilan ; elle passe avant leurs consignes, pas avant leur périmètre de fichiers, et ce qu'ils ne peuvent pas en faire va dans leur « Pas corrigé ». Un verdict se lit par grep '^\*\*Verdict\*\* :' <rendu>.

  1. Benchmark avant : étape avant, donc <séance>/benchmark-avant.txt. Commit <séance>/ detector-learner/historique.csv, message Detector-learner <STATION>: benchmark.
  2. Detectors-critic (detectors-critic) : Dossier : <dossier>. Station : <STATION>, plage <début> → <fin> (UTC). Commande du journal : <commande>. Commande des capteurs : <commande des capteurs>. Étiquettes : labeling/auto/<STATION>.jsonl. Score : le bloc <STATION> de <séance>/benchmark-avant.txt. Écris <séance>/critique.md. Commit <séance>/, message Detector-learner <STATION>: critique (<verdict>). Verdict d'accord : va au bilan.
  3. Detectors-upgrader (detectors-upgrader), passage K = 1, 2 ou 3 : Dossier : <dossier>. Station : <STATION>, plage <début> → <fin> (UTC). Commande du journal : <commande>. Critique : <séance>/critique.md. Benchmark avant : <séance>/benchmark-avant.txt, à relancer par python3 .claude/skills/detector-learner/regression.py (sans --etape). [Contrôle précédent : <séance>/validation-(K-1).md.] Dossier de séance : <séance>. Fichiers déjà modifiés au début de la séance : <liste | aucun>. Passage K. Écris <séance>/modification-K.md. L'upgrader commite lui-même chaque suggestion gardée, avec son benchmark <séance>/benchmark-K-S<n>.txt, message Detector-learner <STATION>: modification K, S<n> : le contrôle peut ainsi en faire retirer une seule. Puis le benchmark, étape modification K, dans <séance>/benchmark-K.txt. Commit detectors/ vues-deplacements/contexte/seuils-du-journal.md <séance>/ detector-learner/historique.csv (sans les fichiers déjà modifiés notés au §1), message Detector-learner <STATION>: modification K.
  4. Detectors-control (detectors-control), qui ne regarde de la station de la séance que ses instants signalés à tort : Station de la séance : <STATION>. Modification : <séance>/modification-K.md. Benchmark : <séance>/benchmark-avant.txt → <séance>/benchmark-K.txt, à relancer par python3 .claude/skills/detector-learner/regression.py (sans --etape) ; après chaque suggestion : <séance>/benchmark-K-S*.txt. Base : <base de la séance>. Passage K sur 3. Écris <séance>/validation-K.md. Commit <séance>/, message Detector-learner <STATION>: control K (<verdict>).
    • accepté ou garder : va au bilan.
    • retirer : pour chaque suggestion de la ligne **Retirer** :, ses commits de la séance (git log --format=%h --grep ', S<n>$' <base de la séance>..HEAD), du plus récent au plus ancien : git revert --no-edit <commit>, puis amende son message pour qu'il finisse par la ligne Co-Authored-By (git commit --amend -m "Detector-learner <STATION>: S<n> retirée" -m "Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>"). Un conflit : git revert --abort, et fais comme pour annuler. Puis va au bilan.
    • à reprendre : retour à l'étape 3, passage K + 1.
    • annuler : git checkout <base de la séance> -- detectors/ vues-deplacements/contexte/seuils-du-journal.md (sans les fichiers déjà modifiés notés au §1), commit de ces chemins, message Detector-learner <STATION>: modification annulée.

Un rendu absent ou sans verdict lisible : note-le, remets les détecteurs comme pour annuler s'ils ont changé, passe au bilan. Ne relance pas un agent plus d'une fois.

3. Bilan

Le benchmark, étape fin, dans <séance>/benchmark-fin.txt : les détecteurs gardés.

<séance>/bilan.md : la plage, la base de la séance (git log --oneline <base>..HEAD), le nombre d'étiquettes ; avant → fin, famille par famille, le bloc <STATION>, puis les lignes changées des autres stations, puis le Total ; critique (d'accord / suggestions n), modification (aucune / gardée en K passages / gardée sans S… / annulée / erreur) ; ## À trancher par l'utilisateur (copiés tels quels : « Limites » de la critique, « À trancher par l'utilisateur » des modifications ; aucune s'il n'y a rien) ; ## Suggestions non traitées (« Pas corrigé » des modifications) ; ## Erreurs (aucune, ou ce qui manquait).

Commit <séance>/ detector-learner/historique.csv, message Detector-learner <STATION>: bilan.

4. Difficultés

Releveur (releveur), une fois, même si tout s'est bien passé : Processus : /detector-learner (.claude/skills/detector-learner/SKILL.md). Séance : <séance>/ : la section « Difficultés » de chaque rendu, et « Erreurs » du bilan. Difficultés de l'orchestrateur : aucune | <…>. (D-060) Si git status --short docs/ameliorations-processus.md montre un changement : commit de ce chemin, message Detector-learner <STATION>: process difficulties.

Améliorateur (ameliorateur), seulement avec --ameliorer et si le releveur a commité : Processus : /detector-learner. Commit du releveur : <commit>., le commit pris par git rev-parse HEAD juste après celui du releveur (D-071). Puis commit des chemins qu'il a pu toucher, .claude/skills/detector-learner/ .claude/agents/detectors-critic.md .claude/agents/detectors-upgrader.md .claude/agents/detectors-control.md .claude/agents/releveur.md .claude/agents/ameliorateur.md run.md docs/ameliorations-processus.md, seulement ceux que git status --short montre changés et qui n'étaient pas déjà modifiés au début de la séance, message Detector-learner <STATION>: process fixes. Garde la suite de ce skill telle que tu l'as lue au début.

5. Réponse finale

python3 .claude/skills/detector-learner/comparaison.py <dossier> <séance> --du <début> --au <fin> : la page de fin de séance, out/detector-learner_<SEANCE>_<STATION>.html, les étiquettes face aux détecteurs famille par famille. Un échec du script va dans la réponse, sans relance.

En 6 lignes au plus : la page, la base de la séance, le bilan, la station avant → fin et le Total, la modification gardée ou non, les erreurs et difficultés relevées et, avec --ameliorer, celles corrigées. Tout est sur master, rien n'est poussé : l'utilisateur annule ce qu'il ne garde pas par git revert.