13 KiB
name, description, argument-hint
| name | description | argument-hint |
|---|---|---|
| detector-learner | Séance automatique d'amélioration des détecteurs du journal du matin depuis une analyse de la page Data de Diagnostic-app (labeling/auto/analyses/<analyse>/) — detectors-critic, detectors-upgrader, detectors-control ; le but, des détecteurs plus proches des étiquettes de l'analyse sur sa plage, sans sur-apprentissage ; le garde-fou, le benchmark sur toutes les stations et toutes les familles de labeling/auto/. Lancé par le bouton « Optimiser les détecteurs » de l'app (claude -p --plugin-dir detectors), ou par l'utilisateur, /detectors:detector-learner <analyse>. | <analyse> |
detector-learner : les détecteurs depuis une analyse
Tu es l'orchestrateur. Tu tournes dans le dépôt de travail (Diagnostic-app, le dossier courant) : labeling/ (les étiquettes, la vérité ; les analyses), data/ (les données des stations), agent-tools/. Le dépôt detectors y est monté en detectors/ (un sous-module) : les détecteurs, leur registre des seuils detectors/seuils-du-journal.md, les scripts de ce skill (detectors/skills/detector-learner/) et les séances (detectors/detector-learner/). Deux dépôts git, donc : ce qui touche les détecteurs se commite dans detectors/ (git -C detectors …), l'analyse dans le dépôt de travail.
L'utilisateur a choisi une plage où les détecteurs le satisfont mal ; l'analyste l'a analysée dans la page Data : un rapport (rapport.md) et des étiquettes, versées dans labeling/auto/<STATION>.jsonl. L'utilisateur l'a relue, et lancer cette séance vaut son accord : il n'y a pas d'autre validation. Le but : des détecteurs plus proches des étiquettes de l'analyse sur sa plage, par un petit pas, sans sur-apprentissage : ils font un peu mieux là, et le benchmark sur toutes les stations et familles de labeling/auto/ reste bon. Tu appelles les agents 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
- Argument : le nom d'une analyse, un dossier de
labeling/auto/analyses/(ex.NORDEND_2026-11-04T2112_2026-11-07T1412) ; un chemin vers ce dossier vaut son nom.ANALYSE= le nom,A=labeling/auto/analyses/<ANALYSE>. Sans<A>/demande.json, ou sansdetectors/.claude-plugin/plugin.json: dis-le et arrête-toi, sans commit. - De
<A>/demande.json:STATION,début,fin(UTC).DU= le jour dedébut,AU= le lendemain du jour defin(AAAA-MM-JJ) : la plage des commandes, en jours entiers. SEANCE=date -u +%Y-%m-%dT%H%MZ; dossier de séancedetectors/detector-learner/<SEANCE>_<ANALYSE>/, ci-dessous<séance>.- Commits : dans les deux dépôts, la branche doit être
main(git branch --show-currentetgit -C detectors branch --show-current), sinon dis-le et arrête-toi ; un sous-module détaché (aucune branche) :git -C detectors checkout maind'abord, s'il n'a aucun changement. Tu commites toujours par chemin (git add <chemins> && git commit -m "<message>" -- <chemins>, ou avecgit -C detectors, les chemins relatifs àdetectors/), jamaisgit add -A,git stashnigit checkouthors de tes chemins : une autre session peut travailler dans ces dépôts. Avant chaque commit, la branche ; si ce n'est plusmain, 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>. Tu ne pousses rien. - Étape 0, l'analyse dans git : l'app ne commite pas ; si
git status --porcelain -- <A> labeling/auto/<STATION>.jsonlmontre quelque chose, commite ces deux chemins dans le dépôt de travail (git addrespecte.gitignore:travail/reste dehors), messageDetector-learner <ANALYSE>: étiquettes de l'analyse. Puis note la base de la séance :git -C detectors rev-parse HEAD. git -C detectors status --porcelainetgit status --porcelain -- 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 le contrôle et avant le bilan, avec les données repompées (find -L data/ -name '*.csv' -newer <séance>/benchmark-avant.txt | cut -d/ -f2 | sort -u) : un fichier changé pendant la séance par une autre session (une étiquette retouchée dans la page Data, par exemple) va sous « Erreurs » ; avant le contrôle, relance alors le benchmark avant à la base de la séance (dans un dossiermktemp -d:git -C detectors archive <base> --prefix=detectors/ | tar -x -C <dossier>, des liens versdata/,labeling/etagent-tools/du dépôt de travail, puispython3 <dossier>/detectors/skills/detector-learner/regression.py) 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.
Les deux mesures de la séance, à chaque étape :
- le benchmark, la non-régression :
python3 detectors/skills/detector-learner/regression.py --seance <SEANCE>_<ANALYSE> --etape <étape> > <séance>/benchmark-<étape>.txt 2>&1(environ 1 min 30). Le score par famille et par instant sur chaque station delabeling/auto/, puis leurTotal, versé dansdetectors/detector-learner/historique.csv; - le score de la plage, le but :
python3 detectors/skills/detector-learner/score.py data/<STATION> --du <DU> --au <AU> > <séance>/plage-<étape>.txt 2>&1. Les étiquettes delabeling/auto/<STATION>.jsonlqui touchent la plage (celles de l'analyse comprises), la vérité de la séance, face aux détecteurs, par famille. Il sort en erreur si aucune étiquette ne touche la plage : note-le sous « Erreurs » et va au bilan sans toucher aux détecteurs.
Commandes, données telles quelles aux agents : le journal, python3 detectors/categories.py data/<STATION> --du <DU> --au <AU> ; les capteurs, python3 detectors/skills/detector-learner/capteurs.py data/<STATION> --du <DU> --au <AU>. Pour le contrôle seulement, qui regarde toutes les stations, le journal avec <STATION>, <du> et <au> à remplir depuis l'en-tête du bloc de la station dans le benchmark : python3 detectors/categories.py data/<STATION> --du <du> --au <au>.
2. Dans l'ordre
Chaque agent est appelé par l'outil Agent avec son subagent_type (ceux de ce plugin : detectors:detectors-critic, detectors:detectors-upgrader, detectors:detectors-control, detectors:releveur) et la demande ci-dessous, rien d'autre, sauf une consigne de l'utilisateur donnée au lancement : ajoute-la telle quelle à la demande des agents (Consigne de l'utilisateur : …) et note-la au bilan ; elle passe avant leurs consignes, pas avant leur périmètre de fichiers. 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 : des détecteurs qui font mieux, pas parfaits ; une autre lecture que les étiquettes, cohérente, est admise.
Les commits de séance (le dossier de séance, detector-learner/historique.csv, les détecteurs, seuils-du-journal.md) se font dans detectors/ : git -C detectors add <chemins relatifs> && git -C detectors commit -m "<message>" -- <chemins relatifs>.
- Mesures avant : étape
avant, donc<séance>/benchmark-avant.txtet<séance>/plage-avant.txt. Commitdetector-learner/<SEANCE>_<ANALYSE>/ detector-learner/historique.csv, messageDetector-learner <ANALYSE>: benchmark. - Detectors-critic :
Analyse : <A>/. Station : <STATION>, plage <début> → <fin> (UTC). Commande du journal : <commande>. Commande des capteurs : <commande des capteurs>. Score de la plage : <séance>/plage-avant.txt. Benchmark : <séance>/benchmark-avant.txt. Écris <séance>/critique.md.Commit du dossier de séance, messageDetector-learner <ANALYSE>: critique (<verdict>). Verdictd'accord: va au bilan. - Detectors-upgrader, un seul passage :
Analyse : <A>/. Station : <STATION>. Commande du journal : <commande>. Critique : <séance>/critique.md. Benchmark avant : <séance>/benchmark-avant.txt, à relancer par python3 detectors/skills/detector-learner/regression.py (sans --etape). Score de la plage : python3 detectors/skills/detector-learner/score.py data/<STATION> --du <DU> --au <AU> (avant : <séance>/plage-avant.txt). Dossier de séance : <séance>. Fichiers déjà modifiés au début de la séance : <liste | aucun>. Écris <séance>/modification-1.md.L'upgrader commite lui-même, dansdetectors/, chaque suggestion gardée, avec son benchmark<séance>/benchmark-1-S<n>.txt, messageDetector-learner <ANALYSE>: modification 1, S<n>: le contrôle peut ainsi en faire retirer une seule. Puis les mesures, étapemodification 1, dans<séance>/benchmark-1.txtet<séance>/plage-1.txt. Commit, dansdetectors/, des détecteurs (*.pyà la racine), deseuils-du-journal.md, du dossier de séance et dedetector-learner/historique.csv(sans les fichiers déjà modifiés notés au §1), messageDetector-learner <ANALYSE>: modification 1. Aucune suggestion gardée (pas de commit, S<n>:git -C detectors log --format=%h --grep ', S[0-9]*$' <base>..HEAD) : va au bilan. - Detectors-control, qui ne lit ni la critique ni le détail de la modification :
Analyse : <ANALYSE>. Modification : <séance>/modification-1.md. Benchmark : <séance>/benchmark-avant.txt → <séance>/benchmark-1.txt, à relancer par python3 detectors/skills/detector-learner/regression.py (sans --etape) ; après chaque suggestion : <séance>/benchmark-1-S*.txt. Score de la plage : <séance>/plage-avant.txt → <séance>/plage-1.txt. Commande du journal : <commande du contrôle>. Base (dans detectors/) : <base de la séance>. Écris <séance>/validation-1.md.Commit du dossier de séance, messageDetector-learner <ANALYSE>: control (<verdict>).garder: va au bilan.retirer: pour chaque suggestion de la ligne**Retirer** :, ses commits de la séance (git -C detectors log --format=%h --grep ', S<n>$' <base de la séance>..HEAD), du plus récent au plus ancien :git -C detectors revert --no-edit <commit>, puis amende son message pour qu'il finisse par la ligneCo-Authored-By(git -C detectors commit --amend -m "Detector-learner <ANALYSE>: S<n> retirée" -m "Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>"). Un conflit :git -C detectors revert --abort, et fais comme pourannuler. Puis va au bilan.annuler, ou tout autre mot :git -C detectors checkout <base de la séance> -- '*.py' seuils-du-journal.md(sans les fichiers déjà modifiés notés au §1 ;skills/n'est pas touché), commit de ces chemins, messageDetector-learner <ANALYSE>: 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
Les mesures, étape fin, dans <séance>/benchmark-fin.txt et <séance>/plage-fin.txt.
<séance>/bilan.md, que la page Data affiche sous le rapport :
# Optimisation : <ANALYSE>
**Résultat** : modification gardée | gardée sans S<n>… | annulée | aucune | erreur
## La plage de l'analyse
<STATION>, <début> → <fin> ; le score de la plage, avant → fin, une ligne par famille (trouvées, justes)
## Toutes les stations
la ligne de chaque famille du `Total`, avant → fin ; puis les autres lignes changées (station, famille), avant → fin
## Ce qui a changé
<par suggestion gardée, une phrase (de « Ce qui a changé » de la modification)> ; la critique (d'accord / n suggestions), le contrôle (verdict)
## À trancher par l'utilisateur
<copiés tels quels : « Limites » de la critique, « À trancher par l'utilisateur » de la modification, « Réserves » du contrôle ; aucune s'il n'y a rien>
## Suggestions non traitées
<« Pas corrigé » de la modification ; aucune>
## Erreurs
<aucune, ou ce qui manquait ; la base de la séance et `git -C detectors log --oneline <base>..HEAD`>
Commit, dans detectors/, du dossier de séance et de detector-learner/historique.csv, message Detector-learner <ANALYSE>: bilan. Puis, dans le dépôt de travail, le sous-module à son nouveau commit : git add detectors && git commit -m "Detector-learner <ANALYSE>: détecteurs" -- detectors, si git status --porcelain -- detectors le montre changé.
4. Difficultés
Releveur (detectors:releveur), une fois, même si tout s'est bien passé : Processus : /detector-learner (detectors/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 | <…>.
Si git -C detectors status --short ameliorations-processus.md montre un changement : commit de ce chemin dans detectors/, message Detector-learner <ANALYSE>: process difficulties.
5. Réponse finale
En 4 lignes au plus : la ligne **Résultat** du bilan, le score de la plage avant → fin (familles changées), le Total avant → fin s'il a changé, le chemin du bilan. Rien n'est poussé : l'utilisateur pousse detectors pour que tous aient les détecteurs à jour, ou annule ce qu'il ne garde pas par git -C detectors revert.