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 » vautThermal 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éancedetector-learner/<SEANCE>_<F>/, ci-dessous<séance>.- Commits directement sur
master(D-070) :git branch --show-currentdoit diremaster, 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>), jamaisgit add -A,git stashnigit checkouthors de tes chemins : une autre session peut travailler dans ce dépôt. Avant chaque commit,git branch --show-current; si ce n'est plusmaster, ne commite plus rien et passe au bilan. Chaque message finit par une ligne vide puisCo-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 archive <base> detectors agent-tools .claude/skills/detector-learner .claude/skills/analyser-lot | tar -xdans un dossiermktemp -d, liens versdata/etlabeling/) 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).
- Benchmark avant : étape
avant, donc<séance>/benchmark-avant.txt. Commit<séance>/ detector-learner/historique.csv, messageDetector-learner <FAMILLE>: benchmark. - 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>/, messageDetector-learner <FAMILLE>: critique (<verdict>). Verdictd'accord: va au bilan. - Detectors-upgrader (
detectors-upgrader), passage K = 1 : un seul passage par séance (l'utilisateur, 2026-11-05 ; N = 1 ci-dessous) :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, messageDetector-learner <FAMILLE>: modification K, S<n>: le contrôle peut ainsi en faire retirer une seule. Puis le benchmark, étapemodification K, dans<séance>/benchmark-K.txt. Commitdetectors/ vues-deplacements/contexte/seuils-du-journal.md <séance>/ detector-learner/historique.csv(sans les fichiers déjà modifiés notés au §1), messageDetector-learner <FAMILLE>: modification K. - 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 1. Écris <séance>/validation-K.md.Commit<séance>/, messageDetector-learner <FAMILLE>: control K (<verdict>).acceptéougarder: 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 ligneCo-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 pourannuler. Puis va au bilan.à reprendre(ne devrait pas venir, au dernier passage) : fais comme pourannuler.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, messageDetector-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.