Communitygithub.com

ye4wzp/zifeiyu-ppt-skill

Verrouillage de la conception des diapositives HTML avec export PPTX déterministe — une compétence d'agent pour Claude Code.

Qu'est-ce que zifeiyu-ppt-skill ?

Cette compétence d'agent transforme un contenu structuré en présentations HTML avec une conception verrouillée, garantissant des exports PPTX, PDF et PNG déterministes et cohérents. Elle est conçue pour Claude Code et repose sur un système de 13 mises en page enregistrées, interdisant toute déviation par rapport aux règles de conception définies (classes CSS, jetons de couleur, déclarations de polices). L'agent suit un flux de travail rigoureux en 8 étapes : clarification des besoins, vérification des faits, construction du deck, validation par échantillon, production en masse, validation automatique, inspection visuelle et livraison. Les decks sont autonomes, distribuables en un seul répertoire, et prennent en charge les thèmes prédéfinis (paper, graphite, forest). Cette approche élimine les erreurs de conception courantes et garantit que le HTML est la seule source de vérité, les exports PPTX/PNG étant de simples dérivés.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add ye4wzp/zifeiyu-ppt-skill

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Compétence PPT

Placez le contenu dans les 13 mises en page enregistrées pour produire un deck HTML à une seule page ; le HTML est la seule source, PPTX / PNG sont des dérivés en un clic.

Contraintes strictes (toute violation entraîne une reprise)

  1. Interdiction d'écrire du HTML à partir de zéro. Le deck ne peut être créé qu'en copiant templates/seed.html. Les diapositives ne peuvent être créées qu'en copiant les squelettes enregistrés de references/layouts.md et en remplaçant le contenu textuel.
  2. Interdiction d'inventer des noms de classe. Seules les classes déjà définies dans base.css peuvent être utilisées ; le validateur rejettera toute classe hors de la liste blanche.
  3. Interdiction des valeurs de couleur brutes et des déclarations de police. Les couleurs ne sont utilisées que via des jetons ; le style en ligne est autorisé uniquement pour les valeurs paramétriques de top/left/width/height/font-size/line-height.
  4. Chaque page doit déclarer data-layout="Lxx" (L01–L13).
  5. Le texte ne peut être que dans h1/h2/h3/p ; les éléments décoratifs utilisent div[data-shape="rect|ellipse"] ; les images utilisent <img>, interdiction d'utiliser background-image pour les images de contenu.
  6. Honnêteté des données : les mises en page de données comme L07/L11 doivent utiliser les vraies valeurs fournies par l'utilisateur, toute invention est interdite ; si aucune donnée réelle n'est disponible, utilisez une mise en page conceptuelle.
  7. Discipline de densité par page : 1 information principale + maximum 4 points de support ; au-delà, divisez la page ; les pages adjacentes ne doivent pas répéter la même mise en page.
  8. Utilisation cohérente du thème : un thème par deck, pas de mélange de thèmes par page.

Flux de travail

Étape 1 · Clarification et cadrage (question unique, pas plus de 5 questions)

  • Q1 Format de livraison (obligatoire, détermine le cadrage, ne peut être changé par la suite) : démonstration uniquement sur le Web → version Web ; nécessité de modifier un fichier .pptx → version Office.
  • Q2 Public et contexte → recommander 2–3 thèmes selon la table de correspondance de references/themes.md.
  • Q3 Nombre de pages ou durée.
  • Q4 Contenu existant (plan / documents / données / images / logo).
  • Q5 Contraintes strictes. Les couleurs de marque ne sont acceptées que si l'utilisateur a des directives de marque claires, sinon utiliser un thème prédéfini.

Étape 2 · Vérification des actifs et des faits (obligatoire lorsqu'il s'agit d'institutions/produits/données réels)

  • Les faits d'abord : tous les chiffres, dates, noms dans les déclarations externes doivent avoir une source – données de première main fournies par l'utilisateur ou publications officielles vérifiées en ligne ; chaque point doit être traçable, les KPI doivent inclure des notes de bas de page indiquant la source. Pour les données impossibles à vérifier, utiliser une mise en page conceptuelle, interdiction d'inventer.
  • Sélection des photos : si plus de 10 photos candidates, créez d'abord une contact-sheet (image de prévisualisation en grille) avant de sélectionner, ne lisez pas les images une par une.
  • Évitement du texte sur les images : pour les mises en page avec images L09/L14/L01, après avoir sélectionné une image, lisez-la pour confirmer l'emplacement du sujet (logo, visage, produit) ; le titre et le masque doivent tomber dans une zone calme de l'image ; si le sujet est coupé, changez d'image, ne forcez pas.

Étape 3 · Construction du deck

mkdir -p <deck-dir>/assets && cp templates/seed.html <deck-dir>/index.html
cp -r assets/base.css assets/runtime.js assets/themes <deck-dir>/assets/

Modifiez <link id="theme"> selon le thème choisi ; remplacez <title>. Le deck est autonome et peut être distribué comme un répertoire complet.

Étape 4 · Validation par échantillon (obligatoire si deck ≥ 5 pages)

Créez d'abord seulement deux pages : la couverture (L01) + la page de contenu la plus typique. Prenez une capture d'écran à montrer à l'utilisateur pour validation avant d'entrer en production de masse. Corrigez les erreurs de direction sur 2 pages, pas de reprise sur 13 pages.

Étape 5 · Remplissage en masse

Commencez par sélectionner un modèle narratif dans references/narratives.md (pitch / rapport / promotion) pour déterminer l'ordre des pages, puis page par page : copiez le squelette de references/layouts.md → remplacez uniquement le texte/les images → vérifiez la densité. Placez les images dans <deck-dir>/assets/img/, nommez-les {numéro de page}-{sens}.{ext}.

Étape 6 · Validation automatique (première porte)

node scripts/validate.mjs <deck-dir>          # version Web
node scripts/validate.mjs <deck-dir> --office # version Office

Toutes les erreurs doivent être éliminées. Ordre de traitement des débordements : simplifier le texte → ajuster le style en ligne paramétrique → changer de mise en page ; interdiction de réduire la taille de police en dessous de 16 px.

Étape 7 · Auto-inspection visuelle (deuxième porte)

node scripts/render-png.mjs <deck-dir>

Examinez chaque page rendue, vérifiez selon les niveaux P0–P3 de references/checklist.md ; les problèmes P0/P1 doivent être corrigés.

Étape 8 · Livraison

Version Web : livrez le répertoire deck (ouvrez index.html dans un navigateur, flèches pour naviguer, F pour le plein écran, S pour ouvrir la console orateur – synchronisation en deux fenêtres, aperçu de la page suivante, minuteur, notes du discours). Rédaction des notes : à la fin de chaque page, vous pouvez ajouter <aside class="notes"><p>Indice</p></aside>, visible uniquement par l'orateur, jamais rendu ou exporté. Écrivez des "signaux d'indice" (≤3 phrases courtes par page), ne rédigez pas de script mot-à-mot. Ajoutez au besoin :

node scripts/export-pdf.mjs <deck-dir>                            # PDF vectoriel (disponible pour les deux versions)
node scripts/export-pptx.mjs <deck-dir> --cjk-font "Microsoft YaHei"  # version Office

Après l'export, effectuez une troisième porte : ouvrez le fichier .pptx dans un logiciel de présentation et comparez-le page par page avec les rendus HTML (voir references/pptx-export.md pour plus de détails).

Tableau récapitulatif des mises en page

NuméroMise en pageUtilisation
L01CouvertureOuverture : accroche + grand titre + sous-titre + méta-informations
L02Table des matières3–5 points de l'ordre du jour
L03Séparation de chapitreGrand numéro + nom du chapitre, changement de rythme
L04Déclaration de point de vueUn seul point en grand, mise en évidence unique
L05Comparaison à deux colonnesDeux options / comparaison avant-après, deux panneaux
L06Argumentation en trois pointsTrois preuves parallèles
L07Grands chiffres KPI2–3 indicateurs de données réels
L08ChronologieÉvolution horizontale à 4 jalons
L09Visuel principal avec imageImage pleine page + titre avec masque
L10Texte principal + points clésTexte long à gauche, trois points clés à droite, page de contenu standard
L11Lignes de registre4 lignes d'informations structurées label–valeur–note
L12Étapes de processusProcessus en 4 étapes
L13FinMessage de clôture + méta-informations

Thèmes

paper (par défaut, blanc chaud) · graphite (foncé) · forest (vert froid). Les critères de sélection se trouvent dans references/themes.md.

Documents de référence (lire selon les besoins, ne pas charger en totalité)

  • references/layouts.md — Squelettes complets copiables pour les 13 mises en page + utilisation des éléments décoratifs rythmiques.
  • references/narratives.md — Trois modèles de séquence de pages pour les présentations : pitch / rapport / promotion.
  • references/themes.md — Catalogue des thèmes et correspondance avec le public.
  • references/authoring.md — Règles de densité de texte, tailles de police pour le chinois.
  • references/pptx-export.md — Contraintes pour la version Office, stratégie de police, dépannage de l'export.
  • references/checklist.md — Liste de contrôle visuelle P0–P3.
  • references/animations.md — Recettes d'animations sémantiques pour le mode présentation (appliquées automatiquement, sans affecter les exports).

Skills associés