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

64 lines
12 KiB
Markdown

---
name: detector-learner
description: 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.
argument-hint: "<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<n>… / 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`.