Files
Support-Agent/.claude/skills/aiguiser/SKILL.md
T

8.9 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 (agent-tools/) 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. true data/<STATION> [--du AAAA-MM-JJ] [--au AAAA-MM-JJ] [--ameliorer]

Aiguiser la lecture

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 ; --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 agent-tools/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 : aiguiser/<SEANCE>_<STATION>/, ci-dessous <séance>.

2. Le 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. 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 : agent-tools/ .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 : §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.
    • 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 : §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 : §4. Sinon, passage K + 1.

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 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) :

grep -oh '`[^`]*agent-tools/[^`]*`' events/*/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, sur le lot : python3 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 §4. Ne relance pas un agent plus d'une fois.

6. Bilan

<séance>/bilan.md :

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

Commits : sur `master`, depuis <base de la séance> (`git log --oneline <base de la séance>..HEAD`)

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

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), si le lot reste « à 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 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 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.

8. Réponse finale

En 5 lignes au plus : la base de la séance, le chemin du bilan, les passages gardés et annulés, les commandes des fiches en échec, les difficultés relevées et, avec --ameliorer, celles corrigées. Tout est sur master, rien n'est poussé : l'utilisateur annule ce qu'il ne garde pas par git revert.