diff --git a/.claude/skills/aiguiser/SKILL.md b/.claude/skills/aiguiser/SKILL.md new file mode 100644 index 0000000..95d59ab --- /dev/null +++ b/.claude/skills/aiguiser/SKILL.md @@ -0,0 +1,107 @@ +--- +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 contrôle sur les cas validés. 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, le contrôle sur les cas, 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. Contrôle, après le dernier lot + +Les cas validés : `grep '^| \[C-' agents/diagnostic/cas/INDEX.md | grep -v '| (appris)'`. Pour chacun (`C-xxx`) : + +1. Un dossier de liens, pour que le lecteur ne voie ni la fiche ni ses figures : `mkdir -p out/aiguiser//C-xxx`, puis `ln -s "$PWD/agents/diagnostic/cas/C-xxx/displacement" out/aiguiser//C-xxx/displacement`, et de même `images` s'il existe. +2. **Lecteur** : `Dossier : out/aiguiser//C-xxx/. Toute la période. Écris /controle/C-xxx/lecture.md, figures dans /controle/C-xxx/lecture/.` +3. **Correcteur** : `Contrôle. Fiche : agents/diagnostic/cas/C-xxx/cas.md. Lecture : /controle/C-xxx/lecture.md. Écris /controle/C-xxx/ecart.md.` + +Puis les commandes des fiches, toutes ; note les lignes `ÉCHEC` pour le bilan : + +```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 +``` + +Commit `/controle/`, message `Sharpen : contrôle ( retrouvés sur )`. Rien n'est annulé d'office : le bilan le dit, l'utilisateur décide. + +## 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 | + +## Contrôle +| Cas | Verdict | Critères manqués | +|---|---|---| + +Commandes des fiches : en échec sur + +## 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 du contrôle, 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, le contrôle (retrouvés sur combien, commandes en échec), les difficultés relevées. Reste sur la branche : l'utilisateur la fusionne, en garde une partie ou revient en arrière.