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

7.2 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 <dossier de station> [--du AAAA-MM-JJ] [--au AAAA-MM-JJ] [--lot 4]

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 ; --du, --au (jours UTC, facultatifs : sans eux, toute la période) ; --lot (jours, 4 par défaut). L'utilisateur choisit ses lots : --du / --au sur la plage d'un lot n'en traite qu'un.
  • python3 agents/diagnostic/outils/inventaire.py <dossier> : 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.
  • git switch -c boucle/<SEANCE>_<STATION> ; les fichiers modifiés de l'utilisateur suivent sans être commités : tu commites toujours par chemin.
  • Dossier de séance : vues-deplacements/boucle/<SEANCE>_<STATION>/, ci-dessous <séance>.

2. Les lots

python3 vues-deplacements/journal/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/journal/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>.

  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). Commit <lot>/, 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. [Validation précédente : <lot>/validation-(K-1).md.] Passage K. Écris <lot>/modification-K.md. Commit vues-deplacements/journal/ vues-deplacements/contexte/seuils-du-journal.md <lot>/, message Loop <STATION> lot NN: modification K.
  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. Base : <base du lot>. Passage K sur 3. Écris <lot>/validation-K.md. Commit <lot>/, 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/journal/ 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).

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.

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.

<séance>/bilan.md :

# Séance <SEANCE> : <STATION>, <début> → <fin> (UTC)

Branche : boucle/<SEANCE>_<STATION>

Score : au début de chaque lot `lot-NN/score-avant.txt`, en fin de séance `score-fin.txt` (D-062).

| 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, 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.

7. Réponse finale

En 6 lignes au plus : la branche, le chemin du bilan, 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. Reste sur la branche : l'utilisateur la fusionne, en garde une partie ou revient en arrière.