--- 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. disable-model-invocation: true argument-hint: " [--du AAAA-MM-JJ] [--au AAAA-MM-JJ] [--lot 4]" --- # 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. **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). L'utilisateur choisit ses lots : `--du` / `--au` sur la plage d'un lot n'en traite qu'un. - `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`. - `git switch -c aiguiser/_` ; les fichiers modifiés de l'utilisateur suivent sans être commités : tu commites toujours par chemin. - Dossier de séance : `vues-deplacements/aiguiser/_/`, ci-dessous ``. ## 2. Les lots `python3 vues-deplacements/journal/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 ``. ## 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\*\* :' `, 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 ``. 1. **Lecteur** (`lecteur`) : `Dossier : . Lot NN : → (UTC). Écris /lecture-1.md, figures dans /lecture-1/.` 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. 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`. - **Lecteur**, J = K + 1 : `Dossier : . Lot NN : → (UTC). Écris /lecture-J.md, figures dans /lecture-J/.` 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. - `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. Le lot suivant tourne avec le skill tel qu'il est devenu. Pas de rejeu des lots déjà vus. ## 4. Commandes des fiches, après le dernier 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) : ```bash grep -oh '`[^`]*agents/diagnostic/outils/[^`]*`' agents/diagnostic/cas/*/cas.md | tr -d '`' | while read -r c; do eval "$c" >/dev/null 2>&1 || echo "ÉCHEC $c"; done ``` 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`. ## 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. ## 6. Bilan `/bilan.md` : ```markdown # Séance : , → (UTC) Branche : aiguiser/_ | Lot | Dates (UTC) | Premier écart | Passages | Dernier écart gardé | |---|---|---|---|---| | 01 | … → … | rien à reprendre / à reprendre | aucun / n gardés, m annulés / erreur | rien à reprendre / à reprendre | Commandes des fiches : en échec sur Ce que rendent les outils : `lot-NN/outils/index.html`, un par lot (§4 bis) ## Défauts non traités ## Manques imputés au lecteur ## Nouveautés (pour /boucle ou /nouveau-cas) ## Erreurs aucune | ``` 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) Si `git status --short docs/ameliorations-processus.md` montre un changement : commit de ce chemin, message `Sharpen : process difficulties`. ## 8. Réponse finale En 5 lignes au plus : la branche, le chemin du bilan, les passages gardés et annulés, les commandes des fiches en échec, les difficultés relevées. Reste sur la branche : l'utilisateur la fusionne, en garde une partie ou revient en arrière.