Files
Support-Agent/API/knowledge/support/redaction.md
T
maximeandClaude Opus 5.5 ee3875fe75 Support page: choose a PDF or a reply mail (D-141)
PDF | Mail before Analyser. In mail mode the support agent gets ecrire_mail
(body + figures of the session as attachments, mail-vN.json) instead of the
presentation tools; its prompt ends with prompts/support-mail.md, without
presentation.md and modele.typ. The page shows the text, Copier, and the
attachments to download. check_sortie_mail in API/support/check.py.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-05 16:48:17 +01:00

3.4 KiB
Raw Blame History

Règles de rédaction du support

Copiées le 2026-11-05 du skill support du projet (§5, voir PROVENANCE.md). Dans l'API, analyse.md et reponse.md n'existent pas : pour une sortie mail, le corps de reponse.md et ses pièces jointes passent par ecrire_mail ; pour une sortie PDF, ces règles valent pour les textes de la présentation (langue du client, rien d'interne, honnêteté sur ce qui n'est pas établi, phrases simples), pas pour la forme du mail (objet, salutations, pièces jointes).

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 :

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