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

6.9 KiB

name, description, disable-model-invocation, argument-hint
name description disable-model-invocation argument-hint
support 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>. true <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 :

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

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

**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

git add support/<dossier>
git commit -m "Support: <STATION>, <sujet>"