470 lines
14 KiB
Markdown
470 lines
14 KiB
Markdown
|
# SKILL — Sliding Design System (Pernod Ricard)
|
|||
|
|
|
|||
|
|
Ce skill décrit le **design system « PR Editorial »** et le format de données
|
|||
|
|
que consomme le moteur de rendu `render_engine_v2.py` pour produire des
|
|||
|
|
présentations PowerPoint au format Pernod Ricard.
|
|||
|
|
|
|||
|
|
**Périmètre de ce skill : design et production uniquement.** Il ne traite pas
|
|||
|
|
de la structuration narrative, de la rédaction ou de la rhétorique. Il répond
|
|||
|
|
à une seule question : *comment produire un fichier YAML valide qui, passé au
|
|||
|
|
moteur, génère un PPTX conforme à la charte Pernod Ricard.*
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 1. Principe de fonctionnement
|
|||
|
|
|
|||
|
|
Le moteur prend en entrée un fichier **YAML** décrivant une liste de slides.
|
|||
|
|
Chaque slide déclare un `layout` (parmi 21) et les champs de contenu de ce
|
|||
|
|
layout. Le moteur applique automatiquement la charte (couleurs, polices,
|
|||
|
|
grille, centrage vertical). Tu n'as jamais à spécifier de couleur, de police
|
|||
|
|
ou de position en mode standard : tu fournis le contenu, le moteur compose.
|
|||
|
|
|
|||
|
|
Commande de rendu :
|
|||
|
|
```bash
|
|||
|
|
python3 render_engine_v2.py presentation.yaml sortie.pptx \
|
|||
|
|
--theme theme_v2.yaml --components components_v2.yaml --layouts layouts_v2.yaml
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Structure générale du YAML :
|
|||
|
|
```yaml
|
|||
|
|
slides:
|
|||
|
|
- layout: cover_split
|
|||
|
|
titre: "..."
|
|||
|
|
- layout: kpi_grid
|
|||
|
|
titre: "..."
|
|||
|
|
items: [...]
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 2. La charte (appliquée automatiquement)
|
|||
|
|
|
|||
|
|
Tu n'écris jamais ces valeurs en mode standard ; elles sont là pour information.
|
|||
|
|
|
|||
|
|
**Couleurs**
|
|||
|
|
| Token | Hex | Usage |
|
|||
|
|
|---|---|---|
|
|||
|
|
| navy | `#061033` | dominant — fonds sombres, titres |
|
|||
|
|
| navy_light | `#10204D` | cercles décoratifs sur fond sombre |
|
|||
|
|
| coral | `#F4795B` | accent UNIQUE — chiffres, badges, lignes |
|
|||
|
|
| glacier | `#8FA9D0` | sous-titres sur fond sombre, 3e couleur |
|
|||
|
|
| slate | `#46505A` | 2e couleur de cycle |
|
|||
|
|
| card | `#F4F1EC` | fond des cartes (gris chaud) |
|
|||
|
|
| card_alt | `#EAF0F8` | variante froide |
|
|||
|
|
| body | `#2B3440` | texte courant sur fond clair |
|
|||
|
|
| muted | `#8A93A0` | légendes, sources |
|
|||
|
|
|
|||
|
|
**Polices** : Cambria (titres, chiffres) / Calibri (corps).
|
|||
|
|
**Format slide** : 33,87 × 19,05 cm (16:9).
|
|||
|
|
**Règle d'accent** : le corail est rare. Un seul élément corail dominant par slide ; le navy domine.
|
|||
|
|
**Rythme sandwich** : ouverture, transitions et clôture sur fond sombre (navy) ; contenu sur fond clair.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 3. Les 21 layouts standards
|
|||
|
|
|
|||
|
|
Chaque layout liste ses champs **requis** (obligatoires) et **optionnels**.
|
|||
|
|
`titre` doit être une formulation affirmative (le message du slide), pas un label.
|
|||
|
|
|
|||
|
|
### Ouverture / Clôture / Structure
|
|||
|
|
|
|||
|
|
**cover_split** — couverture (fond sombre)
|
|||
|
|
Requis : `titre` · Optionnel : `sous_titre`
|
|||
|
|
```yaml
|
|||
|
|
- layout: cover_split
|
|||
|
|
titre: "Titre de la présentation"
|
|||
|
|
sous_titre: "Tagline en une phrase"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**section_divider** — transition de section (fond sombre, numéro auto)
|
|||
|
|
Requis : `titre`
|
|||
|
|
```yaml
|
|||
|
|
- layout: section_divider
|
|||
|
|
titre: "Nom de la section"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**end_slide** — clôture (fond sombre)
|
|||
|
|
Requis : `message`
|
|||
|
|
```yaml
|
|||
|
|
- layout: end_slide
|
|||
|
|
message: "Phrase de conclusion"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Synthèse / Message
|
|||
|
|
|
|||
|
|
**executive_summary** — synthèse situation/complication/résolution
|
|||
|
|
Requis : `titre, situation, complication, resolution`
|
|||
|
|
```yaml
|
|||
|
|
- layout: executive_summary
|
|||
|
|
titre: "Le So What en une phrase affirmative"
|
|||
|
|
situation: "État des lieux factuel"
|
|||
|
|
complication: "Le problème ou la tension"
|
|||
|
|
resolution: "La réponse proposée"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**key_message** — citation/message fort (fond sombre)
|
|||
|
|
Requis : `message` · Optionnel : `detail`
|
|||
|
|
```yaml
|
|||
|
|
- layout: key_message
|
|||
|
|
message: "Le message clé en une phrase forte."
|
|||
|
|
detail: "Sous-texte optionnel."
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Données
|
|||
|
|
|
|||
|
|
**big_stat** — un chiffre héro plein écran
|
|||
|
|
Requis : `titre, valeur` · Optionnel : `description, source`
|
|||
|
|
```yaml
|
|||
|
|
- layout: big_stat
|
|||
|
|
titre: "Titre affirmatif"
|
|||
|
|
valeur: "78%"
|
|||
|
|
description: "ce que le chiffre signifie"
|
|||
|
|
source: "Référence — 2026"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**kpi_grid** — 2 à 6 cartes KPI
|
|||
|
|
Requis : `titre, items`
|
|||
|
|
```yaml
|
|||
|
|
- layout: kpi_grid
|
|||
|
|
titre: "Titre affirmatif"
|
|||
|
|
items:
|
|||
|
|
- label: "Indicateur 1"
|
|||
|
|
valeur: "+13%"
|
|||
|
|
description: "Source ou contexte"
|
|||
|
|
- label: "Indicateur 2"
|
|||
|
|
valeur: "85%"
|
|||
|
|
description: "Source ou contexte"
|
|||
|
|
```
|
|||
|
|
Note : `valeur` est une chaîne. Les valeurs courtes (≤6 car.) s'affichent en
|
|||
|
|
très grand, les valeurs longues sont réduites automatiquement.
|
|||
|
|
|
|||
|
|
### Comparaison
|
|||
|
|
|
|||
|
|
**two_cols_text** — deux colonnes en cartes (gauche navy, droite corail)
|
|||
|
|
Requis : `titre, left, right`
|
|||
|
|
```yaml
|
|||
|
|
- layout: two_cols_text
|
|||
|
|
titre: "Titre affirmatif"
|
|||
|
|
left:
|
|||
|
|
titre: "Titre colonne gauche"
|
|||
|
|
bullets:
|
|||
|
|
- texte: "Premier point"
|
|||
|
|
- texte: "Deuxième point"
|
|||
|
|
right:
|
|||
|
|
titre: "Titre colonne droite"
|
|||
|
|
bullets:
|
|||
|
|
- texte: "Premier point"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**comparison_table** — tableau comparatif multi-critères
|
|||
|
|
Requis : `titre, headers, rows` (max ~5 colonnes, 8 lignes)
|
|||
|
|
```yaml
|
|||
|
|
- layout: comparison_table
|
|||
|
|
titre: "Titre affirmatif"
|
|||
|
|
headers: ["Critère", "Option A", "Option B"]
|
|||
|
|
rows:
|
|||
|
|
- label: "Premier critère"
|
|||
|
|
values: ["Valeur A", "Valeur B"]
|
|||
|
|
- label: "Deuxième critère"
|
|||
|
|
values: ["Valeur A", "Valeur B"]
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**from_to_pairs** — transformation avant/après
|
|||
|
|
Requis : `titre, pairs` · Optionnel : `label_from, label_to` (max 5 paires)
|
|||
|
|
```yaml
|
|||
|
|
- layout: from_to_pairs
|
|||
|
|
titre: "Titre affirmatif"
|
|||
|
|
label_from: "SITUATION ACTUELLE"
|
|||
|
|
label_to: "SITUATION CIBLE"
|
|||
|
|
pairs:
|
|||
|
|
- from: "État de départ"
|
|||
|
|
to: "État cible"
|
|||
|
|
- from: "Autre point"
|
|||
|
|
to: "Autre cible"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Concept / Texte
|
|||
|
|
|
|||
|
|
**circular_diagram** — 3 à 6 cercles + légende
|
|||
|
|
Requis : `titre, segments`
|
|||
|
|
```yaml
|
|||
|
|
- layout: circular_diagram
|
|||
|
|
titre: "Titre affirmatif"
|
|||
|
|
segments:
|
|||
|
|
- label: "Concept 1"
|
|||
|
|
description: "Description courte"
|
|||
|
|
- label: "Concept 2"
|
|||
|
|
description: "Description courte"
|
|||
|
|
- label: "Concept 3"
|
|||
|
|
description: "Description courte"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**default_bullets** — liste de points (max 5)
|
|||
|
|
Requis : `titre, bullets`
|
|||
|
|
Le format « Mot-clé : explication » met le mot-clé en gras navy.
|
|||
|
|
```yaml
|
|||
|
|
- layout: default_bullets
|
|||
|
|
titre: "Titre affirmatif"
|
|||
|
|
bullets:
|
|||
|
|
- texte: "Mot-clé : explication du point"
|
|||
|
|
niveau: 1
|
|||
|
|
- texte: "Autre mot-clé : explication"
|
|||
|
|
niveau: 1
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Process / Planning
|
|||
|
|
|
|||
|
|
**numbered_steps** — étapes en cartes avec badge numéroté (2 à 5)
|
|||
|
|
Requis : `titre, steps`
|
|||
|
|
```yaml
|
|||
|
|
- layout: numbered_steps
|
|||
|
|
titre: "Titre affirmatif"
|
|||
|
|
steps:
|
|||
|
|
- numero: 1
|
|||
|
|
titre: "Première étape"
|
|||
|
|
description: "Ce que ça implique"
|
|||
|
|
- numero: 2
|
|||
|
|
titre: "Deuxième étape"
|
|||
|
|
description: "Ce que ça implique"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**process_arrow** — flux horizontal de 3 à 6 étapes (sans dates)
|
|||
|
|
Requis : `titre, steps`
|
|||
|
|
```yaml
|
|||
|
|
- layout: process_arrow
|
|||
|
|
titre: "Titre affirmatif"
|
|||
|
|
steps:
|
|||
|
|
- titre: "Étape 1"
|
|||
|
|
description: "Ce qui se passe"
|
|||
|
|
- titre: "Étape 2"
|
|||
|
|
description: "Ce qui se passe"
|
|||
|
|
- titre: "Étape 3"
|
|||
|
|
description: "Ce qui se passe"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**phases_timeline** — phases avec périodes
|
|||
|
|
Requis : `titre, phases`
|
|||
|
|
```yaml
|
|||
|
|
- layout: phases_timeline
|
|||
|
|
titre: "Titre affirmatif"
|
|||
|
|
phases:
|
|||
|
|
- label: "Mois 1-2"
|
|||
|
|
periode: "Ce qui se passe"
|
|||
|
|
- label: "Mois 3-8"
|
|||
|
|
periode: "Ce qui se passe"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**gantt_timeline** — Gantt par workstreams
|
|||
|
|
Requis : `titre, periods, workstreams` (max 3 workstreams, 4 tâches chacun)
|
|||
|
|
`start`/`end` = index dans `periods` (0-based).
|
|||
|
|
```yaml
|
|||
|
|
- layout: gantt_timeline
|
|||
|
|
titre: "Titre affirmatif"
|
|||
|
|
periods: ["Juin", "Juil", "Août", "Sept"]
|
|||
|
|
workstreams:
|
|||
|
|
- label: "Workstream 1"
|
|||
|
|
tasks:
|
|||
|
|
- label: "Tâche A"
|
|||
|
|
start: 0
|
|||
|
|
end: 2
|
|||
|
|
- label: "Workstream 2"
|
|||
|
|
tasks:
|
|||
|
|
- label: "Tâche B"
|
|||
|
|
start: 1
|
|||
|
|
end: 3
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**yearly_timeline** — frise chronologique
|
|||
|
|
Requis : `titre, milestones` (max 6, `actif: true` met le jalon en corail)
|
|||
|
|
```yaml
|
|||
|
|
- layout: yearly_timeline
|
|||
|
|
titre: "Titre affirmatif"
|
|||
|
|
milestones:
|
|||
|
|
- annee: "2024"
|
|||
|
|
label: "Premier jalon"
|
|||
|
|
- annee: "2025"
|
|||
|
|
label: "Deuxième jalon"
|
|||
|
|
- annee: "2026"
|
|||
|
|
label: "Jalon courant"
|
|||
|
|
actif: true
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Gouvernance / Organisation / Décision
|
|||
|
|
|
|||
|
|
**raci_table** — matrice RACI
|
|||
|
|
Requis : `titre, roles, tasks` (max 4 rôles, 8 tâches)
|
|||
|
|
Lettres : R (Responsable, corail), A (Autorité, navy), C (Consulté, slate), I (Informé, muted).
|
|||
|
|
```yaml
|
|||
|
|
- layout: raci_table
|
|||
|
|
titre: "Titre affirmatif"
|
|||
|
|
roles: ["Rôle 1", "Rôle 2", "Rôle 3"]
|
|||
|
|
tasks:
|
|||
|
|
- label: "Première activité"
|
|||
|
|
raci: ["A", "R", "C"]
|
|||
|
|
- label: "Deuxième activité"
|
|||
|
|
raci: ["A", "I", "R"]
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**org_chart** — organigramme (max 3 niveaux)
|
|||
|
|
Requis : `titre, root`
|
|||
|
|
Les `children` peuvent être des objets `{label, children}` OU de simples
|
|||
|
|
chaînes. Max 4 enfants directs, 3 petits-enfants par enfant (au-delà, ça serre).
|
|||
|
|
```yaml
|
|||
|
|
- layout: org_chart
|
|||
|
|
titre: "Titre affirmatif"
|
|||
|
|
root:
|
|||
|
|
label: "Responsable racine"
|
|||
|
|
children:
|
|||
|
|
- label: "Manager 1"
|
|||
|
|
children:
|
|||
|
|
- "Équipe A"
|
|||
|
|
- "Équipe B"
|
|||
|
|
- label: "Manager 2"
|
|||
|
|
children:
|
|||
|
|
- "Équipe C"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**matrix_2x2** — matrice effort/impact
|
|||
|
|
Requis : `titre, items` · Optionnel : `axis_x, axis_y, quadrants` (max 8 items)
|
|||
|
|
`x` et `y` vont de 0 à 100.
|
|||
|
|
```yaml
|
|||
|
|
- layout: matrix_2x2
|
|||
|
|
titre: "Titre affirmatif"
|
|||
|
|
axis_x:
|
|||
|
|
label: "Effort"
|
|||
|
|
low: "Faible"
|
|||
|
|
high: "Élevé"
|
|||
|
|
axis_y:
|
|||
|
|
label: "Impact"
|
|||
|
|
low: "Faible"
|
|||
|
|
high: "Élevé"
|
|||
|
|
quadrants:
|
|||
|
|
top_left: "Gains rapides"
|
|||
|
|
top_right: "Projets stratégiques"
|
|||
|
|
bottom_left: "Déprioritiser"
|
|||
|
|
bottom_right: "À planifier"
|
|||
|
|
items:
|
|||
|
|
- label: "Initiative A"
|
|||
|
|
x: 30
|
|||
|
|
y: 80
|
|||
|
|
- label: "Initiative B"
|
|||
|
|
x: 70
|
|||
|
|
y: 75
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**recommendation_card** — carte de recommandation (sidebar navy)
|
|||
|
|
Requis : `titre, headline, bullets` · Optionnel : `numero, cta`
|
|||
|
|
```yaml
|
|||
|
|
- layout: recommendation_card
|
|||
|
|
numero: 1
|
|||
|
|
titre: "Nom court de la recommandation"
|
|||
|
|
headline: "TROIS DÉCISIONS À PRENDRE MAINTENANT"
|
|||
|
|
cta: "Décider en réunion du 30 juin"
|
|||
|
|
bullets:
|
|||
|
|
- texte: "Première décision précise"
|
|||
|
|
- texte: "Deuxième décision précise"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 4. Le flux libre (freeform) — composition sur mesure
|
|||
|
|
|
|||
|
|
Pour les slides qui ne rentrent dans aucun layout standard, utilise
|
|||
|
|
`layout: freeform`. La slide est composée de **blocs positionnés sur une
|
|||
|
|
grille 12 × 12** (colonnes 0-12, lignes 0-12). La charte reste **imposée** :
|
|||
|
|
les couleurs ne peuvent être que des tokens nommés (jamais de hex).
|
|||
|
|
|
|||
|
|
Règles de la grille :
|
|||
|
|
- `col` (0-12) = colonne de départ, `row` (0-12) = ligne de départ
|
|||
|
|
- `w` = largeur en colonnes, `h` = hauteur en lignes
|
|||
|
|
- Contraintes : `col + w ≤ 12` et `row + h ≤ 12`
|
|||
|
|
- Maximum 8 blocs par slide
|
|||
|
|
- `mode: light` (fond blanc) ou `mode: dark` (fond navy)
|
|||
|
|
- `footer: false` pour masquer le pied de page (affiché par défaut, même sur fond sombre)
|
|||
|
|
|
|||
|
|
Note : `freeform` est géré directement par le moteur de rendu et ne figure pas
|
|||
|
|
dans `layouts_v2.yaml`. Un validateur basé sur ce fichier peut donc le signaler
|
|||
|
|
comme « layout inconnu » — c'est sans effet, le rendu fonctionne normalement.
|
|||
|
|
|
|||
|
|
Types de blocs disponibles :
|
|||
|
|
| type | description | champs spécifiques |
|
|||
|
|
|---|---|---|
|
|||
|
|
| `title` / `heading` | titre serif | `size` (déf. 28), `align`, `color` |
|
|||
|
|
| `text` | texte courant (Calibri) | `size`, `bold`, `italic`, `serif`, `align`, `color` |
|
|||
|
|
| `stat` | grand chiffre serif corail | `size` (déf. 72), `align`, `color` |
|
|||
|
|
| `circle` | cercle plein (motif charte) | `color` (diamètre = min(w,h)) |
|
|||
|
|
| `badge` | cercle numéroté, texte blanc centré | `text`, `color` |
|
|||
|
|
| `card` | carte arrondie avec ombre | `color` (déf. card) |
|
|||
|
|
| `rect` | rectangle plein | `color`, `rounded` |
|
|||
|
|
| `line` | ligne / séparateur | `color`, `weight` (h:0 = horizontale) |
|
|||
|
|
|
|||
|
|
Tokens couleur autorisés : `navy, navy_light, coral, glacier, slate, card,
|
|||
|
|
white, body, muted`. Aucun hex.
|
|||
|
|
|
|||
|
|
Exemple — slide manifeste (fond sombre, grand chiffre + titre + accent) :
|
|||
|
|
```yaml
|
|||
|
|
- layout: freeform
|
|||
|
|
mode: dark
|
|||
|
|
blocks:
|
|||
|
|
- type: stat
|
|||
|
|
text: "3"
|
|||
|
|
col: 0.5
|
|||
|
|
row: 1
|
|||
|
|
w: 3
|
|||
|
|
h: 4
|
|||
|
|
size: 150
|
|||
|
|
color: coral
|
|||
|
|
align: center
|
|||
|
|
- type: title
|
|||
|
|
text: "trois convictions structurantes"
|
|||
|
|
col: 4
|
|||
|
|
row: 1.5
|
|||
|
|
w: 7.5
|
|||
|
|
h: 3
|
|||
|
|
size: 30
|
|||
|
|
color: white
|
|||
|
|
- type: line
|
|||
|
|
col: 4
|
|||
|
|
row: 4.5
|
|||
|
|
w: 7
|
|||
|
|
h: 0
|
|||
|
|
color: coral
|
|||
|
|
weight: 2
|
|||
|
|
- type: text
|
|||
|
|
text: "Le sous-texte en glacier, italique."
|
|||
|
|
col: 4
|
|||
|
|
row: 5
|
|||
|
|
w: 7.5
|
|||
|
|
h: 2
|
|||
|
|
size: 18
|
|||
|
|
italic: true
|
|||
|
|
color: glacier
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 5. Règles de production (à respecter pour un YAML valide)
|
|||
|
|
|
|||
|
|
1. **Layouts** : utiliser uniquement les 21 noms listés (+ `freeform`).
|
|||
|
|
2. **Champs requis** : chaque layout doit avoir tous ses champs requis, non vides.
|
|||
|
|
3. **Chaînes** : toujours entre guillemets. Échapper les guillemets internes.
|
|||
|
|
4. **Chiffres de contenu** (`valeur`, `stat`) : toujours des chaînes (`"78%"`).
|
|||
|
|
5. **Entiers de structure** (`numero`, `niveau`, `start`, `end`, `x`, `y`) : sans guillemets.
|
|||
|
|
6. **`titre`** : formulation affirmative (le message), jamais un label thématique.
|
|||
|
|
7. **Pas de syntaxe Markdown** dans les valeurs : pas de `**gras**`, pas de `#`.
|
|||
|
|
Le formatage est géré par le moteur, pas par le texte.
|
|||
|
|
8. **Champ optionnel absent** : l'omettre (ne pas mettre `null`).
|
|||
|
|
9. **Freeform** : respecter `col+w ≤ 12`, `row+h ≤ 12`, max 8 blocs, tokens charte uniquement.
|
|||
|
|
10. **Densité** : respecter les maxima par layout (ex. kpi_grid ≤ 6, bullets ≤ 5,
|
|||
|
|
org_chart ≤ 4 branches). Au-delà, le rendu se dégrade.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 6. Sortie attendue
|
|||
|
|
|
|||
|
|
Quand on te demande de produire une présentation au format Pernod Ricard,
|
|||
|
|
tu produis **uniquement le YAML** décrit ci-dessus — rien d'autre. Ce YAML
|
|||
|
|
est destiné à être passé tel quel à `render_engine_v2.py`. Pas de texte
|
|||
|
|
d'introduction, pas de commentaire, pas de Markdown autour : le YAML brut,
|
|||
|
|
directement exploitable.
|