/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:
1 parent
53de07afa4
commit
5e665e761a
2 files changed
+27
-27
No files matched your search
@@ -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.
|
||||
|
||||
Reference in new issue
Block a user