Files
Support-Agent/.claude/skills/boucle/SKILL.md
T

11 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, sur un lot d'une station, la plage choisie par l'utilisateur (D-057) — analyste, upgrader, validateur, builder. Lancé par l'utilisateur seulement, avec /boucle. true data/<STATION> [--du AAAA-MM-JJ] [--au AAAA-MM-JJ] [--ameliorer]

La boucle automatique

Tu es l'orchestrateur. 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 ; --au est exclu : la plage s'arrête à --au 00:00Z, --du 2026-09-01 --au 2026-09-05 fait 4 jours) ; --ameliorer (facultatif : en fin de séance, l'améliorateur corrige le processus d'après les relevés du releveur, §6, D-071). La plage est le lot (D-072) : une séance traite un seul lot, de la longueur que l'utilisateur a choisie par --du / --au, sans découpe ; un --lot ou --tranche donné quand même est ignoré (note-le sous « Erreurs »). Des dates écrites autrement (« 2026-09.01 », deux dates sans option) se lisent comme --du puis --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-current doit dire master, sinon dis-le et arrête-toi (pas de git 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 de git add -A, git stash ni git checkout hors 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. Le lot

Un seul lot, numéroté 01 (NN ci-dessous) : de --du 00:00Z (sinon le premier jour de la « Période des mesures » de l'inventaire, 00:00Z) à --au 00:00Z (sinon la fin de cette période). Dossier du lot : <séance>/lot-01/, ci-dessous <lot>.

Commande du lot, donnée telle quelle aux agents : python3 vues-deplacements/detectors/categories.py <dossier>, plus --du et --au s'ils sont donnés. Exemple : --du 2026-10-05 --au 2026-10-09.

3. Le 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>.

  1. 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, message Loop <STATION> lot NN: critique (<verdict>).
  2. Verdict d'accord : va à l'étape 5.
  3. 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. Commit vues-deplacements/detectors/ vues-deplacements/contexte/seuils-du-journal.md <lot>/, message Loop <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).
  4. 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, message Loop <STATION> lot NN: validation K (<verdict>).
    • accepté ou garder : 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, message Loop <STATION> lot NN: modification annulée.
  5. Builder (builder), seulement si l'un des rendus du lot a, sous ## Nouveautés, autre chose que aucune : 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 pas aucun : commit agents/diagnostic/cas/ .claude/skills/anonymiser-cas/registre.csv <lot>/, message Loop <STATION> lot NN: cas C-xxx, … ; sinon commit <lot>/, message Loop <STATION> lot NN: builder (aucun cas).

L'analyste ne relit pas les lots des séances d'avant ; 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 bilan. 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 du lot `lot-01/score-avant.txt`, en fin de séance `score-fin.txt` (D-062).

Benchmark sur la base de cas (D-069) : au début du lot `lot-01/benchmark-avant.txt`, après chaque modification `lot-01/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.