/aiguiser: the range is the batch, no 4-day split (D-078)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-27 10:29:39 +01:00
1 parent 53de07afa4
commit 5e665e761a
2 files changed
+27 -27

No files matched your search

+17 -17
View File
@@ -1,27 +1,27 @@
---
name: aiguiser
description: Séance automatique d'amélioration des outils de lecture (agents/diagnostic/outils/) et du skill lire-les-donnees, lot après lot, sur une station (D-059) — lecteur, correcteur, optimiseur, puis commandes des fiches. Lancé par l'utilisateur seulement, avec /aiguiser.
description: Séance automatique d'amélioration des outils de lecture (agents/diagnostic/outils/) et du skill lire-les-donnees, sur un lot d'une station, la plage choisie par l'utilisateur (D-059, D-078) — lecteur, correcteur, optimiseur, puis commandes des fiches. Lancé par l'utilisateur seulement, avec /aiguiser.
disable-model-invocation: true
argument-hint: "data/<STATION> [--du AAAA-MM-JJ] [--au AAAA-MM-JJ] [--lot 4] [--ameliorer]"
argument-hint: "data/<STATION> [--du AAAA-MM-JJ] [--au AAAA-MM-JJ] [--ameliorer]"
---
# Aiguiser la lecture
Tu es l'orchestrateur. Tu découpes la plage en lots, tu appelles les trois agents dans l'ordre, tu transmets leurs rendus, tu annules ce qui n'apporte rien et tu commites ; en fin de séance, les commandes des fiches, puis le releveur (et l'améliorateur avec `--ameliorer`). **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/aiguiser-la-lecture.md`.
Tu es l'orchestrateur. Tu appelles les trois agents dans l'ordre, tu transmets leurs rendus, tu annules ce qui n'apporte rien et tu commites ; en fin de séance, les commandes des fiches, puis le releveur (et l'améliorateur avec `--ameliorer`). **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/aiguiser-la-lecture.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) ; `--ameliorer` (facultatif : en fin de séance, l'améliorateur corrige le processus d'après les relevés du releveur, §7, D-076). 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. L'utilisateur choisit ses lots : `--du` / `--au` sur la plage d'un lot n'en traite qu'un.
- Arguments : le dossier de station ; `--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, §7, D-076). 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. **La plage est le lot** (D-078, comme `/boucle`, 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 »).
- `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`.
- La séance se commite directement sur `master` (D-077, comme `/boucle`, 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, jamais de `git add -A`, `git stash` ni `git checkout` hors de tes chemins.
- Dossier de séance : `vues-deplacements/aiguiser/<SEANCE>_<STATION>/`, ci-dessous `<séance>`.
## 2. Les lots
## 2. Le lot
`python3 vues-deplacements/detectors/categories.py <dossier> --tranche <lot> [--du …] [--au …] | grep '^=='` : chaque en-tête `== <début> → <fin> : …` est un lot, numéroté `01`, `02`… (tu ne vois que les en-têtes, pas les événements). Dossier du lot : `<séance>/lot-NN/`, ci-dessous `<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 le lendemain du dernier jour de cette période). Une date qui déborde cette période y est ramenée, et dite sous « Erreurs » du bilan. Dossier du lot : `<séance>/lot-01/`, ci-dessous `<lot>`.
## 3. Pour chaque lot, dans l'ordre
## 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>`, la comparaison par `grep '^\*\*Par rapport' <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>`. Outils : `agents/diagnostic/outils/ .claude/skills/lire-les-donnees/`, ci-dessous `<outils>`.
@@ -29,7 +29,7 @@ Chaque agent est appelé par l'outil Agent avec son `subagent_type` et la demand
Commit `<lot>/`, message `Sharpen <STATION> lot NN: lecture 1`.
2. **Correcteur** (`correcteur`) : `Lecture lente. Dossier : <dossier>. Lot NN : <début> → <fin> (UTC). Écris <lot>/corrige.md, scripts et figures dans <lot>/corrige/ ; puis, après seulement, lis <lot>/lecture-1.md et écris <lot>/ecart-1.md.`
Commit `<lot>/`, message `Sharpen <STATION> lot NN: corrigé, écart 1 (<verdict>)`. `REF` = 1.
3. Verdict `rien à reprendre` : lot suivant.
3. Verdict `rien à reprendre` : §4.
4. **Passage K**, K = 1, 2 ou 3. `BASE` = `git rev-parse HEAD`.
- **Optimiseur** (`optimiseur`) : `Dossier : <dossier>. Lot NN : <début> → <fin> (UTC). Écart : <lot>/ecart-REF.md. [Modification annulée : <lot>/modification-(K-1).md.] Passage K. Écris <lot>/modification-K.md.` (la modification annulée, seulement si le passage K − 1 l'a été)
Commit `<outils> <lot>/`, message `Sharpen <STATION> lot NN: modification K`.
@@ -37,13 +37,13 @@ Chaque agent est appelé par l'outil Agent avec son `subagent_type` et la demand
Commit `<lot>/`, message `Sharpen <STATION> lot NN: lecture J`.
- **Correcteur** : `Écart seul. Dossier : <dossier>. Lot NN : <début> → <fin> (UTC). Corrigé : <lot>/corrige.md. Lecture : <lot>/lecture-J.md. Écart de référence : <lot>/ecart-REF.md. Écris <lot>/ecart-J.md.`
Commit `<lot>/`, message `Sharpen <STATION> lot NN: écart J (<verdict>, <comparaison>)`.
- `mieux` : `REF` = J ; verdict `rien à reprendre` : lot suivant.
- `mieux` : `REF` = J ; verdict `rien à reprendre` : §4.
- `pareil` ou `moins bien` : `git restore --source=<BASE> --staged --worktree -- <outils>` (il supprime aussi un outil créé pendant le passage), puis commit de `<outils>`, message `Sharpen <STATION> lot NN: modification K annulée`.
- Après le passage 3 : lot suivant. Sinon, passage K + 1.
- Après le passage 3 : §4. Sinon, passage K + 1.
Le lot suivant tourne avec le skill tel qu'il est devenu. Pas de rejeu des lots déjà vus.
Pas de rejeu des lots des séances d'avant : la séance suivante tourne avec le skill tel qu'il est devenu.
## 4. Commandes des fiches, après le dernier lot
## 4. Commandes des fiches, après le lot
Les commandes que citent les fiches de la base de cas, toutes ; note les lignes `ÉCHEC` pour le bilan (pas d'agent, pas de commit) :
@@ -55,11 +55,11 @@ Rien n'est annulé d'office : le bilan le dit, l'utilisateur décide.
## 4 bis. Ce que rendent les outils
Après les commandes des fiches, avec les outils tels qu'ils sont devenus, pour chaque lot : `python3 vues-deplacements/aiguiser/voir.py <dossier> --debut <début du lot> --fin <fin du lot> --sortie <lot>/outils` (une page `index.html` : le texte et les figures des cinq outils, la version des outils en tête ; sans agent). Une page en échec ne bloque rien : note-le pour le bilan. Commit `<séance>/`, message `Sharpen <STATION>: pages des outils`.
Après les commandes des fiches, avec les outils tels qu'ils sont devenus, sur le lot : `python3 vues-deplacements/aiguiser/voir.py <dossier> --debut <début du lot> --fin <fin du lot> --sortie <lot>/outils` (une page `index.html` : le texte et les figures des cinq outils, la version des outils en tête ; sans agent). Une page en échec ne bloque rien : note-le pour le bilan. Commit `<séance>/`, message `Sharpen <STATION>: pages des outils`.
## 5. Imprévus
Un rendu absent après son agent, ou sans ligne de verdict lisible : note-le pour le bilan ; si `<outils>` ont changé depuis `BASE`, remets-les comme pour une annulation ; passe au lot suivant. Ne relance pas un agent plus d'une fois.
Un rendu absent après son agent, ou sans ligne de verdict lisible : note-le pour le bilan ; si `<outils>` ont changé depuis `BASE`, remets-les comme pour une annulation ; passe au §4. Ne relance pas un agent plus d'une fois.
## 6. Bilan
@@ -76,10 +76,10 @@ Commits : sur `master`, depuis <base de la séance> (`git log --oneline <base de
Commandes des fiches : <n> en échec sur <m> <et lesquelles>
Ce que rendent les outils : `lot-NN/outils/index.html`, un par lot (§4 bis) <et les échecs>
Ce que rendent les outils : `lot-01/outils/index.html` (§4 bis) <et les échecs>
## Défauts non traités
<les défauts de l'écart gardé (REF) des lots restés « à reprendre »>
<les défauts de l'écart gardé (REF), si le lot reste « à reprendre »>
## Manques imputés au lecteur
<les lignes de faute « lecteur » des écarts gardés>
@@ -95,7 +95,7 @@ Commit `<séance>/bilan.md`, message `Sharpen <STATION>: bilan`.
## 7. Difficultés
**Releveur** (`releveur`), une fois, même si tout s'est bien passé : `Processus : /aiguiser (.claude/skills/aiguiser/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)
**Releveur** (`releveur`), une fois, même si tout s'est bien passé : `Processus : /aiguiser (.claude/skills/aiguiser/SKILL.md). Séance : <séance>/ : la section « Difficultés » de chaque rendu du lot, 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 `Sharpen <STATION>: process difficulties`.
**Améliorateur** (`ameliorateur`), seulement avec `--ameliorer` et si le releveur a commité : `Processus : /aiguiser. Commit du releveur : <commit>.`, le commit pris par `git rev-parse HEAD` juste après celui du releveur (D-076). Puis commit des chemins qu'il a pu toucher, `.claude/skills/aiguiser/ .claude/agents/lecteur.md .claude/agents/correcteur.md .claude/agents/optimiseur.md .claude/agents/releveur.md .claude/agents/ameliorateur.md vues-deplacements/aiguiser/voir.py vues-deplacements/contexte/aiguiser-la-lecture.md run.md docs/ameliorations-processus.md`, seulement ceux que `git status --short` montre changés, message `Sharpen <STATION>: process fixes`. Garde la suite de ce skill telle que tu l'as lue au début.