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

+101
View File
@@ -0,0 +1,101 @@
---
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)"
---
# Répondre à un client
Un client écrit au support à propos d'un de ses systèmes, souvent avec une capture de sa plateforme. Tu réponds à **sa question, et seulement à elle** : d'autres systèmes détectent les anomalies (détecteurs du journal, agent de diagnostic, notifications). Tu produis un mail prêt à envoyer, que Marc relit et peaufine avec toi dans cette conversation avant de l'envoyer lui-même. Design : `docs/superpowers/specs/2026-10-28-support-agent-design.md`.
Lecture seule : tu n'écris que dans le dossier du cas (§3). Tu ne télécharges aucune donnée, tu n'ajoutes rien à la base de cas, tu ne modifies ni détecteur ni outil.
Commandes : celles de `.claude/skills/lire-les-donnees/SKILL.md` (mêmes conventions : une commande par appel, depuis la racine du dépôt), plus `python3 vues-deplacements/detectors/categories.py <dossier>`, `gif.py` (§4), `mkdir`, `cp` (la capture), `date`, et à la fin `git add`/`git commit` du seul dossier du cas.
## 1. Comprendre la demande
Tire du mail et de la capture :
- **la station** : la plateforme du client a souvent ses propres noms (séries, « Installation 2 ») ; ce sont les mêmes données qu'AIMsight, pas forcément traitées de la même façon. Un nom du mail ou de la capture qui désigne sans doute un dossier de `data/` suffit : cite-le. Sinon, **demande à Marc** ;
- **la plage** : d'après le mail (« cette nuit ») et l'axe de la capture, qui peut être en heure locale ;
- **la question**, reformulée en une phrase ;
- **les séries concernées** : la correspondance entre les noms du client et les `sensor_name` de l'export, si tu peux l'établir (positions, nombre de cibles) ; sinon, tous les capteurs, et tu le notes.
S'il te manque la station, ou une plage qui reste ambiguë, demande-le à Marc **en un seul message**, et arrête-toi là jusqu'à sa réponse.
## 2. Vérifier les données
`python3 agents/diagnostic/outils/inventaire.py data/<STATION>/ --debut T --fin T`. S'il manque les déplacements ou les images de la plage, dis à Marc ce qui manque (dates, type) et arrête-toi : c'est lui qui pompe (`run.md`).
## 3. Le dossier du cas
`support/<AAAA-MM-JJ>_<STATION>_<sujet>/` (date du jour, `date -u +%F` ; sujet en 2-3 mots, ex. `activite-voies`). Écris d'abord `demande.md` :
```markdown
# <STATION> : <sujet>
- **Statut** : brouillon
- **Reçu le** : AAAA-MM-JJ
- **Station** : <STATION>, <déduite de … | donnée par Marc>
- **Plage** : <début> → <fin> UTC (<d'où elle vient : mail, axe de la capture>)
- **Question** : <la question reformulée>
- **Séries** : <correspondance client → sensor_name, ou « non établie »>
## Mail du client
<le mail, tel quel>
![Capture du client](capture.png)
```
La capture : une image collée apparaît dans le message comme `[Image: source: <chemin>]` ; `cp <chemin> support/<dossier>/capture.png`. Sans chemin, remplace la ligne par une description de la capture.
## 4. Enquêter sur la question
Lis `.claude/skills/lire-les-donnees/SKILL.md`, puis suis `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), **limités à la plage et à ce qu'il faut pour répondre**. Figures avec `--sortie support/<dossier>/`.
- Situe ce dont parle le client : quand, quels capteurs, cibles ou références, et ce que font les autres capteurs (ex. une autre mesure du client, ici le théodolite, qui reste plate).
- Regarde les **images entières** (Read) aux moments en question, plus une avant et une après ; `vignettes.py` pour les cibles touchées et un témoin.
- Dis ce que la cadence des images ne permet pas d'établir : des images horaires peuvent manquer un train qui passe en une minute ; une image sans train ne prouve pas qu'aucun train n'est passé.
- Le GIF, s'il prouve mieux qu'une phrase (un passage, de la buée qui se lève) : `.venv/bin/python agents/diagnostic/outils/gif.py data/<STATION>/ --debut T --fin T --sortie support/<dossier>/` (720 px, 64 teintes, heure UTC en bas à droite ; ~3 Mo par nuit d'images horaires). Garde-le sous ~5 Mo (pièce jointe) : resserre la plage ou `--largeur`. Regarde quelques-unes de ses images sources avec Read avant de le joindre.
## 5. Écrire
**`analyse.md`**, pour Marc et la documentation : la question ; les faits qui fondent la réponse (heures UTC, capteurs, ce que montrent les images), chacun avec sa commande ; le cas connu s'il y en a un ; la réfutation ; ce qui reste non établi ; les figures. Vocabulaire de preuve du projet (`confirmed` … `not observed`). Puis :
```markdown
## Hors question (pour Marc)
- <ce que tu as vu sans que le client l'ait demandé ; quelques lignes au plus, ou « rien »>
```
**`reponse.md`**, le mail au client :
```markdown
**Objet** : Re: <objet ou sujet>
<corps>
**Pièces jointes** : <fichier.gif — ce qu'on y voit> (ou « aucune »)
```
Le corps :
- **d'abord la réponse**, en une ou deux phrases : oui, non, ou les images ne permettent pas de le dire, et pourquoi ;
- puis les quelques éléments que le client peut reprendre dans son rapport : heures, cibles, ce que montrent les images, le GIF joint ;
- honnête sur ce qui n'est pas établi, en mots simples (« on voit clairement », « c'est compatible avec », « on ne peut pas l'affirmer ») ;
- **rien hors de la question** ; seule exception, un fait qui change la réponse elle-même (« ce n'est pas un mouvement de l'ouvrage : le théodolite ne bouge pas ») ;
- les cibles par leur `sensor_name` de `data/` (ex. `101B`), suivi du nom du client entre parenthèses seulement si la correspondance est établie ;
- heures en UTC, dites ; l'heure locale entre parenthèses si la capture du client est visiblement en heure locale ;
- dans la langue et sur le ton du client (tutoiement s'il tutoie), signé du prénom par lequel il s'adresse au support ;
- jamais d'interne : codes de cas (C-xxx), noms des détecteurs ou des outils, autres stations, identifiants (`SIM_CCID`, `ip`), vocabulaire de preuve en anglais.
## 6. Montrer
Dans ta réponse : le mail en entier, tel qu'il est dans `reponse.md` ; le GIF par `SendUserFile` (sans cet outil : son chemin) ; en 2-3 lignes, ce que tu as noté hors question. Puis attends le retour de Marc.
## 7. Peaufiner
À chaque retour de Marc, modifie `reponse.md` (et `analyse.md` ou le GIF si le fond change), puis remontre le mail. Quand Marc dit que c'est bon : `Statut : prêt à envoyer` dans `demande.md`, puis
```bash
git add support/<dossier>
git commit -m "Support: <STATION>, <sujet>"
```
+3 -3
View File
@@ -13,6 +13,7 @@ Agent de diagnostic proactif pour **AIMsight**, un système de surveillance opti
- **Agents LLM côté serveur (D-027)** : rapport exploratoire seulement, rien n'est construit.
- **Séries optiques (D-044)** : détecter les événements externes (occlusion, pluie, turbulence) dans les déplacements et produire une courbe corrigée, la brute gardée ; cadrage (`docs/displacement/cadrage.md`) ; données reçues (D-045) : PS des Coudres, export 15 min en UTC sur 5,5 jours, sans événement annoté (buée probable le matin), et 24 images horaires de la caméra, puis NORDEND, WILDSTRUBEL, CLARIDEN et NIEDERHORN, chacune devenue un cas de la base ; CLARIDEN est l'incident de Barcelone de la doc AIMsight, où l'expert voit un mouvement réel de l'ouvrage, la doc une instabilité des références (`docs/displacement/domaine/incident-de-barcelone.md`) ; deux rapports d'analyse AIMsight (murs GN-1.472 et GN-5.054), causes des déplacements apparents selon l'expert, sans leurs données ; exploration confiée d'abord à l'agent de diagnostic (D-046), chaîne analytique au second plan.
- **Agent de diagnostic (D-046, révisé par D-058)** : pilote de l'enquête à la demande (D-042) dans Claude Code, appelé pour un cas précis que les détecteurs n'expliquent pas ; plus à l'aveugle : il lit la connaissance du projet et part des événements des détecteurs du journal, sans les juger, et n'ajoute aucun cas ; sous-agent `diagnostic` (`.claude/agents/diagnostic.md`, dossier `agents/diagnostic/`, spec `docs/agents/agent-diagnostic.md`) ; un dossier de `data/` et une question facultative donnent un rapport court dans `agents/diagnostic/rapports/<date>_<STATION>/` : verdict, anomalies seules, chacune montrée par un graphique et des vignettes des images (D-047) ; déplacements et images seulement ; cas de référence du spécialiste : PS des Coudres est sain, seule anomalie les pics d'erreur de `REF_G` et `REF_D` ; base de cas validés (D-048, `agents/diagnostic/cas/`), lue après les faits : cinq cas, C-001 à C-005 (l'index `agents/diagnostic/cas/INDEX.md` en est le registre), chaque cas avec ses données, la station au numéro du cas et les capteurs codés (D-049, D-050, skill `anonymiser-cas`), une fiche courte sur ce seul cas, lisible d'abord par un humain (D-051) ; un cas n'y entre que par `/nouveau-cas`, lancé par l'utilisateur, ou par le builder de la boucle (D-057), puis revu par l'utilisateur avec `/revue-cas` (D-075, agent `revue`). Ses outils et leur mode d'emploi, partagés avec l'analyste de la boucle : skill `lire-les-donnees`, aiguisé par `/aiguiser` (D-059, lancé par l'utilisateur seul ; spec `vues-deplacements/contexte/aiguiser-la-lecture.md`). L'enquête par API (D-042) reste un document.
- **Support-agent (D-079)** : skill `/support <mail>`, lancé par l'utilisateur, dans la conversation : répond à la question d'un client sur un système, et à elle seule (le reste en note pour l'utilisateur), à partir des données locales de `data/` (station ou données absentes : il demande) ; un dossier par demande, `support/<date>_<STATION>_<sujet>/` (`demande.md`, `analyse.md`, `reponse.md`, le mail prêt à envoyer, GIF des images par `agents/diagnostic/outils/gif.py`), peaufiné avec l'utilisateur puis commité ; versionné, base de cas de support (usage à rediscuter) ; premier cas : LENZSPITZE, nuit du 26 au 27.10 ; design `docs/superpowers/specs/2026-10-28-support-agent-design.md`.
- **Storage (D-030, D-034, D-035)** : jeu de travail WEISSHORN seul (NORDEND n'a pas les mesures de `/data`) ; `DAILY_STORAGE_STATE` et `DAYS_UNTIL_STORAGE_FULL` en prototype, sans cas de l'expert ; couleur du jour codée (`src/storage/day_color.py`, matrice état × horizon `docs/storage/matrice-etat-horizon.drawio`, la pire des deux) ; seuils arbitraires (20 % / 10 % libres, 60 / 14 jours) ; questions en suspens dans `docs/storage/domaine/questions-pour-l-expert.md` ; livré en prototype (D-039) : figure du site `src/storage/final.py`, bloc de la vue client, notification support, guide `docs/storage/guide/`.
- **Cellular (D-030 à D-032, D-037), en pause en attendant le spécialiste** : WEISSHORN (mise en service le 19/08, puis quelques incidents isolés) et NORDEND (109 jours, 11 coupures de la liaison) explorés ; `DAILY_LINK_STATE` et `DAILY_SIGNAL_STATE` en prototype, sans cas de l'expert ; deux corrections de `DAILY_LINK_STATE` retenues sur le principe mais non codées ; couleur du jour codée (`src/cellular/day_color.py`, matrice lien × signal `docs/cellular/matrice-lien-signal.drawio` : Red si des envois manquent et que le signal n'est pas mesuré 20 h sur 24) ; livré en prototype avant les réponses du spécialiste (D-039) : figure du site `src/cellular/final.py`, bloc de la vue client, notification support, guide `docs/cellular/guide/`. Reprise : `docs/cellular/domaine/questions-pour-l-expert.md`.
- **Temperature (D-040)** : jeux de travail WEISSHORN et NORDEND (VERMONT n'a pas le GPU) ; `DAILY_GPU_TEMPERATURE_LIMIT` en prototype, sans cas de l'expert : une moyenne horaire du GPU ≥ 97,5 °C (limite du Jetson Nano, carte supposée) dans les 24 dernières heures ; couleur du jour codée (`src/temperature/day_color.py` : Red si atteinte, sinon Green, pas d'orange) ; tous les jours Green (maximum 57,2 °C) ; livré en prototype (D-041) : figure du site `src/temperature/final.py`, bloc de la vue client, notification support, guide `docs/temperature/guide/`. Constats, pistes et questions dans `docs/temperature/domaine/point-de-depart.md`.
@@ -145,10 +146,9 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .
- `storage/` : calcul embarquable `storage_state.py`, `days_until_full.py`, `day_color.py` (D-035) ; plotly : `final.py` (figure du site, D-039), `all_analyses.py` (D-034).
- `temperature/` : calcul embarquable `gpu_temperature_limit.py`, `day_color.py` ; plotly : `final.py` (figure du site, D-041), `all_analyses.py` (D-040).
- `maquettes/` : maquettes du site en HTML sur données réelles (D-022), Figma seulement sur demande. Un script remplit son gabarit HTML : `user/summary.py` + `summary_template.html` (client, une page par station, un bloc par domaine), `support/home.py` + `home_template.html` (support). Les deux parcourent une liste de domaines (`DOMAINS`, D-039).
- `.claude/` : `rules/analyses.md` (se charge seule, voir « Analyses »), `agents/diagnostic.md` (point d'entrée de l'agent de diagnostic, D-046), `skills/nouvelle-analyse/` (procédure et modèle de fiche), `skills/nouveau-domaine/` (procédure pour un nouveau domaine), `skills/nouveau-cas/` (ajouter un cas à la base de l'agent de diagnostic, lancé par l'utilisateur seul), `skills/revue-cas/` avec l'agent `revue` (l'utilisateur valide, corrige ou rejette les cas appris par la boucle, D-075), `skills/anonymiser-cas/` (données d'un cas copiées dans son dossier, noms en codes, registre des codes, D-049, D-050), `skills/boucle/` et `skills/critiquer-lot/` avec les agents `analyste`, `upgrader`, `validateur`, `builder` (boucle automatique, D-057), `skills/lire-les-donnees/` (outils de lecture et leur mode d'emploi) et `skills/aiguiser/` avec les agents `lecteur`, `correcteur`, `optimiseur` (D-059), `agents/releveur.md` (difficultés des processus automatiques, D-060), `agents/ameliorateur.md` (les corrige en fin de `/boucle --ameliorer` ou `/aiguiser --ameliorer`, D-071, D-076), `settings.json` (lecture de `.env` interdite). Schémas de ces processus (agents, flux de données) : `docs/agents/pipelines-ia.drawio`, une page par processus.
- `.claude/` : `rules/analyses.md` (se charge seule, voir « Analyses »), `agents/diagnostic.md` (point d'entrée de l'agent de diagnostic, D-046), `skills/nouvelle-analyse/` (procédure et modèle de fiche), `skills/nouveau-domaine/` (procédure pour un nouveau domaine), `skills/support/` (réponse à un client, D-079), `skills/nouveau-cas/` (ajouter un cas à la base de l'agent de diagnostic, lancé par l'utilisateur seul), `skills/revue-cas/` avec l'agent `revue` (l'utilisateur valide, corrige ou rejette les cas appris par la boucle, D-075), `skills/anonymiser-cas/` (données d'un cas copiées dans son dossier, noms en codes, registre des codes, D-049, D-050), `skills/boucle/` et `skills/critiquer-lot/` avec les agents `analyste`, `upgrader`, `validateur`, `builder` (boucle automatique, D-057), `skills/lire-les-donnees/` (outils de lecture et leur mode d'emploi) et `skills/aiguiser/` avec les agents `lecteur`, `correcteur`, `optimiseur` (D-059), `agents/releveur.md` (difficultés des processus automatiques, D-060), `agents/ameliorateur.md` (les corrige en fin de `/boucle --ameliorer` ou `/aiguiser --ameliorer`, D-071, D-076), `settings.json` (lecture de `.env` interdite). Schémas de ces processus (agents, flux de données) : `docs/agents/pipelines-ia.drawio`, une page par processus.
- `vues-deplacements/` : chantier à part des vues des déplacements et de l'agent dans une maquette (D-052) : contexte, cas réels (données, pages de la plateforme, parcours de l'utilisateur), puis le code ; sa carte : `vues-deplacements/CLAUDE.md` ; maquette de la page Explore avec les onglets View et Diagnosis dans `vues-deplacements/maquette/` (D-053, D-054) ; détecteurs du journal du matin dans `vues-deplacements/detectors/` (D-056) ; `extraction/` : pompage des données de la plateforme (D-056), à lancer par l'utilisateur dans le dev container de l'application (qui monte `~` : sortie directe dans `data/`) ; lecture seule ; mode d'emploi dans `extraction/README.md`.
- `.devcontainer/devcontainer.json` : environnement de dev en conteneur (D-038), réseau de l'hôte pour joindre la caméra. `architecture.drawio` : schéma d'architecture tenu par l'utilisateur, à ne pas modifier sans demande.
- `out/` : pages et JSON générés. Tout le projet est versionné, sauf `out/`, `data/` (D-065), `.venv/` et `__pycache__/` (D-014).
- `.devcontainer/devcontainer.json` : environnement de dev en conteneur (D-038), réseau de l'hôte pour joindre la caméra. `architecture.drawio` : schéma d'architecture tenu par l'utilisateur, à ne pas modifier sans demande. `out/` : pages et JSON générés. Tout le projet est versionné, sauf `out/`, `data/` (D-065), `.venv/` et `__pycache__/` (D-014).
## Règles de travail
+65
View File
@@ -0,0 +1,65 @@
"""GIF des images de la caméra sur une plage, pour joindre à une réponse au client (skill /support).
Usage : .venv/bin/python agents/diagnostic/outils/gif.py data/LENZSPITZE/
--debut 2026-10-26T18:00Z --fin 2026-10-27T08:00Z [--largeur 720] [--duree 700] [--max 150] [--sortie DOSSIER]
Prend les images du dossier dont l'heure (nom du fichier, UTC) est entre --debut et --fin inclus, dans l'ordre, les
réduit à --largeur px, écrit la date et l'heure UTC en bas à droite de chacune et les ramène à 64 teintes sans tramage
(le bruit des JPEG gonfle un GIF : ~3 Mo pour une nuit d'images horaires à 720 px). Au-delà de --max images, en garde
--max à intervalle régulier. Imprime l'heure de chaque image retenue, puis le chemin du GIF et sa taille.
"""
import argparse
import os
import sys
from PIL import Image, ImageDraw, ImageFont
from donnees import heure_image, instant, iso, trouver
RACINE = os.path.normpath(os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "..", ".."))
def main():
a = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
a.add_argument("dossier")
a.add_argument("--debut", required=True, help="première heure (UTC)")
a.add_argument("--fin", required=True, help="dernière heure (UTC), incluse")
a.add_argument("--largeur", type=int, default=720, help="largeur du GIF en pixels (défaut 720)")
a.add_argument("--duree", type=int, default=700, help="durée de chaque image en ms (défaut 700)")
a.add_argument("--max", type=int, default=150, help="nombre maximal d'images (défaut 150)")
a.add_argument("--sortie", default=os.path.join(RACINE, "out", "diagnostic"), help="dossier du GIF")
o = a.parse_args()
debut, fin = instant(o.debut), instant(o.fin)
toutes = sorted((h, p) for p in trouver(o.dossier)["images"] if (h := heure_image(p)))
choisies = [(h, p) for h, p in toutes if debut <= h <= fin]
if not choisies:
dispo = f" (images du {iso(toutes[0][0])} au {iso(toutes[-1][0])})" if toutes else ""
sys.exit(f"Aucune image entre {iso(debut)} et {iso(fin)} dans {o.dossier}{dispo}.")
n = len(choisies)
if n > o.max:
choisies = [choisies[round(i * (n - 1) / (o.max - 1))] for i in range(o.max)]
print(f"{o.max} images sur {n} gardées")
vues = []
for h, p in choisies:
im = Image.open(p).convert("RGB")
im = im.resize((o.largeur, round(im.height * o.largeur / im.width)), Image.LANCZOS)
d = ImageDraw.Draw(im)
texte = h.strftime("%Y-%m-%d %H:%M UTC")
police = ImageFont.load_default(size=max(12, o.largeur // 45))
g, haut, dr, bas = d.textbbox((0, 0), texte, font=police)
x, y, marge = im.width - (dr - g) - 10, im.height - (bas - haut) - 10, 4
d.rectangle((x - marge, y - marge, x + dr - g + marge, y + bas - haut + marge), fill="black")
d.text((x - g, y - haut), texte, fill="white", font=police)
vues.append(im.quantize(64, dither=Image.Dither.NONE))
print(iso(h))
os.makedirs(o.sortie, exist_ok=True)
nom = f"images_{choisies[0][0]:%Y%m%dT%H%MZ}_{choisies[-1][0]:%Y%m%dT%H%MZ}.gif"
chemin = os.path.join(o.sortie, nom)
vues[0].save(chemin, save_all=True, append_images=vues[1:], duration=o.duree, loop=0, optimize=True)
print(f"GIF : {chemin} ({os.path.getsize(chemin) / 1e6:.1f} Mo, {len(vues)} images)")
if __name__ == "__main__":
main()
+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.
@@ -0,0 +1,39 @@
# Analyse : activité sur les voies, nuit du 26 au 27.10 (LENZSPITZE)
**Question** : les images montrent-elles de l'activité sur les voies pendant les perturbations de la nuit du 26 au 27.10 ?
**Réponse** : non. Aucune activité sur les images horaires de la nuit (`confirmed` pour les instants des images, `insufficient evidence` entre deux images). Les perturbations sont une perte de visibilité de 14 cibles, lente, de 23:00Z à 08:30Z environ, que la station rejette ; la même chose la nuit précédente. Cause probable : buée ou eau (humidité nocturne), `consistent with`, non vue.
## Faits
- **Données** (observé) : déplacements à 5 min et images horaires les 26 et 27.10 ; aucun déplacement du 23.10 23:55Z au 26.10 00:00Z. Images à 21:00, 22:00, 23:01, puis toutes les heures de 00:01 à 09:00Z. `python3 agents/diagnostic/outils/inventaire.py data/LENZSPITZE/ --debut 2026-10-26T00:00Z --fin 2026-10-27T23:59Z`
- **La perturbation** (observé) : 14 cibles rejetées une bonne partie de la nuit (`error_value` au-dessus du seuil de 0,7) : 1002, 1004, 101B, 102H, 201B, 202H, 7013H, 8004, 8010, 8011, 8012, 8013, 8014, 92H, entre 00:00Z et 08:50Z selon la cible. Même commande.
- **Sa forme** (observé) : l'`error_value` de 8012, 101B, 202H, 8014 monte peu à peu de ~0,07 à partir de 23:00Z, atteint ~0,97 vers 01:00-02:00Z, reste en plateau, puis retombe en moins d'une heure vers 08:30Z. 1015 et 1017 restent à ~0,1 toute la nuit. `python3 agents/diagnostic/outils/resume.py data/LENZSPITZE/ --colonne error_value --pas 1h --capteurs 8012,101B,202H,1017 --debut 2026-10-26T20:00Z --fin 2026-10-27T10:00Z`
![error_value et corr_y de quatre cibles touchées et de deux cibles intactes, la nuit grisée](LENZSPITZE_error_value-corr_y_8012-101B-202H-8014-1017-1015_20261026T1200Z_20261027T1200Z.png)
*De 00:00 à 08:40Z, l'`error_value` de 8012, 101B, 202H, 8014 plafonne près de 1 (rejetées, `corr_y` vides) ; 1015 et 1017 ne bougent pas.*
- **Repères des détecteurs** (dérivé) : `visibilite_reduite` du 27.10 00:00Z à 08:40Z (18 capteurs) ; la nuit précédente aussi, du 26.10 00:10Z à 08:05Z (28 capteurs), avec `visibilite_nulle` de 06:25Z à 06:45Z (27 capteurs) ; plus faibles les nuits du 16-17.10 (8) et du 22-23.10 (11). `python3 vues-deplacements/detectors/categories.py data/LENZSPITZE/`
- **Images** (observé, Read) : 26.10 21:00Z, 27.10 00:01Z et 04:01Z : la scène de nuit, identique d'une heure à l'autre (les tirets lumineux à gauche sont fixes : les barrières réfléchissantes du chantier, visibles de jour) ; aucun train, engin, personne ni éclairage de chantier ; des taches de cibles plus faibles à 00:01Z et 04:01Z qu'à 21:00Z. 27.10 07:01Z : lever du soleil face à la caméra, voies vides ; 09:00Z : jour, voies vides, cibles visibles. 26.10 06:01Z et 07:01Z (autour de la `visibilite_nulle`) : aube, voies vides.
- **GIF** : `images_20261026T2100Z_20261027T0900Z.gif` (13 images, 21:00Z → 09:00Z). `.venv/bin/python agents/diagnostic/outils/gif.py data/LENZSPITZE/ --debut 2026-10-26T21:00Z --fin 2026-10-27T09:00Z --sortie support/2026-10-28_LENZSPITZE_activite-voies/`
- **Heure de la capture du client** (dérivé) : ses pics du 26.10 sont lus vers 07:30-07:50 sur son axe ; la `visibilite_nulle` est à 06:25-06:45Z ; son axe est donc en UTC+1 (heure d'hiver suisse depuis le 25.10). Ses pics du 27.10 (vers 02:30-06:00 sur son axe, 01:30-05:00Z) tombent dans le plateau.
## Cas connu
C-005 (voies ferrées), critère 3, « pluie » : la nuit, 6 à 8 h, `error_value` d'une douzaine de cibles monte sans pic d'un seul pas, puis revient sans palier. Correspondance **partielle** : forme, durée et nombre de cibles vérifiés ; ici, l'`error_value` plafonne (jusqu'à ~14 fois son niveau, au-delà des 6-40 MAD du cas), et les gouttes éclairées du critère 5 ne se voient pas sur les images (non vérifiable à cette résolution). Hypothèse principale : buée ou eau (humidité nocturne : rosée, brouillard ou pluie fine), `consistent with`. Le critère 1 (trains : pics d'une seule mesure) ne correspond pas à un plateau de 8 h.
## Réfutation
Une activité sur les voies (train à l'arrêt, travaux) laisserait une trace sur au moins une des 12 images de la nuit, qui couvrent 23:01Z → 08:00Z : aucune. Un passage bref entre deux images reste possible, mais il donnerait des pics de quelques mesures (C-005, critère 1), pas une montée lente sur deux heures suivie d'un plateau de sept heures, et pas la même chose deux nuits de suite.
## Non établi
- Ce qui se passe entre deux images horaires.
- La cause exacte de la perte de visibilité : humidité supposée, rien de visible sur les images (pas de gouttes, pas de voile marqué). Une donnée météo (humidité, point de rosée) trancherait.
- Pourquoi la plateforme du client montre des pics sur ses séries caméra : sans doute des mesures que la station rejette mais que sa plateforme affiche ; non vérifié.
## Hors question (pour Marc)
- Un engin de chantier est visible à gauche de la voie le 27.10 à 12:00Z (de jour, hors de la plage).
- 8012 reste agitée après la nuit (`error_value` jusqu'à ~0,5 de 09:30Z à 11:30Z) et son `corr_y` reprend vers +0,07 au lieu de ~0 avant la nuit : à suivre.
- Outils : sur cet export, `x`, `y` ne sont pas des positions en pixels (valeurs proches de 0) : `vignettes.py` ne trouve pas les cibles ; `inventaire.py` n'y voit aucune référence.
Binary file not shown.

After

Width:  |  Height:  |  Size: 364 KiB

@@ -0,0 +1,19 @@
# LENZSPITZE : activité sur les voies
- **Statut** : brouillon
- **Reçu le** : 2026-10-28
- **Station** : LENZSPITZE, donnée par Marc (rien dans le mail ni dans la capture ne la désigne)
- **Plage** : nuit du 26 au 27.10.2026, 2026-10-26T21:00Z → 2026-10-27T09:00Z ; plus les pics du 26.10 au matin marqués sur la capture (vers 06:30Z). Mail (« cette nuit ») et axe de la capture, qui est en heure locale, UTC+1 (voir `analyse.md`)
- **Question** : les images montrent-elles de l'activité sur les voies pendant les perturbations de la nuit du 26 au 27.10, pour l'expliquer dans le rapport du client ?
- **Séries** : la plateforme du client montre `FlV_tachy9002_v670_04` à `_09` (théodolite) et `PfV_670_2026_2_cam` à `_10_cam` (caméra) ; correspondance avec les `sensor_name` non établie
## Mail du client
> Salut Marc,
> j'espère que tu vas bien ?
> je suis en train d'analyser les résultats et 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.
> Salutations et merci d'avance
![Capture du client : « Flèche Verticale relative - Comparaison Théo - VS - Camera - Installation 2 », 26-27.10, perturbations marquées en rouge](capture.png)
Binary file not shown.

After

Width:  |  Height:  |  Size: 2.2 MiB

@@ -0,0 +1,21 @@
**Objet** : Re: perturbations de la nuit du 26 au 27.10
Salut,
Ça va bien, merci ! J'ai regardé les images : il n'y a pas d'activité visible sur les voies cette nuit-là. Les perturbations viennent d'une perte de visibilité d'une partie des cibles pendant la nuit, pas d'un passage ni d'une intervention.
Ce qu'on voit (heures en UTC, ton graphique est en UTC+1) :
- La caméra prend une image par heure. De 21:00 à 09:00 UTC (22:00 à 10:00 sur ton graphique), les voies sont vides sur toutes les images : pas de train, pas d'engin, pas de personne, pas d'éclairage de chantier. Le GIF joint montre la nuit, image par image.
- À partir de 23:00 UTC, 14 cibles deviennent peu à peu moins visibles pour la caméra : 1002, 1004, 101B, 102H, 201B, 202H, 7013H, 8004, 8010, 8011, 8012, 8013, 8014 et 92H. La station juge leurs mesures non fiables et les rejette, de minuit environ jusqu'à 08:30 UTC, puis tout revient en matinée. Les autres cibles restent normales toute la nuit. Si ta plateforme affiche ces mesures rejetées, ce sont elles qui font les pics.
- La nuit d'avant, la même chose s'est produite aux mêmes heures. Les pics du 26.10 vers 07:30 sur ton graphique (06:25 à 06:45 UTC) tombent à l'aube : les images de 06:00 et 07:00 UTC montrent aussi des voies vides.
Une baisse lente, qui dure toute la nuit et revient deux nuits de suite, est compatible avec de l'humidité (rosée ou brouillard) sur les cibles. Je ne la vois pas directement sur les images, je ne peux donc pas l'affirmer. Avec une image par heure, je ne peux pas non plus exclure un train passé entre deux images. Mais un passage ne perturbe les mesures que quelques minutes, pas toute une nuit.
Ton théodolite reste plat sur la même période, ce qui va dans le même sens : rien n'indique un mouvement des voies.
Pour ton rapport, tu peux écrire que les perturbations de la nuit du 26 au 27.10 viennent d'une baisse de visibilité nocturne des cibles caméra (mesures rejetées par le système), sans activité visible sur les voies.
Salutations,
Marc
**Pièces jointes** : `images_20261026T2100Z_20261027T0900Z.gif` : les images de la caméra du 26.10 21:00 au 27.10 09:00 UTC, une par heure, l'heure UTC en bas à droite.