diff --git a/.claude/skills/aiguiser/SKILL.md b/.claude/skills/aiguiser/SKILL.md index 2637080..17abd58 100644 --- a/.claude/skills/aiguiser/SKILL.md +++ b/.claude/skills/aiguiser/SKILL.md @@ -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/ [--du AAAA-MM-JJ] [--au AAAA-MM-JJ] [--lot 4] [--ameliorer]" +argument-hint: "data/ [--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 ` : 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/_/`, ci-dessous ``. -## 2. Les lots +## 2. Le lot -`python3 vues-deplacements/detectors/categories.py --tranche [--du …] [--au …] | grep '^=='` : chaque en-tête `== → : …` est un lot, numéroté `01`, `02`… (tu ne vois que les en-têtes, pas les événements). Dossier du lot : `/lot-NN/`, ci-dessous ``. +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 : `/lot-01/`, ci-dessous ``. -## 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\*\* :' `, la comparaison par `grep '^\*\*Par rapport' `. Chaque commit se fait par chemin, `git add && git commit -m "" -- `, et son message se termine par une ligne vide puis `Co-Authored-By: Claude Opus 5.5 `. Outils : `agents/diagnostic/outils/ .claude/skills/lire-les-donnees/`, ci-dessous ``. @@ -29,7 +29,7 @@ Chaque agent est appelé par l'outil Agent avec son `subagent_type` et la demand Commit `/`, message `Sharpen lot NN: lecture 1`. 2. **Correcteur** (`correcteur`) : `Lecture lente. Dossier : . Lot NN : → (UTC). Écris /corrige.md, scripts et figures dans /corrige/ ; puis, après seulement, lis /lecture-1.md et écris /ecart-1.md.` Commit `/`, message `Sharpen lot NN: corrigé, écart 1 ()`. `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 : . Lot NN : → (UTC). Écart : /ecart-REF.md. [Modification annulée : /modification-(K-1).md.] Passage K. Écris /modification-K.md.` (la modification annulée, seulement si le passage K − 1 l'a été) Commit ` /`, message `Sharpen lot NN: modification K`. @@ -37,13 +37,13 @@ Chaque agent est appelé par l'outil Agent avec son `subagent_type` et la demand Commit `/`, message `Sharpen lot NN: lecture J`. - **Correcteur** : `Écart seul. Dossier : . Lot NN : → (UTC). Corrigé : /corrige.md. Lecture : /lecture-J.md. Écart de référence : /ecart-REF.md. Écris /ecart-J.md.` Commit `/`, message `Sharpen lot NN: écart J (, )`. - - `mieux` : `REF` = J ; verdict `rien à reprendre` : lot suivant. + - `mieux` : `REF` = J ; verdict `rien à reprendre` : §4. - `pareil` ou `moins bien` : `git restore --source= --staged --worktree -- ` (il supprime aussi un outil créé pendant le passage), puis commit de ``, message `Sharpen 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 --debut --fin --sortie /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 `/`, message `Sharpen : 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 --debut --fin --sortie /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 `/`, message `Sharpen : 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 `` 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 `` 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 (`git log --oneline en échec sur -Ce que rendent les outils : `lot-NN/outils/index.html`, un par lot (§4 bis) +Ce que rendent les outils : `lot-01/outils/index.html` (§4 bis) ## Défauts non traités - + ## Manques imputés au lecteur @@ -95,7 +95,7 @@ Commit `/bilan.md`, message `Sharpen : 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 : / : la section « Difficultés » de chaque rendu des lots, et « Erreurs » du bilan. Difficultés de l'orchestrateur : aucune | .` (D-060) +**Releveur** (`releveur`), une fois, même si tout s'est bien passé : `Processus : /aiguiser (.claude/skills/aiguiser/SKILL.md). Séance : / : la section « Difficultés » de chaque rendu du lot, et « Erreurs » du bilan. Difficultés de l'orchestrateur : aucune | .` (D-060) Si `git status --short docs/ameliorations-processus.md` montre un changement : commit de ce chemin, message `Sharpen : process difficulties`. **Améliorateur** (`ameliorateur`), seulement avec `--ameliorer` et si le releveur a commité : `Processus : /aiguiser. Commit du releveur : .`, 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 : process fixes`. Garde la suite de ce skill telle que tu l'as lue au début. diff --git a/vues-deplacements/contexte/aiguiser-la-lecture.md b/vues-deplacements/contexte/aiguiser-la-lecture.md index 67dec27..9c641fd 100644 --- a/vues-deplacements/contexte/aiguiser-la-lecture.md +++ b/vues-deplacements/contexte/aiguiser-la-lecture.md @@ -52,26 +52,26 @@ Il ne contient ni catégorie, ni cas, ni hypothèse, ni verdict : c'est l'affair ## 5. Une séance -**Lancement** : `/aiguiser [--du AAAA-MM-JJ] [--au AAAA-MM-JJ] [--lot 4] [--ameliorer]`, par l'utilisateur seul, d'après son expression « aiguiser la vision » (accepté). Séparé de `/boucle` (l'utilisateur : « un autre processus automatique »). L'utilisateur choisit les lots, comme pour `/boucle` ; même découpe, lots de 4 jours par défaut *(choix de Claude)*. +**Lancement** : `/aiguiser [--du AAAA-MM-JJ] [--au AAAA-MM-JJ] [--ameliorer]`, par l'utilisateur seul, d'après son expression « aiguiser la vision » (accepté). Séparé de `/boucle` (l'utilisateur : « un autre processus automatique »). **La plage est le lot**, sans découpe, comme pour `/boucle` (D-078, D-072) : une séance, un lot, de la longueur choisie par `--du` / `--au` (l'utilisateur). -**Mise en place** *(choix de Claude, calquée sur `/boucle`)* : sur `master`, sans changer de branche (ailleurs, l'orchestrateur le dit et s'arrête), la base de la séance notée au bilan (D-077) ; dossier de séance `vues-deplacements/aiguiser/_/`, hors de tout dossier de station ; un dossier `lot-NN/` par lot. L'agent de diagnostic ne lit pas `vues-deplacements/` : il ne verra pas les rendus de la séance. +**Mise en place** *(choix de Claude, calquée sur `/boucle`)* : sur `master`, sans changer de branche (ailleurs, l'orchestrateur le dit et s'arrête), la base de la séance notée au bilan (D-077) ; dossier de séance `vues-deplacements/aiguiser/_/`, hors de tout dossier de station ; un dossier `lot-01/`, le lot de la séance. L'agent de diagnostic ne lit pas `vues-deplacements/` : il ne verra pas les rendus de la séance. -**Pour chaque lot, dans l'ordre** (accepté) : +**Le lot, dans l'ordre** (accepté) : 1. **Lecteur** : il lit le lot avec le skill, rien d'autre, et écrit `lecture-1.md`. Commit. 2. **Correcteur, lecture lente** : il lit le lot à fond, sans les outils de lecture, et écrit `corrige.md` ; puis il lit `lecture-1.md` et écrit `ecart-1.md`, avec son verdict, `rien à reprendre` ou `à reprendre`. Commit. -3. `rien à reprendre` : lot suivant. +3. `rien à reprendre` : fin de séance. 4. **Optimiseur**, passage K = 1, 2 ou 3 : il modifie le skill d'après le dernier écart et écrit `modification-K.md`. Commit des outils, du skill et du lot. 5. **Lecteur** à nouveau, sans rien savoir de la modification : `lecture-(K+1).md`. Commit. 6. **Correcteur, écart seul** : il compare `lecture-(K+1).md` au même `corrige.md`, sans refaire la lecture lente, et écrit `ecart-(K+1).md` avec, en plus de son verdict, une ligne `**Par rapport à la lecture précédente** : mieux | pareil | moins bien`. Commit. - `mieux` : la modification reste. - `pareil` ou `moins bien` : l'orchestrateur remet les outils et le skill tels qu'ils étaient avant le passage K, et commite ; un changement sans gain n'est que de la complexité *(choix de Claude)*. Le passage suivant de l'optimiseur lit le dernier écart gardé et la modification annulée, pour essayer autre chose. - - Verdict `rien à reprendre`, ou trois passages faits : lot suivant. Sinon, retour à l'étape 4. + - Verdict `rien à reprendre`, ou trois passages faits : fin de séance. Sinon, retour à l'étape 4. -Le lot suivant tourne avec le skill tel qu'il est devenu. +La séance suivante tourne avec le skill tel qu'il est devenu. **Commandes des fiches, une fois, en fin de séance** : l'orchestrateur lance les commandes que citent les fiches de la base de cas (pas d'agent) ; les échecs vont au bilan. Rien n'est annulé d'office : le bilan le dit et l'utilisateur décide. Il n'y a plus de contrôle de lecture sur les cinq cas validés (D-064) : l'utilisateur a validé les diagnostics de ces cas, pas les outils qui les lisent. -**Bilan** : `bilan.md`, une ligne par lot (verdict du premier écart ; passages gardés, annulés ; verdict du dernier écart), les commandes des fiches en échec, les manques imputés au lecteur (que le skill ne pouvait pas corriger), les nouveautés vues par le correcteur (pour `/boucle` ou `/nouveau-cas`), les erreurs. Commit. +**Bilan** : `bilan.md`, une ligne pour le lot (verdict du premier écart ; passages gardés, annulés ; verdict du dernier écart), les commandes des fiches en échec, les manques imputés au lecteur (que le skill ne pouvait pas corriger), les nouveautés vues par le correcteur (pour `/boucle` ou `/nouveau-cas`), les erreurs. Commit. **Difficultés** : le releveur note celles de la séance (D-060) ; avec `--ameliorer`, l'améliorateur (`.claude/agents/ameliorateur.md`, le même que pour `/boucle`) corrige ensuite le skill `/aiguiser`, ses agents, `voir.py`, cette spec et `run.md` d'après ces relevés, et marque les entrées **traité** ; les outils de lecture et `lire-les-donnees` restent à l'optimiseur (D-076). Commit `Sharpen : process fixes`. @@ -143,8 +143,8 @@ Ordre de grandeur, à mesurer au premier essai : une lecture ≈ un passage de l ## 8. Ce que l'utilisateur trouve à la fin - Sur `master`, un commit par étape depuis la base de la séance notée au bilan ; il annule ce qu'il ne garde pas par `git revert`. -- `bilan.md` (§5), et dans chaque lot le corrigé, les lectures et les écarts, pour voir ce que la vision de Claude a gagné. -- Dans chaque lot, `outils/index.html` : ce que les outils, tels qu'ils sont devenus, rendent sur la plage du lot (texte imprimé et figures des cinq outils), avec la version des outils en tête. Le script `vues-deplacements/aiguiser/voir.py --debut T --fin T` le produit aussi à la main, sur n'importe quelle plage (page dans `out/voir/__/`) : lancé à deux versions des outils, il donne deux pages à comparer. Sans agent ; les vignettes montrent les 3 capteurs qui s'écartent le plus de leur niveau habituel et le plus calme (*choix de Claude*). +- `bilan.md` (§5), et dans le lot le corrigé, les lectures et les écarts, pour voir ce que la vision de Claude a gagné. +- Dans le lot, `outils/index.html` : ce que les outils, tels qu'ils sont devenus, rendent sur la plage du lot (texte imprimé et figures des cinq outils), avec la version des outils en tête. Le script `vues-deplacements/aiguiser/voir.py --debut T --fin T` le produit aussi à la main, sur n'importe quelle plage (page dans `out/voir/__/`) : lancé à deux versions des outils, il donne deux pages à comparer. Sans agent ; les vignettes montrent les 3 capteurs qui s'écartent le plus de leur niveau habituel et le plus calme (*choix de Claude*). ## 9. Essai et première séance @@ -160,7 +160,7 @@ Ordre de grandeur, à mesurer au premier essai : une lecture ≈ un passage de l ## 10. Laissé au constructeur -Le texte des consignes de chaque agent ; le format exact des messages de commit ; la découpe des lots (celle de `/boucle`, §2 de son skill) ; comment le lecteur lit un cas sans voir sa fiche ni ses figures au contrôle (proposition : un dossier de liens vers `displacement/` et `images/`, hors du dépôt) ; ce qui reste du §3 et du §4 des instructions de l'agent de diagnostic une fois le mode d'emploi passé dans le skill, sans changer son raisonnement ; le mode de permission qui laisse une séance tourner sans demander d'accord (le correcteur écrit et lance des scripts). +Le texte des consignes de chaque agent ; le format exact des messages de commit ; le lot (la plage donnée, sans découpe, D-078) ; comment le lecteur lit un cas sans voir sa fiche ni ses figures au contrôle (proposition : un dossier de liens vers `displacement/` et `images/`, hors du dépôt) ; ce qui reste du §3 et du §4 des instructions de l'agent de diagnostic une fois le mode d'emploi passé dans le skill, sans changer son raisonnement ; le mode de permission qui laisse une séance tourner sans demander d'accord (le correcteur écrit et lance des scripts). À faire avec la construction : une entrée D-059 dans `docs/decisions.md` (le skill de lecture, seule source du mode d'emploi ; `/aiguiser` ; ce qui reste de « ses outils propres » de D-058) ; une ligne dans `CLAUDE.md` et dans `vues-deplacements/CLAUDE.md` ; dans `boucle-automatique.md` (§3), les outils ne sont plus « utilisés tels quels » mais évoluent par `/aiguiser` ; la spec de l'agent de diagnostic, `docs/agents/agent-diagnostic.md`, pour le renvoi au skill.