Files
Support-Agent/.claude/skills/aiguiser/SKILL.md
T
2026-10-24 16:18:20 +02:00

7.6 KiB
Raw Blame History

name, description, disable-model-invocation, argument-hint
name description disable-model-invocation argument-hint
aiguiser 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. true <dossier de station> [--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 <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.
  • git switch -c aiguiser/<SEANCE>_<STATION> ; les fichiers modifiés de l'utilisateur suivent sans être commités : tu commites toujours par chemin.
  • Dossier de séance : vues-deplacements/aiguiser/<SEANCE>_<STATION>/, ci-dessous <séance>.

2. Les lots

python3 vues-deplacements/journal/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>.

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\*\* :' <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>.

  1. Lecteur (lecteur) : Dossier : <dossier>. Lot NN : <début> → <fin> (UTC). Écris <lot>/lecture-1.md, figures dans <lot>/lecture-1/. 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.
  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.
    • Lecteur, J = K + 1 : Dossier : <dossier>. Lot NN : <début> → <fin> (UTC). Écris <lot>/lecture-J.md, figures dans <lot>/lecture-J/. 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.
    • 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.

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/<SEANCE>/C-xxx, puis ln -s "$PWD/agents/diagnostic/cas/C-xxx/displacement" out/aiguiser/<SEANCE>/C-xxx/displacement, et de même images s'il existe.
  2. Lecteur : Dossier : out/aiguiser/<SEANCE>/C-xxx/. Toute la période. Écris <séance>/controle/C-xxx/lecture.md, figures dans <séance>/controle/C-xxx/lecture/.
  3. Correcteur : Contrôle. Fiche : agents/diagnostic/cas/C-xxx/cas.md. Lecture : <séance>/controle/C-xxx/lecture.md. Écris <séance>/controle/C-xxx/ecart.md.

Puis les commandes des fiches, toutes ; note les lignes ÉCHEC pour le bilan :

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 <séance>/controle/, message Sharpen <STATION>: contrôle (<n> retrouvés sur <m>). 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 <outils> 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

<séance>/bilan.md :

# Séance <SEANCE> : <STATION>, <début> → <fin> (UTC)

Branche : aiguiser/<SEANCE>_<STATION>

| 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 : <n> en échec sur <m> <et lesquelles>

## Défauts non traités
<les défauts de l'écart gardé (REF) des lots restés « à reprendre »>

## Manques imputés au lecteur
<les lignes de faute « lecteur » des écarts gardés>

## Nouveautés (pour /boucle ou /nouveau-cas)
<les « Nouveautés » des écarts>

## Erreurs
aucune | <lot, agent, ce qui manquait>

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 du contrôle, 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.

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.