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

112 lines
8.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
name: support
description: Le support d'un système AIMsight — /support <STATION> fait le rapport de situation de la station à partir de ses étiquettes (labeling/auto/) ; /support <mail> répond à la question d'un client (mail et capture, données de data/) par un mail prêt à envoyer. Dans un dossier de cas support/. Lancé par l'utilisateur.
disable-model-invocation: true
argument-hint: "<STATION> [--du AAAA-MM-JJ --au AAAA-MM-JJ] | <mail du client> (capture collée dans le même message)"
---
**L'argument est un nom de station** (un dossier de `labeling/auto/`), seul ou avec `--du --au` : suis `.claude/skills/support/rapport.md`, le rapport de situation, et pas la suite de ce fichier. **Sinon, c'est le mail d'un client** : suis ce qui suit.
# 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 de l'event (§3). Tu ne télécharges aucune donnée, tu n'ajoutes rien à la base d'events, 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 detectors/categories.py <dossier>`, `gif.py` (§4), `mkdir`, `cp` (la capture), `date`, et à la fin `git add`/`git commit` du seul dossier de l'event.
## 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 agent-tools/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 de l'event
`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 `agent-diagnostic/instructions.md`, §4 étapes 2, 4, 5 et 7 (repérage avec `categories.py`, faits, events 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.
- La capture peut comparer la caméra à un autre instrument du client (ex. une station totale, « tachy », en traits continus, la caméra en traitillés). Ne t'appuie sur cet instrument que s'il a des points sur la plage : une ligne continue peut relier deux points de part et d'autre de la nuit (une station totale n'envoie souvent rien la nuit, faute de visibilité). Si tu ne peux pas le voir sur la capture, demande à Marc.
- 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 agent-tools/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 ; l'event 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 du client, tutoiement s'il tutoie ; « Bonjour, » pour commencer, puis une ligne qui répond à sa politesse s'il en fait une (« Ça va bien, merci ! ») ; « Salutations, » et le prénom par lequel il s'adresse au support pour finir ;
- une mesure « rejetée » (`error_value` au-dessus du seuil) n'est pas retirée : la caméra livre tout, c'est nous qui la jugeons peu fiable, et le client la reçoit quand même. Écris « nous jugeons ces mesures peu fiables, mais elles te sont livrées », jamais « la station les rejette » ;
- jamais d'interne : codes d'events (E-xxx), noms des détecteurs ou des outils, autres stations, identifiants (`SIM_CCID`, `ip`), vocabulaire de preuve en anglais.
Le mail doit se lire comme écrit par une personne, pas par une IA :
- pas de deux-points comme ponctuation (les heures `21:00` et la ligne d'objet mises à part) : une phrase de plus, une virgule ou des parenthèses ;
- pas de tiret long ou moyen (— –), de flèche, de guillemets « », de gras ni de caractère spécial ; les faits en liste à puces `*` simple, s'il y en a plusieurs ;
- des phrases simples et directes, les mots du client pour ses instruments (station totale, tachy) ; pas de formules toutes faites (« N'hésite pas à revenir vers moi », « J'espère que ces éléments t'aideront », « En résumé ») ;
- exemple validé par Marc : `support/2026-10-28_LENZSPITZE_activite-voies/reponse.md`.
## 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>"
```