- read-event: map and index first, then the card of close events only, then their data with the reading tools; never all cards at once. Diagnostic agent, critiquer-lot and builder point to it; the index header too. Signature length: about 250 characters, a guideline. - "Cas" becomes "event": events/E-xxx/event.md, skills new-event, review-event, anonymize-event. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
110 lines
8.3 KiB
Markdown
110 lines
8.3 KiB
Markdown
---
|
||
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 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>
|
||
|
||

|
||
```
|
||
|
||
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>"
|
||
```
|