Support-agent: /support skill answers a client's question, GIF tool, first case LENZSPITZE (draft)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-28 11:12:28 +01:00
1 parent 425acbbad4
commit 02f2bf5369
12 files changed
+505 -3

No files matched your search

+7
View File
@@ -820,3 +820,10 @@ Règles du journal :
- **Pourquoi** : demande de l'utilisateur : « tout comme pour /boucle, il n'y a pas de lots de 4 jours. Le lot est simplement la plage que je donne. »
- **Options écartées** : garder la découpe avec 4 jours par défaut (séance trop longue : jusqu'à 11 agents par lot).
- **Conséquence** : une plage longue donne un seul lot, lu d'un seul tenant ; pour en voir plusieurs, plusieurs séances.
## D-079 — 2026-10-28 — Support-agent : `/support` répond à la question d'un client
- **Statut** : active.
- **Décision** : un skill `/support <mail>` (`.claude/skills/support/SKILL.md`), lancé par l'utilisateur dans la conversation principale : il lit le mail du client et sa capture, les données locales de `data/` (station incertaine ou données absentes : il demande et s'arrête), répond à la question posée et à elle seule, et écrit un dossier par demande, `support/<AAAA-MM-JJ>_<STATION>_<sujet>/` : `demande.md`, `analyse.md` (faits traçables, puis « Hors question (pour Marc) »), `reponse.md` (le mail prêt à envoyer, cibles nommées par leur `sensor_name` de `data/`, heures en UTC) et, si utile, un GIF des images (`agents/diagnostic/outils/gif.py`, nouvel outil). L'utilisateur peaufine le mail avec l'agent ; quand il dit que c'est bon, le dossier passe « prêt à envoyer » et est commité. `support/` est versionné : une base de cas de support (usage à rediscuter). Design : `docs/superpowers/specs/2026-10-28-support-agent-design.md`.
- **Pourquoi** : demande de l'utilisateur : automatiser la réponse aux clients, qui posent une question précise sur leurs données (ex. « y a-t-il eu de l'activité sur les voies cette nuit ? »), souvent depuis leur propre plateforme ; « le rôle de l'agent est de répondre à la question du client et c'est tout » : d'autres systèmes détectent les anomalies. Le peaufinage demande que l'agent reste dans la conversation.
- **Options écartées** : un sous-agent comme `diagnostic` (il ne rend qu'un résultat, sans peaufinage dans la conversation) ; adapter l'agent de diagnostic (son rôle, trouver toutes les anomalies à l'aveugle, contredit « la question seule ») ; signaler au client les anomalies non demandées (elles vont dans `analyse.md`) ; `support/` hors de git.
- **Conséquence** : le skill renvoie au déroulé et aux règles de l'agent de diagnostic (§4 et §5 de `agents/diagnostic/instructions.md`) et aux outils de `lire-les-donnees`, sans les recopier ; `support/` contient des mails et images de clients, contrairement à la base de cas anonymisée.
@@ -0,0 +1,114 @@
# Support-agent Implementation Plan
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
**Goal :** un skill `/support` qui, dans la conversation, prend le mail d'un client, lit les données locales de la station, répond à sa question seulement, et produit un dossier de cas `support/…/` avec un mail prêt à envoyer et, si utile, un GIF des images.
**Architecture :** un skill (`.claude/skills/support/SKILL.md`), qui orchestre les outils de lecture existants (`agents/diagnostic/outils/`, skill `lire-les-donnees`, `categories.py`) et renvoie au déroulé de l'agent de diagnostic au lieu de le recopier ; un seul outil nouveau, `gif.py`, à côté des autres outils de lecture.
**Tech Stack :** Claude Code skill (markdown), Python 3.14, Pillow (déjà dans `.venv`, vient avec matplotlib).
**Spec :** `docs/superpowers/specs/2026-10-28-support-agent-design.md`
## Global Constraints
- Le mail répond à la question du client et à elle seule ; tout le reste va dans `analyse.md`, section « Hors question (pour Marc) ».
- Station incertaine, ou données de la plage absentes de `data/` : l'agent demande à Marc et s'arrête ; il ne pompe jamais.
- Cibles nommées dans le mail par leur `sensor_name` de `data/` (ex. `101B`) ; le nom de la plateforme du client en plus seulement si la correspondance est établie.
- Heures en UTC, dites ; heure locale entre parenthèses si la capture du client est visiblement en heure locale.
- Pas de fuite interne dans le mail : codes C-xxx, noms des détecteurs, autres stations, `SIM_CCID`, `ip`, vocabulaire de preuve anglais.
- Dossier `support/<AAAA-MM-JJ>_<STATION>_<sujet>/` : `demande.md`, `capture.png`, `analyse.md`, `reponse.md`, `*.gif`, `*.png` ; versionné dans git.
- Commit du dossier sur `master` seulement quand Marc dit que c'est bon (statut `prêt à envoyer`).
- Lecture seule ailleurs : l'agent n'écrit que dans son dossier `support/…/`.
- Pas de tests automatisés (D-008) : vérification par lancement sur le cas réel (LENZSPITZE, nuit du 26 au 27.10).
- Le code (gif.py, skill, docs) n'est commité qu'après validation de Marc (règle « commiter sur validation »).
## Review Focus
- Plage de plus de 150 images (ex. toute la période LENZSPITZE, ~290 images horaires) : le GIF en garde 150 au plus, à intervalle régulier, et le dit → Task 1, step 3.
- Plage sans aucune image (ex. LENZSPITZE les 24 et 25.10 n'ont pas de déplacements ; une plage hors des données) : `gif.py` sort avec un message clair, sans GIF vide → Task 1, step 4.
- Images à 3088×2064 : GIF réduit à `--largeur` (900 px par défaut), sinon des dizaines de Mo dans git → Task 1, step 2 (taille imprimée).
- Mail sans indice de station (cas de l'exemple) : le skill demande la station avant toute lecture → Task 2, step 2 (règle) et Task 3 (vérifiée sur le cas).
- Capture du client en heure locale : le mail dit UTC et l'heure locale entre parenthèses → Task 2 (règle) et Task 3 (relu sur le cas).
---
### Task 1 : l'outil GIF
**Files :**
- Create : `agents/diagnostic/outils/gif.py`
**Interfaces :**
- Consumes : `donnees.trouver(dossier) -> dict` (clé `"images"` : chemins triés), `donnees.heure_image(chemin) -> datetime | None`, `donnees.instant(texte) -> datetime`, `donnees.iso(t) -> str` (`agents/diagnostic/outils/donnees.py`).
- Produces : la commande `.venv/bin/python agents/diagnostic/outils/gif.py <dossier> --debut T --fin T [--largeur 900] [--duree 700] [--max 150] [--sortie D]` ; imprime une ligne par image retenue (heure ISO UTC), puis `GIF : <chemin>` et sa taille en Mo. Fichier écrit : `<sortie>/images_<AAAAMMJJTHHMMZ>_<AAAAMMJJTHHMMZ>.gif` ; `--sortie` par défaut `out/diagnostic/` (comme `vignettes.py`).
- [ ] **Step 1 : écrire `gif.py`** dans le style de `vignettes.py` (docstring d'usage en tête, `argparse` avec `description=__doc__`, `RACINE`, import de `donnees`). Images de `trouver(dossier)["images"]` dont `heure_image` est entre `--debut` et `--fin` inclus (les autres ignorées) ; au-delà de `--max`, garder `--max` images à intervalle régulier (indices `round(i * (n - 1) / (max - 1))`) et imprimer « N images sur M gardées » ; chaque image réduite à `--largeur` px (proportions gardées, `Image.LANCZOS`), convertie en RGB ; texte `AAAA-MM-JJ HH:MM UTC` en bas à droite, blanc sur un rectangle noir, police `ImageFont.load_default(size=…)` proportionnelle à la largeur ; `save(..., save_all=True, append_images=…, duration=--duree, loop=0)`.
- [ ] **Step 2 : lancer sur la nuit du cas réel**
Run : `.venv/bin/python agents/diagnostic/outils/gif.py data/LENZSPITZE/ --debut 2026-10-26T18:00Z --fin 2026-10-27T08:00Z`
Expected : une quinzaine d'heures imprimées de 2026-10-26T18:00Z à 2026-10-27T08:00Z, `GIF : …/out/diagnostic/images_20261026T1800Z_20261027T0800Z.gif`, taille de quelques Mo au plus. Regarder 2 ou 3 images sources avec Read pour vérifier que l'heure incrustée correspond au nom de fichier.
- [ ] **Step 3 : vérifier la limite de 150**
Run : `.venv/bin/python agents/diagnostic/outils/gif.py data/LENZSPITZE/ --debut 2026-10-16T00:00Z --fin 2026-10-27T23:59Z`
Expected : « 150 images sur <M> gardées » avec M > 150, première heure 2026-10-16…, dernière 2026-10-27T23:00Z.
- [ ] **Step 4 : vérifier la plage vide**
Run : `.venv/bin/python agents/diagnostic/outils/gif.py data/LENZSPITZE/ --debut 2026-11-10T00:00Z --fin 2026-11-11T00:00Z`
Expected : sortie non nulle, message « Aucune image entre 2026-11-10T00:00Z et 2026-11-11T00:00Z dans data/LENZSPITZE/. » (avec la première et la dernière heure disponibles), aucun fichier écrit.
### Task 2 : le skill `/support`
**Files :**
- Create : `.claude/skills/support/SKILL.md`
**Interfaces :**
- Consumes : `gif.py` (Task 1) ; les outils de `lire-les-donnees` ; `python3 vues-deplacements/detectors/categories.py <dossier>` ; `agents/diagnostic/instructions.md` §4 (étapes 4, 5, 7) et §5 (règles).
- Produces : la commande `/support <mail>` (capture collée dans le même message).
- [ ] **Step 1 : frontmatter**
```yaml
---
name: support
description: Répondre à la question d'un client sur un système AIMsight — lit le mail (et sa capture), les données locales de data/, répond à la question seule, et rédige un mail prêt à envoyer, avec un GIF des images si utile, dans un dossier de cas support/. Lancé par l'utilisateur, avec /support <mail>.
disable-model-invocation: true
argument-hint: "<mail du client> (capture collée dans le même message)"
---
```
- [ ] **Step 2 : corps du skill**, en français, court (≈ 100 lignes), dans le style de `nouveau-cas` et `revue-cas`, renvois plutôt que recopies. Sections et ce que chacune fixe :
1. **Ton rôle** : répondre à la question du client et à elle seule ; d'autres systèmes détectent les anomalies ; tu restes dans la conversation pour le peaufinage ; lecture seule sauf ton dossier. Commandes en plus de celles de `lire-les-donnees` : `categories.py`, `gif.py`, `mkdir`, `cp` (la capture), `date`, et `git add`/`git commit` du seul dossier du cas, à la fin.
2. **Comprendre la demande** : station, plage, question reformulée, séries concernées (spec §3.2 étape 1). Station non certaine → demander à Marc, en un seul message avec tout ce qui manque (station, plage si ambiguë), et s'arrêter. La plateforme du client peut nommer et traiter autrement les mêmes données ; son axe peut être en heure locale.
3. **Vérifier les données** : `inventaire.py data/<STATION>/ --debut T --fin T` ; déplacements ou images absents de la plage → le dire à Marc et s'arrêter, sans pomper.
4. **Le dossier** : `support/<date -u +%F>_<STATION>_<sujet>/` ; `demande.md` (mail tel quel, `capture.png` copiée par `cp` depuis le chemin `[Image: source: …]` du message, sinon description ; station et comment établie ; plage ; question ; `Statut : brouillon`).
5. **Enquêter** : lire `lire-les-donnees` puis suivre `agents/diagnostic/instructions.md` §4 étapes 2, 4, 5 et 7 (repérage avec `categories.py`, faits, cas connus après les faits, réfutation) et §5 (règles, vocabulaire, asymétrie), **limitées à la plage et à la question** ; figures avec `--sortie <dossier du cas>` ; images entières par Read aux moments des perturbations, plus une avant et une après ; dire ce que la cadence des images ne permet pas d'établir.
6. **Écrire** : `analyse.md` (faits traçables avec leurs commandes, cas connu, réfutation, non établi, puis `## Hors question (pour Marc)`, quelques lignes au plus) ; `reponse.md` (objet, corps, pièces jointes) selon la spec §3.3 : réponse d'abord en 1-2 phrases, puis les éléments repris par le client, honnête sur le non établi, cibles par `sensor_name`, UTC dit, langue et ton du client, signé du prénom par lequel il s'adresse au support, vocabulaire de preuve traduit en mots simples, aucune fuite interne (liste des Global Constraints) ; GIF par `gif.py --sortie <dossier du cas>` seulement s'il prouve mieux qu'une phrase, quelques images vérifiées par Read avant.
7. **Montrer** : le mail en entier dans la réponse, le GIF par `SendUserFile` (sinon son chemin), et 2-3 lignes « hors question ».
8. **Peaufiner** : chaque retour de Marc → modifier `reponse.md` (et `analyse.md` ou le GIF si le fond change), remontrer le mail ; quand Marc dit que c'est bon : `Statut : prêt à envoyer`, puis `git add support/<dossier> && git commit -m "Support : <STATION>, <sujet>"`.
- [ ] **Step 3 : relire le skill face aux Global Constraints** : chaque ligne des Global Constraints se retrouve dans une section ; corriger sinon.
### Task 3 : le cas réel, puis la doc
**Files :**
- Create : `support/2026-10-28_LENZSPITZE_<sujet>/` (par le skill)
- Modify : `docs/decisions.md` (entrée D-079 à la fin), `CLAUDE.md` (« État et prochaine étape » : une puce Support-agent ; « Carte du dépôt » : `support/` et `.claude/skills/support/` ; « Commandes » : la ligne `gif.py`)
- [ ] **Step 1 : lancer `/support` sur le mail de l'exemple** (spec §1), capture `/tmp/claude-1000/-home-maxime-Support-Agent/f5dc4984-b923-4955-9c4e-a3a49ed7f862/images/1.png`, en suivant le skill à la lettre.
Expected : l'agent demande la station avant toute lecture ; après « LENZSPITZE », le dossier contient `demande.md`, `capture.png`, `analyse.md`, `reponse.md` et, si utile, un GIF de la nuit du 26 au 27.10 ; le mail répond à « activité sur les voies ? », cite les cibles par `sensor_name`, dit UTC, dit ce que des images horaires ne permettent pas d'établir, et ne contient rien hors question.
- [ ] **Step 2 : peaufinage** : au moins un retour de Marc appliqué par l'agent ; noter dans le skill toute consigne que ce retour révèle comme manquante.
- [ ] **Step 3 : doc** : entrée D-079 (format ADR allégé du fichier : statut, décision, pourquoi, options écartées — sous-agent comme `diagnostic`, adaptation de l'agent de diagnostic —, conséquence) ; mises à jour de `CLAUDE.md` ci-dessus, sans dépasser 200 lignes.
- [ ] **Step 4 : commit, sur validation de Marc**
```bash
git add agents/diagnostic/outils/gif.py .claude/skills/support/ docs/superpowers/specs/2026-10-28-support-agent-design.md docs/superpowers/plans/2026-10-28-support-agent.md docs/decisions.md CLAUDE.md
git commit -m "Support-agent: /support skill answers a client's question, with a GIF tool"
```
Le dossier `support/…` est commité par le skill lui-même quand Marc dit que c'est bon (Task 2, section 8).
@@ -0,0 +1,136 @@
# Support-agent : répondre à la question d'un client
Design du 2026-10-28, issu d'une conversation avec l'utilisateur (Marc, l'expert du projet).
## 1. Intention
Un client écrit au support à propos d'un de ses systèmes, souvent de façon informelle et avec une capture d'écran. Exemple réel (2026-10-28, station LENZSPITZE) :
> Salut Marc, […] je remarque que cette nuit, il y a eu de grosses perturbations. Pourrais-tu regarder sur les images s'il y a eu de l'activité sur les voies ? Cela permettrait d'expliquer dans mon rapport.
Capture jointe : un graphique de *sa* plateforme (« Flèche Verticale relative - Comparaison Théo - VS - Camera - Installation 2 »), séries `FlV_tachy9002_*` (théodolite, plates) et `PfV_670_2026_*_cam` (caméra, pics verticaux), du 26.10 au 27.10, les perturbations marquées au feutre.
Aujourd'hui, Marc va lui-même chercher les données et les images, puis rédige la réponse. Le Support-agent automatise ce travail : à partir du message du client et des données téléchargées localement, il produit un diagnostic **ciblé sur la question** et une **réponse prête à envoyer** (un mail), avec un **GIF** des images quand c'est utile. Marc la relit et la peaufine avec l'agent avant de l'envoyer lui-même.
Certains clients ont leur propre plateforme qui intègre les données AIMsight : ce sont les mêmes données, mais pas forcément traitées de la même façon (noms des séries, calculs, axes). La capture du client peut donc ne pas ressembler aux exports de `data/`.
## 2. Objectifs, non-objectifs, anti-objectifs
**Objectifs**
- Répondre à la question posée par le client, et seulement à elle.
- Une réponse juste et prouvée : chaque affirmation du mail repose sur un fait vu dans les données ou les images.
- Un dossier par demande, qui documente le cas de support et sert de brouillon pendant le peaufinage.
- Un GIF des images quand il prouve mieux qu'une phrase (ex. un train devant les cibles, de la buée qui se lève).
**Non-objectifs**
- Détecter les anomalies de la station : d'autres systèmes le font (détecteurs du journal, agent de diagnostic, notifications).
- Envoyer le mail : Marc l'envoie lui-même.
- Télécharger des données : le pompage (`extraction/pomper.py`) reste lancé par l'utilisateur seul.
- Ajouter un cas à la base de cas (`agents/diagnostic/cas/`) : cela reste `/nouveau-cas`, lancé par l'utilisateur.
- Modifier les détecteurs, les outils de lecture ou la connaissance du projet.
**Anti-objectifs** : un échec, même si l'agent tourne.
- Le mail parle d'autre chose que de la question : une cible qui dérive, des références instables, un problème d'énergie. Ces constats vont dans la note pour Marc, jamais dans le mail.
- Le mail affirme une cause que les images ne montrent pas, par exemple « un train est passé » alors qu'aucune image ne le montre.
- Le mail laisse fuir de l'interne : codes de cas (C-xxx), noms des détecteurs, autres stations, identifiants (`SIM_CCID`, `ip`), vocabulaire de preuve en anglais.
## 3. Le fonctionnement
### 3.1 Un skill dans la conversation, pas un sous-agent
L'agent doit rester dans la conversation pour le peaufinage : Marc lit le résultat, fait un retour, l'agent corrige, et ainsi de suite. C'est donc un **skill `/support`** (`.claude/skills/support/SKILL.md`), qui s'exécute dans la conversation principale. Ce n'est pas un sous-agent comme `diagnostic`, qui travaille à part et ne rend qu'un résultat final. Décidé par l'utilisateur.
Appel : `/support <mail du client>`, la capture d'écran collée dans le même message si elle existe.
### 3.2 Déroulé
1. **Comprendre la demande** : à partir du mail et de la capture, l'agent tire :
- **la station** : souvent impossible à déduire (la plateforme du client a ses propres noms). L'agent **demande à Marc** dès qu'il n'en est pas sûr. Une correspondance claire entre un nom du mail ou de la capture et un dossier de `data/` lui suffit, mais il la cite.
- **la plage de temps** : d'après le mail (« cette nuit ») et l'axe de la capture. Si elle reste ambiguë, il demande. Attention : l'axe de la plateforme du client peut être en heure locale.
- **la question** : reformulée en une phrase (ex. « Les images montrent-elles de l'activité sur les voies pendant les perturbations de la nuit du 26 au 27.10 ? »).
- **les séries concernées** : la correspondance entre les noms de la plateforme du client et les capteurs de l'export, si l'agent peut l'établir. Sinon, il travaille sur tous les capteurs et le note. **Dans le mail, les cibles portent leur nom dans `data/`** (`sensor_name` de l'export, ex. `101B`), décision de l'utilisateur ; le nom de la plateforme du client s'ajoute seulement si la correspondance est établie.
2. **Vérifier les données** : `inventaire.py` sur `data/<STATION>/` pour la plage. Si les déplacements ou les images de la plage manquent, l'agent **le dit à Marc et s'arrête** (il ne pompe rien lui-même). Exemple : LENZSPITZE n'a pas de déplacements les 24 et 25.10.
3. **Créer le dossier** du cas (§4) et y écrire `demande.md`.
4. **Enquêter sur la question** avec les outils existants (§5) :
- situer les perturbations : quand, quels capteurs (détecteurs `categories.py` comme premier repérage, puis `graphique.py`, `plages.py`, `ensemble.py`) ;
- regarder les images à ces moments-là, plus une image avant et une après pour comparer (images entières pour la scène, `vignettes.py` pour les cibles) ;
- confronter aux cas de la base, après les faits, comme le fait l'agent de diagnostic (§4, étape 5 de `agents/diagnostic/instructions.md`) ;
- chercher le fait qui contredirait la réponse envisagée (la réfutation de l'agent de diagnostic, étape 7).
5. **Écrire** `analyse.md`, puis `reponse.md`, et faire le GIF s'il sert la réponse (§6).
6. **Montrer** à Marc, dans la conversation, le mail en entier, le GIF (`SendUserFile` dans l'application de bureau ; ailleurs, son chemin, choix du builder) et, en deux ou trois lignes, ce qu'il a noté hors question.
7. **Peaufiner** : Marc fait ses retours dans la conversation, et l'agent modifie `reponse.md` (et `analyse.md` ou le GIF si le fond change). Cela continue jusqu'à ce que Marc dise que c'est bon. L'agent met alors le statut de `demande.md` à « prêt à envoyer » et commite le dossier sur `master` : ce « c'est bon » vaut validation (choix du builder, conforme à la règle « commiter sur validation »).
### 3.3 Ce que le mail dit et ne dit pas
- Il répond d'abord à la question, en une ou deux phrases (« Oui, les images de 01:00 et 02:00 UTC montrent… » / « Non, rien sur les voies, en revanche… » / « Les images ne permettent pas de le dire, parce que… »).
- Puis les quelques éléments qui soutiennent la réponse et que le client peut reprendre dans son rapport : heures, cibles touchées, ce que montrent les images, le GIF en pièce jointe.
- Il est **honnête sur ce que les données ne permettent pas d'établir**. Exemple typique : des images horaires peuvent manquer un train qui passe en une minute. L'absence de train sur les images n'est donc pas la preuve qu'aucun train n'est passé.
- Il reste dans le cadre de la question. Seule exception : un fait qui change la réponse elle-même, par exemple « ce n'est pas un mouvement de l'ouvrage, le théodolite ne bouge pas ».
- Langue et ton du client : ici, français et tutoiement. Le mail est signé du prénom par lequel le client s'adresse au support (ici « Marc »).
- Heures en UTC, dites explicitement. Si la capture du client montre visiblement l'heure locale, le mail donne aussi l'heure locale entre parenthèses.
- Le vocabulaire de preuve du projet (`confirmed`, `consistent with`…) reste dans `analyse.md`. Le mail le traduit en mots simples (« on voit clairement », « c'est compatible avec », « on ne peut pas l'affirmer »).
## 4. Le dossier du cas
`support/<AAAA-MM-JJ>_<STATION>_<sujet>/` à la racine du dépôt (date du jour en UTC, sujet en 2 ou 3 mots, ex. `support/2026-10-28_LENZSPITZE_activite-voies/`). Il contient :
| Fichier | Pour qui | Contenu |
|---|---|---|
| `demande.md` | Marc, la documentation | Le mail du client tel quel ; la capture, copiée dans le dossier (`capture.png`) depuis le chemin que Claude Code donne pour une image collée (`[Image: source: …/images/N.png]`) ; sans chemin, une description de la capture (choix du builder) ; la station et comment elle a été établie (déduite ou donnée par Marc) ; la plage et la question reformulées ; le statut (`brouillon` / `prêt à envoyer`) |
| `analyse.md` | Marc, la documentation | Les faits qui fondent la réponse, traçables (commandes, heures en UTC, capteurs), le cas connu s'il y en a un, la réfutation, ce qui reste non établi ; puis **« Hors question (pour Marc) »** : ce que l'agent a vu sans que le client l'ait demandé, quelques lignes au plus |
| `reponse.md` | le client | Le mail prêt à copier : objet, corps, pièces jointes |
| `*.gif`, `*.png` | le client ou Marc | Le GIF et les figures qui servent la réponse ou l'analyse |
`support/` est **versionné dans git** (décision de l'utilisateur) : les dossiers forment peu à peu une base de cas de support, utile pour l'historique (son usage sera rediscuté). Il contient donc des mails et des images de clients, contrairement à `data/` (D-065) et à la base de cas anonymisée.
## 5. Ce qu'il réutilise
Tout ce que le projet a déjà construit pour lire les déplacements :
- le skill `lire-les-donnees` (`.claude/skills/lire-les-donnees/SKILL.md`) : ses outils (`agents/diagnostic/outils/`) et sa méthode de lecture ;
- les détecteurs du journal du matin : `python3 vues-deplacements/detectors/categories.py <dossier>` (catégories : visibilité, sauts, thermique, turbulence…), comme premier repérage ;
- la connaissance du projet : `docs/domaine/`, `docs/displacement/` (dont `domaine/carte-des-evenements.md`), la doc AIMsight (`docs/aimsight/`, par section) ;
- la base de cas `agents/diagnostic/cas/` (`INDEX.md`, puis les fiches) ;
- le déroulé et les règles de l'agent de diagnostic (`agents/diagnostic/instructions.md`, §4 et §5) : faits, cas connus après les faits, réfutation, vocabulaire de preuve, asymétrie. Le skill les cite au lieu de les recopier.
À la différence de l'agent de diagnostic, il n'est pas « à l'aveugle » : il tourne dans la conversation principale, avec `CLAUDE.md` chargé, et peut lire ce qui l'aide.
## 6. Ce qu'il ajoute : l'outil GIF
`agents/diagnostic/outils/gif.py`, à côté des autres outils de lecture, avec Pillow (déjà dans `.venv`, il vient avec matplotlib) :
```
.venv/bin/python agents/diagnostic/outils/gif.py <dossier> --debut T --fin T [--largeur 900] [--duree 700] [--sortie D]
```
- Il prend les images de `<dossier>/images/` entre `--debut` et `--fin` (le nom des fichiers donne l'heure en UTC, ex. `20261027T2300Z_10222630.jpg`), dans l'ordre, et les réduit à `--largeur` px.
- Il écrit la date et l'heure UTC en bas à droite de chaque image, comme le bouton ⤓ GIF de la page des détecteurs.
- Il garde 150 images au plus, prises à intervalle régulier si la plage en compte davantage.
- Il imprime le chemin du GIF et la liste des heures retenues. L'agent regarde quelques images avec Read avant de le joindre : un GIF que l'agent n'a pas vérifié ne va pas au client.
Cadence observée : LENZSPITZE a une image par heure, donc une nuit fait une dizaine d'images.
## 7. Contraintes
- Lecture seule sur les stations, les données et le reste du dépôt : l'agent n'écrit que dans son dossier `support/…/`.
- Règles non négociables du projet : traçabilité, heures en UTC, ne pas confondre « pas de donnée » et « station arrêtée », pas de chiffre sans source.
- Ne pas recopier d'identifiants (`SIM_CCID`, `ip`) dans le dossier.
- Pas de LLM ajouté au code : seul le skill (Claude Code) raisonne, et les outils restent des scripts.
- Processus léger (phase expérimentale) : pas de tests automatisés (D-008). La vérification se fait sur le cas réel (§8).
## 8. Vérification
Le cas de l'exemple : `/support` avec le mail et la capture ci-dessus, la station LENZSPITZE donnée par Marc quand l'agent la demande. Attendu : le dossier `support/2026-10-28_LENZSPITZE_…/` complet, un mail qui répond à « y a-t-il eu de l'activité sur les voies ? » pour la nuit du 26 au 27.10 et dit ce que les images horaires ne permettent pas d'établir, un GIF de la nuit, puis au moins une boucle de peaufinage sur un retour de Marc.
## 9. Laissé au builder
- La rédaction exacte du skill (sections, longueur), dans le style des autres skills du projet (français, court, renvois plutôt que recopies).
- La police et la taille du texte du GIF, le format exact des fichiers markdown.
- La mise à jour de `CLAUDE.md` (état, carte du dépôt, commandes) et une entrée dans `docs/decisions.md` (D-079).
## Annexe : pistes à revoir (pas dans le socle)
- L'usage de la base de cas de support (`support/`) : à rediscuter avec l'utilisateur.
- Recadrer le GIF sur une zone ou sur des capteurs (comme `vignettes.py`), si l'image entière ne suffit pas.
- Lire directement un mail exporté (`.eml`) plutôt qu'un texte collé.
- Une table des correspondances client → station (noms de plateforme, « Installation 2 »), si les mêmes clients reviennent.
- Proposer à Marc de transformer un cas de support en cas de la base (`/nouveau-cas`), quand l'explication est validée.