12 KiB
name, description, disable-model-invocation, argument-hint
| name | description | disable-model-invocation | argument-hint |
|---|---|---|---|
| boucle | Séance automatique d'amélioration des détecteurs du journal du matin et de la base de cas, lot après lot, sur une station (D-057) — analyste, upgrader, validateur, builder. Lancé par l'utilisateur seulement, avec /boucle. | true | data/<STATION> [--du AAAA-MM-JJ] [--au AAAA-MM-JJ] [--lot 4] [--ameliorer] |
La boucle automatique
Tu es l'orchestrateur. Tu découpes la plage en lots, tu appelles les quatre 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. Spec : vues-deplacements/contexte/boucle-automatique.md.
1. Mise en place
- Arguments : le dossier de station ; un nom de station seul (« Nordend ») désigne
data/<NOM EN MAJUSCULES>/(D-065) ;--du,--au(jours UTC, facultatifs : sans eux, toute la période ;--auest exclu : la plage s'arrête à--au00:00Z,--du 2026-09-01 --au 2026-09-05fait 4 jours) ;--lot(jours, 4 par défaut) ;--ameliorer(facultatif : en fin de séance, l'améliorateur corrige le processus d'après les relevés du releveur, §6, D-071). L'utilisateur choisit ses lots :--du/--ausur la plage d'un lot n'en traite qu'un. Des dates écrites autrement (« 2026-09.01 », deux dates sans option) se lisent comme--dupuis--au; une option entre crochets ([--ameliorer], la syntaxe d'usage recopiée) vaut l'option sans crochets ; écris dans le bilan, sous « Erreurs », comment tu as lu un argument qui n'était pas net. python3 agents/diagnostic/outils/inventaire.py <dossier>: dossier absent ou sans export « advanced », dis-le et arrête-toi.STATION= le nom du dossier de station (NORDEND) ;SEANCE=date -u +%Y-%m-%dT%H%MZ.- La séance se commite directement sur
master(D-070) :git branch --show-currentdoit diremaster, sinon dis-le et arrête-toi (pas degit switch: une autre session peut travailler dans ce dépôt). Note la base de la séance :git rev-parse HEAD. Les fichiers modifiés de l'utilisateur restent sans être commités : tu commites toujours par chemin. Une autre session peut travailler dans le même dépôt pendant la séance (fichiers modifiés, index déjà chargé, même ce skill) :git commit -- <chemins>ne prend que tes chemins ; n'indexe rien d'autre, jamais degit add -A,git stashnigit checkouthors de tes chemins ; garde les consignes lues au début et note le changement dans tes difficultés. - Dossier de séance :
vues-deplacements/boucle/<SEANCE>_<STATION>/, ci-dessous<séance>.
2. Les lots
python3 vues-deplacements/detectors/categories.py <dossier> --tranche <lot> [--du …] [--au …] : chaque en-tête == <début> → <fin> : … est un lot, numéroté 01, 02… Dossier du lot : <séance>/lot-NN/, ci-dessous <lot>.
Commande du lot, donnée telle quelle aux agents : python3 vues-deplacements/detectors/categories.py <dossier> --du <jour du début> --tranche <lot>, plus --au <jour de la fin> si la fin tombe à 00:00Z ; sinon c'est le dernier lot, sans --au. Exemple : lot 2026-10-05T00:00Z → 2026-10-09T00:00Z : --du 2026-10-05 --au 2026-10-09 --tranche 4.
3. Pour chaque lot, dans l'ordre
Chaque agent est appelé par l'outil Agent avec son subagent_type et la demande ci-dessous, rien d'autre. Un verdict se lit par grep '^\*\*Verdict\*\* :' <rendu>. Chaque commit se fait par chemin, git add <chemins> && git commit -m "<message>" -- <chemins>, et son message se termine par une ligne vide puis Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>.
- Analyste (
analyste) :Dossier : <dossier>. Lot NN : <début> → <fin> (UTC). Commande du lot : <commande>. Écris <lot>/critique.md.python3 .claude/skills/critiquer-lot/etiquettes.py <dossier> <lot>/etiquettes.json: sa dernière ligne va au bilan (colonne Étiquettes : « n moments », « absentes » ou « n défauts ») ; tu ne corriges rien et ne relances pas l'analyste pour elles (D-061).python3 .claude/skills/boucle/score.py <dossier> > <lot>/score-avant.txt 2>&1: le score des détecteurs du début du lot sur toutes les étiquettes de la station, ce lot compris (D-062).python3 .claude/skills/boucle/benchmark.py --seance <SEANCE> --etape "lot-NN avant" > <lot>/benchmark-avant.txt 2>&1: le benchmark, les détecteurs face au diagnostic gardé dans chaque cas de la base, ajouté à l'historique (D-069). Commit<lot>/ vues-deplacements/benchmark/historique.csv, messageLoop <STATION> lot NN: critique (<verdict>). - Verdict
d'accord: va à l'étape 5. - Upgrader (
upgrader), passage K = 1, 2 ou 3. Avant le passage 1, note la base du lot :git rev-parse HEAD.Dossier : <dossier>. Lot NN : <début> → <fin> (UTC). Commande du lot : <commande>. Critique : <lot>/critique.md. Score avant : <lot>/score-avant.txt. Benchmark avant : <lot>/benchmark-avant.txt. [Validation précédente : <lot>/validation-(K-1).md.] Passage K. Écris <lot>/modification-K.md.Commitvues-deplacements/detectors/ vues-deplacements/contexte/seuils-du-journal.md <lot>/, messageLoop <STATION> lot NN: modification K. Puis, les détecteurs commités :python3 .claude/skills/boucle/benchmark.py --seance <SEANCE> --etape "lot-NN modification K" > <lot>/benchmark-K.txt 2>&1(commité avec la validation). - Validateur (
validateur) :Dossier : <dossier>. Lot NN : <début> → <fin> (UTC). Commande du lot : <commande>. Critique : <lot>/critique.md. Score avant : <lot>/score-avant.txt. Modification : <lot>/modification-K.md. Benchmark : <lot>/benchmark-avant.txt → <lot>/benchmark-K.txt. Base : <base du lot>. Passage K sur 3. Écris <lot>/validation-K.md.Commit<lot>/ vues-deplacements/benchmark/historique.csv, messageLoop <STATION> lot NN: validation K (<verdict>).acceptéougarder: va à l'étape 5.à reprendre: retour à l'étape 3, passage K + 1.annuler:git checkout <base du lot> -- vues-deplacements/detectors/ vues-deplacements/contexte/seuils-du-journal.md, commit de ces deux chemins, messageLoop <STATION> lot NN: modification annulée.
- Builder (
builder), seulement si l'un des rendus du lot a, sous## Nouveautés, autre chose queaucune:Dossier : <dossier>. Lot NN : <début> → <fin> (UTC). Dossier du lot : <lot>/. Séance : <séance>/. Écris <lot>/builder.md.Si sa ligne**Cas créés** :n'est pasaucun: commitagents/diagnostic/cas/ .claude/skills/anonymiser-cas/registre.csv <lot>/, messageLoop <STATION> lot NN: cas C-xxx, …; sinon commit<lot>/, messageLoop <STATION> lot NN: builder (aucun cas).
Le lot suivant tourne avec les détecteurs tels qu'ils sont devenus. L'analyste ne relit pas les lots déjà vus ; le score les rejoue, sur leurs étiquettes, et le benchmark rejoue les cas de la base, les cas créés au lot compris (leur etiquettes.json).
4. Imprévus
Un rendu absent après son agent, ou sans ligne de verdict lisible : note-le pour le bilan ; si les détecteurs ont changé depuis la base du lot, remets-les comme pour annuler ; passe au lot suivant. Ne relance pas un agent plus d'une fois.
5. Bilan
python3 .claude/skills/boucle/score.py <dossier> > <séance>/score-fin.txt 2>&1 : le score des détecteurs de fin de séance sur toutes les étiquettes de la station.
python3 .claude/skills/boucle/benchmark.py --seance <SEANCE> --etape fin > <séance>/benchmark-fin.txt 2>&1 : le benchmark de fin de séance (D-069).
<séance>/bilan.md :
# Séance <SEANCE> : <STATION>, <début> → <fin> (UTC)
Commits : sur `master`, depuis <base de la séance> (`git log --oneline <base de la séance>..HEAD`)
Score : au début de chaque lot `lot-NN/score-avant.txt`, en fin de séance `score-fin.txt` (D-062).
Benchmark sur la base de cas (D-069) : au début de chaque lot `lot-NN/benchmark-avant.txt`, après chaque modification `lot-NN/benchmark-K.txt`, en fin de séance `benchmark-fin.txt` ; historique `vues-deplacements/benchmark/historique.csv`. Total : <ligne `total` de la catégorie `toutes` du premier benchmark, colonnes alignées : `grep -E '^total +toutes'`> → <celle de `benchmark-fin.txt`>.
Page : `out/boucle_<SEANCE>_<STATION>.html`, l'analyste face aux détecteurs sur toute la plage (D-066) ; la refaire : `python3 .claude/skills/boucle/comparaison.py <dossier> <séance>`.
| Lot | Dates (UTC) | Analyste | Étiquettes | Modification | Cas créés |
|---|---|---|---|---|---|
| 01 | … → … | d'accord / suggestions (n) | n moments / absentes / n défauts | aucune / gardée (K passages) / annulée / erreur | C-xxx / aucun |
## Suggestions non traitées
<« Pas corrigé » des modifications ; suggestions d'un lot sans modification gardée>
## Nouveautés déjà connues
<lignes « déjà connue » des builders>
## Erreurs
aucune | <lot, agent, ce qui manquait>
Commit <séance>/bilan.md <séance>/score-fin.txt <séance>/benchmark-fin.txt vues-deplacements/benchmark/historique.csv, message Loop <STATION>: bilan.
6. Difficultés
Releveur (releveur), une fois, même si tout s'est bien passé : Processus : /boucle (.claude/skills/boucle/SKILL.md). Séance : <séance>/ : la section « Difficultés » de chaque rendu des lots, et « Erreurs » du bilan. Difficultés de l'orchestrateur : aucune | <une consigne de ce skill qui t'a fait deviner, une commande qui a échoué…>. (D-060)
Si git status --short docs/ameliorations-processus.md montre un changement : commit de ce chemin, message Loop <STATION>: process difficulties.
Améliorateur (ameliorateur), seulement avec --ameliorer et si le releveur a commité : 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/boucle/ .claude/skills/critiquer-lot/ .claude/agents/analyste.md .claude/agents/upgrader.md .claude/agents/validateur.md .claude/agents/builder.md .claude/agents/releveur.md .claude/agents/ameliorateur.md vues-deplacements/contexte/boucle-automatique.md run.md docs/ameliorations-processus.md, seulement ceux que git status --short montre changés, message Loop <STATION>: process fixes. Garde la suite de ce skill telle que tu l'as lue au début.
7. Réponse finale
python3 .claude/skills/boucle/comparaison.py <dossier> <séance> : la page de fin de séance, out/boucle_<SEANCE>_<STATION>.html, qui s'ouvre dans le navigateur (D-066). En haut, corr_x et corr_y de tous les capteurs sur toute la plage de la séance ; dessous, une ligne par catégorie : la lecture de l'analyste (ses étiquettes) au-dessus des événements des détecteurs tels qu'ils sont en fin de séance, et en gris ses moments hors catégorie ; sous la figure, le score de la séance et le benchmark sur la base de cas. Le but, séance après séance : que les deux coïncident. Un échec du script va dans la réponse, sans relance.
En 8 lignes au plus : la page, la base de la séance, le chemin du bilan, le benchmark (ligne total / toutes, grep -E '^total +toutes', début → fin), le nombre de modifications gardées et de cas créés, le nombre d'étiquettes (<séance>/lot-*/etiquettes.json, à garder même si l'utilisateur annule des modifications : elles ne dépendent pas des détecteurs), les erreurs, les 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.