BREITHORN, MICHIGAN, NEBRASKA: "the structure does not move", "not a movement of the structure", "these points do not move", "nothing moved" replaced by the observed fact (the camera moves, the jump occurs when the reference is lost, the vehicle hides these targets, the curves follow the camera); conclusions titled by the main facts; "pique du nez" removed from titles and figures. Skill /presentation: the rules and the model deck updated. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
8.6 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)
- 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 » ; l'action : faire vérifier ce qui porte la caméra (fixation, support, mur). Les titres écrits dans les figures suivent la même règle.
- 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 | comparison-slide |
« Conclusion : » (« la caméra bouge, un véhicule cache des cibles ») ; à gauche « Pourquoi c'est moins fiable », à droite « Ce qu'il faut faire » (3 puces chacun) |
| 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 (une nuit sans mesure) :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
Celles du rapport d'abord (cp support/<dossier>/*.png documents/<station>-situation/images/). 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 :
(x, y : le « centre du cadre » de la cible sur une vignette de
.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"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) ; - un événement de la caméra n'a qu'une figure partagée avec un autre : refaire la figure qui lui est propre (le tilt seul, depuis
camera/,median_tilt).
Toute image nouvelle va dans le dossier du rapport, et se regarde avec Read avant d'être gardée.
3. Créer, compiler, vérifier
cd ~/docfactory-presentation
python3 brand/tools/new.py deck <station>-situation --title "<STATION>, <mois année>" # une fois
python3 brand/tools/build.py <station>-situation # build/<station>-situation-draft.pdf
pdftotext build/<station>-situation-draft.pdf - | grep -c Overflow # doit donner 0
python3 brand/tools/build.py <station>-situation --png # une image par page, à regarder avec Read
- Typst ≥ 0.14 (
~/.local/bin). Build qui refuse la charte (« added … :Zone.Identifier ») :find ~/docfactory-presentation -name '*:Zone.Identifier' -delete. - Lint :
bare-imageest attendu (pas de#figdans 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,gridniv: la charte décide (brand/ne se modifie pas). - Regarder le résumé, chaque diapositive à image et la conclusion. « PROJET unversioned » en haut : normal, la fabrique n'est pas un dépôt git.
4. Rendre
cp build/<station>-situation-draft.pdf ~/Support-Agent/support/<dossier>/presentation.pdf, envoyer le PDF 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.
- « 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-slideenlayout: "single-side"avec des puces danslegend: 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.