Files
Support-Agent/.claude/skills/presentation/SKILL.md
T
maximeandClaude Opus 5.5 35b5ed4d74 Auto labels reviewed per station and cross-reviewed; all labeling knowledge in labeling/ (D-130)
- Every station's auto labels reviewed by an analyst (/review-auto-labels), then a
  cross-review per family across all stations (new skill /cross-review-labels),
  a finishing pass, and descriptions rewritten in words (no numeric values).
- The three never-labeled ranges (WILDSTRUBEL 07/09-01/10, NORDEND 16/08-01/10)
  labeled and reviewed: 991 auto labels on 11 stations, labeling/controle.py at 0 errors.
- Labeling knowledge gathered in labeling/: regles-d-etiquetage.md (new), familles.md
  (settled boundaries), connaissances/ (notes moved from docs/, links updated),
  the label map rebuilt from reviewed labels, events and cases; events tied to their
  stations (PS_DES_COUDRES is JUNGFRAU). The labeler and reviewers read only labeling/.
- labels-map reads auto labels and events; decision D-130; living plan points 73-75.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-05 08:21:57 +01:00

13 KiB

name, description, argument-hint
name description argument-hint
presentation Mettre en présentation (diapositives 16:9, PDF à la charte AIMsight) un rapport de situation du support, support/<dossier>/rapport.md, avec la fabrique Typst ~/docfactory-presentation. Lancé par l'utilisateur, /presentation <STATION> ou <dossier support/>, après /support <STATION> ; à utiliser aussi pour reprendre une présentation déjà faite quand son rapport a changé. <STATION> | support/<dossier>/

Mettre un rapport de situation en présentation

Le rapport (support/<dossier>/rapport.md, fait par /support <STATION>, D-113) devient une présentation PDF à la charte AIMsight, faite avec la fabrique Typst ~/docfactory-presentation (D-114). Le rapport fait foi : la présentation n'ajoute rien et ne change pas le sens. Seule la partie au-dessus du trait --- y entre ; la partie interne (« Pour le support ») jamais.

Modèle à suivre : modele.typ (BREITHORN, octobre 2026, validé dans sa structure par l'utilisateur), qui contient tous les types de diapositive.

Ce que veut l'utilisateur (2026-11-03)

  • Une présentation pour le client, qui vend le système (D-127) : on ne critique pas notre propre système, on ne s'incrimine pas. Pas de « mal compensé », « la correction ne le compense plus correctement », « la redondance est perdue », « les courbes sont moins fiables », « une seule correction ne peut pas toutes les compenser ». Dire le fait et sa cause extérieure : « REFPOU22 n'est plus visible ; la compensation continue sur deux références », « les courbes suivent ce mouvement commun de la caméra ».

  • Les tassements d'abord, corr_y : c'est ce que regarde le client. Les figures montrent le déplacement vertical (corr_y) ; corr_x seulement là où le phénomène ne se voit qu'en horizontal (BREITHORN : la parallaxe, gardée, dite par la géométrie : des cibles à 9 m, d'autres à 20 à 60 m, un même mouvement de la caméra ne se voit pas pareil sur toutes). Chiffrer la stabilité verticale quand elle se voit (médiane journalière de chaque cible sur le mois). corr_x et corr_y sont en pixels, pas en mm (labeling/connaissances/colonnes-des-deplacements.md) : écrire « 0,2 px ».

  • Pas de diapositive sur un trou de données (une nuit sans mesures), ni dans le résumé ni dans la conclusion.

  • La conclusion : ce qu'expliquent les variations des courbes et ce qui reste stable, pas « ce qui rend les mesures moins fiables ».

  • Aller droit aux faits : pas de page « En bref », pas de description sous le titre ; la page de titre dit seulement que c'est un point de situation, la station et la période.

  • Chaque diapositive se suffit : elle montre le cas et donne le diagnostic, image à l'appui (l'image de la cause quand elle se voit : le véhicule, l'obstacle).

  • Donner le diagnostic, pas une consigne : jamais « à ignorer », « ne pas croire », « à ne pas lire comme ». Dire ce qui se passe et ce que cela implique, pour amener le client à la bonne conclusion : « le véhicule cache ces cibles ; leurs sauts tombent quand il est là, et tout revient au matin ».

  • Les faits seulement, jamais l'ouvrage : on ne sait pas si l'ouvrage bouge ; ne jamais écrire « l'ouvrage ne bouge pas », « pas un mouvement de l'ouvrage », « ces points ne bougent pas », « rien n'a bougé ». Dire le fait observé : « la caméra bouge », « le saut survient à la perte de la référence », « les cibles ne bougent pas dans l'image », « les courbes suivent la caméra ».

  • Le mouvement de la caméra est réel, sa cause inconnue : dire que la caméra bouge (tilt, pan), que ce mouvement est réel, et qu'on ne sait pas exactement ce qui le provoque (sa fixation, le mur ou autre chose). Titre neutre, « La caméra bouge peu à peu », pas « pique du nez ». Les titres écrits dans les figures suivent la même règle.

  • Aucune instruction au client : il fait comme il veut. Pas de « Ce qu'il faut faire », « faire vérifier », « nous signaler », « garer » : la présentation dit ce qui se passe, pas quoi faire.

  • Des légendes qui se lisent seules : sous chaque graphique, dire ce que montre chaque panneau (la grandeur : déplacement horizontal corr_x ou vertical corr_y, tilt ou pan en degrés), les cibles, la période, ce que veulent dire le gris et les pointillés ; dans la figure aussi, l'axe à côté du nom de chaque cible. Le lecteur ne doit rien deviner.

  • Les courbes, pas les cibles : « les courbes de POUI19 dérivent », pas « POUI19 dérive » ; seul ce qui est mesuré dans l'image (« les cibles ne bougent pas dans l'image ») se dit des cibles.

  • Nommer seulement ce qui se voit : une tache lumineuse sur le véhicule, c'est « des reflets », pas « ses phares ».

  • Une référence perdue : c'est le message, il ne nous met pas en cause : le système était stable à l'installation, le réseau de référence a été altéré depuis. Une diapositive avant / après (courbes corr_y du mois, pointillé à la disparition, écart-type avant et après : MICHIGAN, 0,014 px puis 0,10 px) ; l'agitation qui suit s'y rattache (« c'est ce que donne un réseau de référence altéré »), sans accent sur la température. Dater le saut commun à la disparition.

  • Un état qui dure depuis le début (deux cibles trop proches) : le dater du début des données si les images le montrent, pas de la première étiquette ; dater à part le saut qu'il a provoqué (MICHIGAN : trop proches depuis le 3, saut le 5).

  • Par mois : la présentation couvre le mois du rapport (« c'est un rapport sur tout le mois d'octobre »). Si le rapport couvre moins, l'étendre d'abord (/support <STATION> --du <1er> --au <dernier jour>, ou un agent de support par station, en gardant le diagnostic déjà validé par l'expert).

1. La structure, toujours la même

# Diapositive Contenu
1 title-slide kicker: [Point de situation], title: [<STATION>], subtitle: [Du <premier jour des données> au <dernier> <mois année>] ; rien d'autre (ni description, ni image)
2 content-slide, eyebrow « Résumé » « Ce qui s'est passé en » : la chronologie, une ligne numérotée (+) par événement, dans l'ordre de leur premier jour : + #strong[<dates>] : <l'événement en quelques mots>.
3 à n une par événement, eyebrow « Événement <numéro du résumé> » le titre de l'événement, 2 ou 3 puces (Quand, Cibles si utile, Ce qu'on voit), puis #strong[Diagnostic] : … en paragraphe ; l'image à droite
n+1 content-slide « Conclusions », puis les puces : ce qui reste stable, puis la cause de chaque variation, dans l'ordre d'importance, sans aucune instruction
n+2 closing-slide « Nous restons à votre disposition », adresse par défaut
  • Les événements : un par constat du rapport ; quand un constat mêle deux phénomènes que l'utilisateur distingue, les séparer (BREITHORN : le mouvement de la caméra et la parallaxe, qui fait que certaines cibles le suivent). Plus de cinq événements : le lint signale « 6 bullets », c'est accepté pour le résumé.
  • Diapositive d'événement : two-column-slide, image à droite (#image("images/x.png") puis une légende #emph[...] d'une ligne). Ratio selon l'image (largeur / hauteur, dans l'en-tête du PNG) : ≥ 1,4 → "40-60" ; vignettes presque carrées (≤ 1,3) → "60-40". Sans image : content-slide, mêmes puces et diagnostic.
  • Une image par événement, la plus parlante : l'image de la cause si elle se voit, sinon la courbe, plage grisée.
  • lang: "fr" ; toute heure en UTC, dite ; les « on ne peut pas l'affirmer » du rapport restent dans le diagnostic (« la cause n'est pas établie »).

2. Les images

Toutes dans le dossier du rapport, à côté de <station>.typ : celles du rapport d'abord. Il en faut d'autres quand :

  • la cause se voit dans l'image de la caméra et le rapport n'en a qu'une vignette : recadrages éclaircis côte à côte, d'abord un instant sans la cause, puis avec :
    .venv/bin/python .claude/skills/presentation/image-de-la-cause.py data/<STATION> <x> <y> support/<dossier>/<nom>.png \
        20261028T1200Z="28.10 12:00 UTC : rien devant" 20261025T1200Z="25.10 12:00 UTC : un véhicule"
    
    (x, y : le « centre du cadre » de la cible sur une vignette de vignettes.py). Les scènes intérieures sont sombres même de jour : chercher l'instant où la cause se voit le mieux (de jour, ou ses phares la nuit) ;
  • les courbes en corr_y, avec au besoin la caméra et la température au-dessus, les plages grisées et un trait pointillé (la perte d'une référence) ; le nom de chaque cible porte « (corr_y) » :
    .venv/bin/python .claude/skills/presentation/figure-y.py data/<STATION> support/<dossier>/<nom>.png 2026-10-03T00:00Z 2026-11-01T00:00Z \
        --cam tilt,pan [--temp] --cibles A,B,C [--zone D/F ...] [--ligne T] [--hauteur 5]   # --toutes : toutes les cibles, pour choisir
    
  • un événement de la caméra : montrer le tilt et le pan (camera/, median_tilt et median_pan, deux panneaux, en degrés), et la rotation (median_rotation) quand c'est elle qui bouge (BREITHORN, nuits du 28 au 30.10 : la rotation en haut, les cibles en bas, les mêmes plages grisées) ; pour la parallaxe, le tilt en haut et les cibles en bas, chacune avec son axe dans la légende de la figure ;
  • une figure à plusieurs panneaux (tilt, pan, température, cibles) dans une colonne : la faire large (figsize=(12.5, 6.4), rapport ≈ 2), sinon la diapositive déborde de 20 à 30 mm ;
  • des vignettes (vignettes.py) : leurs titres donnent déjà la cible et l'heure ; légende courte, « Au-dessus de chaque image : la cible et l'heure UTC ; croix rouge : le point mesuré. »

Toute image nouvelle va dans le dossier du rapport, et se regarde avec Read avant d'être gardée.

3. Écrire, compiler, vérifier

Le source est support/<dossier>/<station>.typ (nom de la station en minuscules, breithorn.typ), versionné avec le rapport ; le partir de modele.typ, et ne référencer que des images du dossier, par leur nom seul (#image("<nom>.png")) : il se compile alors aussi sur place (VS Code, Tinymist), grâce au lien brand/ à la racine du dépôt, que le script crée, et à .vscode/settings.json. L'utilisateur le modifie aussi lui-même (run.md, « Compiler la présentation »).

bash .claude/skills/presentation/compiler.sh support/<dossier>       # PDF dans support/<dossier>/<station>.pdf, et le nombre de débordements (doit être 0)
cd ~/docfactory-presentation && python3 brand/tools/build.py <station>-situation --png   # une image par page, dans build/, à regarder avec Read

Le script copie le source et les images dans la fabrique (documents/<station>-situation/, une copie : ne pas la modifier), compile et rapporte le PDF. Une page qui déborde : pdftotext -f N -l N support/<dossier>/<station>.pdf - | grep Overflow.

  • Typst ≥ 0.14 (~/.local/bin). Build qui refuse la charte (« added … :Zone.Identifier ») : find ~/docfactory-presentation -name '*:Zone.Identifier' -delete.
  • Lint : bare-image est attendu (pas de #fig dans le gabarit de présentation) ; [budget] : raccourcir (une puce ≤ 16 mots, le lint compte ;, : et #strong[Quand]).
  • Débordement (« Overflow +N mm » en rouge ; la page : pdftotext -f N -l N) : puce ou diagnostic plus court, légende sur une ligne, ou ratio "60-40". Jamais réduire la police.
  • Noms à apostrophes (COLH21', COLH20''') : COLH20\'\'\', sinon Typst en fait des guillemets.
  • Pas de taille de police, de couleur, de place, grid ni v : la charte décide (brand/ ne se modifie pas).
  • Regarder le résumé, chaque diapositive à image et la conclusion. En haut à droite, « Sandouville » : la ligne #show regex("PROJET.*") du modèle remplace le tampon « PROJET unversioned » de la charte (la fabrique n'est pas un dépôt git).

4. Rendre

Le PDF est déjà dans support/<dossier>/<station>.pdf : l'envoyer par SendUserFile, dire ce qui a changé ou a été laissé dans le rapport. Pas de commit avant la validation de l'utilisateur.

Ce qui n'a pas marché

  • Une page « En bref » et un sous-titre descriptif sur la page de titre : l'utilisateur veut les faits tout de suite.
  • « La caméra pique du nez », « sa fixation est à vérifier » comme diagnostic : la cause du mouvement n'est pas connue, seul le mouvement l'est.
  • « À ignorer », « ne pas croire » : des consignes au lieu d'un diagnostic.
  • Une conclusion en deux colonnes (comparison-slide) « Pourquoi c'est moins fiable » / « Ce qu'il faut faire » : mise en page peu convaincante, et des instructions au client.
  • Une légende qui laisse deviner ce qu'on regarde (« en bas, POUI19 et COLJ19 le suivent » sans dire que c'est le déplacement horizontal).
  • « L'ouvrage ne bouge pas », « ce n'est pas un mouvement de l'ouvrage » : on ne le sait pas ; seuls les faits (la caméra bouge, une référence manque) sont établis.
  • Une diapositive de texte puis une d'image par constat : deux pages à moitié vides, aucune ne se suffit.
  • plot-gallery-slide en layout: "single-side" avec des puces dans legend : les lignes se chevauchent (défaut du gabarit).
  • Une image presque carrée en "40-60" : débordement de 20 mm.

Pistes à essayer (suggestions, non validées)

  • Une image très large (≥ 3) est petite en colonne : la recadrer sur la période utile, ou la refaire moins large.
  • Dans la conclusion, une ligne « ce qui n'est pas établi » si le client en a besoin pour agir.