Files
Support-Agent/.claude/skills/detector-learner/SKILL.md
T
2026-11-03 14:07:37 +01:00

10 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/), sans base d'events (D-116) — detectors-critic, detectors-upgrader, detectors-control ; le garde-fou est le score sur les autres stations étiquetées. Lancé par l'utilisateur seulement, avec /detector-learner. true data/<STATION> [--du AAAA-MM-JJ] [--au AAAA-MM-JJ] [--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/<STATION>.jsonl, écrites en amont par l'etiqueteur (D-106) : le diagnostic est déjà fait, il n'y a ni analyste ni base d'events ici (D-116). 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>/. --du, --au : jours UTC, --au exclu. Sans eux, la plage des étiquettes de la station : du jour de la première à minuit après la dernière (plage() de regression.py : python3 -c "import sys; sys.path.insert(0, '.claude/skills/detector-learner'); import regression; print(regression.plage('labeling/auto/<STATION>.jsonl'))"). --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 ; 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 : sa correspondance range les catégories du journal dans les familles pour score.py et regression.py) : 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 lot, 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 lot ne donne que le nombre).

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 (nombre de suggestions, catégories), 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. Score et non-régression avant. python3 .claude/skills/events-learner/score.py <dossier> --du <début> --au <fin> > <séance>/score-avant.txt 2>&1 ; s'il sort en erreur (« Aucune étiquette »), dis-le et arrête-toi, sans commit. python3 .claude/skills/detector-learner/regression.py --sauf <STATION> > <séance>/regression-avant.txt 2>&1 : les mêmes détecteurs face aux étiquettes des autres stations, le garde-fou. python3 .claude/skills/detector-learner/regression.py --seance <SEANCE>_<STATION> --etape avant > <séance>/regression-avant-global.txt 2>&1 : le benchmark, sur toutes les étiquettes de labeling/auto/, la station du lot comprise ; ses lignes entrent dans detector-learner/historique.csv, qui dit si les détecteurs font globalement mieux d'une séance à l'autre. Commit <séance>/ detector-learner/historique.csv, message Detector-learner <STATION>: score.
  2. Detectors-critic (detectors-critic) : Dossier : <dossier>. Lot 01 : <début> → <fin> (UTC). Commande du lot : <commande>. Commande des capteurs : <commande des capteurs>. Étiquettes : labeling/auto/<STATION>.jsonl, celles qui touchent le lot. Score avant : <séance>/score-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>. Lot 01 : <début> → <fin> (UTC). Commande du lot : <commande>. Critique : <séance>/critique.md. Score avant : <séance>/score-avant.txt. Benchmark avant (/detector-learner, toutes les étiquettes de labeling/auto/, pas de base d'events) : <séance>/regression-avant-global.txt, à relancer par python3 .claude/skills/detector-learner/regression.py (sans --sauf ni --etape) ; ses blocs des autres stations sont la non-régression. [Contrôle précédent : <séance>/validation-(K-1).md.] Passage K. Écris <séance>/modification-K.md. Puis python3 .claude/skills/detector-learner/regression.py --sauf <STATION> > <séance>/regression-K.txt 2>&1 et python3 .claude/skills/detector-learner/regression.py --seance <SEANCE>_<STATION> --etape "modification K" > <séance>/regression-K-global.txt 2>&1. Commit detectors/ vues-deplacements/contexte/seuils-du-journal.md <séance>/ detector-learner/historique.csv, message Detector-learner <STATION>: modification K.
  4. Detectors-control (detectors-control), qui ne regarde pas le lot : Modification : <séance>/modification-K.md. Benchmark (/detector-learner, toutes les étiquettes de labeling/auto/, pas de base d'events) : <séance>/regression-avant-global.txt → <séance>/regression-K-global.txt, à relancer par python3 .claude/skills/detector-learner/regression.py (sans --sauf ni --etape). Non-régression, les autres stations seules : <séance>/regression-avant.txt → <séance>/regression-K.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.
    • à 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

python3 .claude/skills/events-learner/score.py <dossier> --du <début> --au <fin> > <séance>/score-fin.txt 2>&1. Si la modification est annulée, python3 .claude/skills/detector-learner/regression.py --seance <SEANCE>_<STATION> --etape fin > <séance>/regression-fin-global.txt 2>&1, pour que l'historique finisse sur 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 ; le score avant → fin, famille par famille ; la ligne Total de la non-régression avant → celle de la modification gardée, et celle du benchmark (-global) ; critique (d'accord / suggestions n), modification (aucune / gardée en K passages / annulée / erreur) ; ## 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/events-learner/comparaison.py <dossier> <séance> --du <début> --au <fin> : la page de fin de séance, les étiquettes face aux détecteurs famille par famille (son annexe garde le benchmark des events, pour information). 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, le score avant → fin, la non-régression et le benchmark (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.