Files
Support-Agent/.claude/skills/detector-learner/SKILL.md
T

12 KiB

name, description, argument-hint
name description argument-hint
detector-learner Séance automatique d'amélioration d'une famille de détecteurs du journal du matin (Displacement, Obstruction, Thermal displacement, Visibility, Target issue, No data) sur toutes les étiquettes de l'etiqueteur déjà produites (labeling/auto/), la seule vérité (D-116, D-118, D-132) — 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 toutes les stations et toutes les familles. Lancé par l'utilisateur (/detector-learner <FAMILLE>), ou par Claude quand l'utilisateur lui demande d'améliorer les détecteurs ou de lancer une séance. <FAMILLE> [--ameliorer]

detector-learner : une famille de 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/ ; une séance travaille une famille (labeling/familles.md, un détecteur par famille, D-119), sur toutes les stations à la fois (D-132) : un même phénomène, vu sur toutes les stations, donne une règle générale, et les contradictions entre stations se voient d'emblée. 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 : la famille, une clé de labeling/familles.md (Visibility, Obstruction, Thermal displacement, Displacement, Target issue, No data) ; casse et tirets libres (« thermal-displacement » vaut Thermal displacement). --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 : lis-le au mieux et note sous « Erreurs » du bilan comment ; une famille inconnue : dis-le et arrête-toi, sans commit.
  • FAMILLE = la clé ; F = la clé, espaces en tirets (Thermal-displacement), pour les chemins.
  • SEANCE = date -u +%Y-%m-%dT%H%MZ ; dossier de séance detector-learner/<SEANCE>_<F>/, 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). Refais ce relevé avant chaque contrôle et avant le bilan, avec les données repompées (find data/ -name '*.csv' -newer <séance>/benchmark-avant.txt | cut -d/ -f2 | sort -u, data/ étant hors de git) : un fichier changé pendant la séance par une autre session va sous « Erreurs » (les benchmarks d'avant et d'après ne portent plus sur les mêmes étiquettes ou données) ; avant un contrôle, relance alors le benchmark avant sur le dépôt à la base de la séance (git worktree add dans un dossier mktemp -d, liens vers data/) dans <séance>/benchmark-avant-relance.txt, et ajoute à la demande du contrôle : Changé pendant la séance : <chemins ou stations> ; benchmark avant relancé : <séance>/benchmark-avant-relance.txt.

Le benchmark, la seule mesure de la séance : python3 .claude/skills/detector-learner/regression.py --seance <SEANCE>_<F> --etape <étape> > <séance>/benchmark-<étape>.txt 2>&1 (environ 1 min 30). Le score par famille et par instant sur chaque station de labeling/auto/ (en tête de chaque bloc, la station et sa plage, celle de ses étiquettes), puis leur Total, versé dans detector-learner/historique.csv, qui dit si les détecteurs font mieux d'une séance à l'autre. La ligne <FAMILLE> de chaque bloc et du Total est le score de la séance ; toutes les lignes, la non-régression (D-123). Les lignes de la famille seules : grep -E '^[A-Z]|^ <FAMILLE> ' <benchmark>.

Commandes par station, données telles quelles aux agents, la plage <du>, <au> étant celle de la station en tête de son bloc du benchmark : le journal, python3 detectors/categories.py data/<STATION> --du <du> --au <au> ; les capteurs, pour le critique, python3 .claude/skills/detector-learner/capteurs.py data/<STATION> --du <du> --au <au> (la cadence des mesures, puis les capteurs de chaque événement, dont le journal ne donne que le nombre). Dans les demandes, écris-les avec <STATION>, <du> et <au> : l'agent les remplit depuis le benchmark.

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 ou donnée au lancement : 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> ; ce qui l'accompagne (« Réserves » du contrôle) ne change pas la suite, il va au bilan. Le but de la séance : des détecteurs qui font au mieux, pas parfaits ; une autre lecture que les étiquettes, cohérente, est admise (D-135).

  1. Benchmark avant : étape avant, donc <séance>/benchmark-avant.txt. Commit <séance>/ detector-learner/historique.csv, message Detector-learner <FAMILLE>: benchmark.
  2. Detectors-critic (detectors-critic) : Famille : <FAMILLE>. Benchmark : <séance>/benchmark-avant.txt. Commande du journal : <commande>. Commande des capteurs : <commande des capteurs>. Étiquettes : labeling/auto/*.jsonl. Écris <séance>/critique.md. Commit <séance>/, message Detector-learner <FAMILLE>: critique (<verdict>). Verdict d'accord : va au bilan.
  3. Detectors-upgrader (detectors-upgrader), passage K = 1, 2 ou 3 : Famille : <FAMILLE>. 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 <FAMILLE>: 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 <FAMILLE>: modification K.
  4. Detectors-control (detectors-control), qui ne lit ni la critique ni le détail de la modification : Famille de la séance : <FAMILLE>. 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. Commande du journal : <commande>. Base : <base de la séance>. Passage K sur 3. Écris <séance>/validation-K.md. Commit <séance>/, message Detector-learner <FAMILLE>: 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 <FAMILLE>: 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 <FAMILLE>: 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 famille, la base de la séance (git log --oneline <base>..HEAD), le nombre d'étiquettes de la famille (cat labeling/auto/*.jsonl | grep -c '"categorie": "<FAMILLE>"') ; avant → fin, la ligne <FAMILLE> de chaque station qui a changé et du Total, puis les autres lignes changées (station, famille) ; critique (d'accord / suggestions n, les stations examinées), 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, « Réserves » des contrôles ; 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 <FAMILLE>: 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 <FAMILLE>: 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 <FAMILLE>: process fixes. Garde la suite de ce skill telle que tu l'as lue au début.

5. Réponse finale

En 6 lignes au plus : la base de la séance, le bilan, la ligne <FAMILLE> du Total avant → fin et les stations qui ont le plus changé, la modification gardée ou non, les erreurs et difficultés relevées et, avec --ameliorer, celles corrigées ; pour voir une station, la page Compare (python3 detectors-view/compare.py data/<STATION> --du <du> --au <au>). Tout est sur master, rien n'est poussé : l'utilisateur annule ce qu'il ne garde pas par git revert.