pptx-reference-deck-analysis

Par wshobson · agents

À utiliser pour analyser un fichier PPTX de référence en lecture seule : structure, thème, typographie, rythme de mise en page, diagnostics, catalogues de modèles dérivés ou inspection sécurisée du package OOXML.

npx skills add https://github.com/wshobson/agents --skill pptx-reference-deck-analysis

Analyse de pont de référence PPTX

Inspecter un pont de référence comme preuve de conception. Cette compétence ne copie, clone ou mute jamais un pont source.

Contrat

Implémenter l'extraction requise à la demande avec un petit script python-pptx local à la tâche. Capturer uniquement les informations nécessaires pour le nouveau pont :

  • contexte de prompt compact : nombre et taille des diapositives, résumés textuels, comptage des formes, styles, signaux de marque, utilisation de modèle et rythme de mise en page ;
  • extraction complète : summary, diapositives et preuve layout_tree en lecture seule ;
  • diagnostics de dossier : un résultat par pont plus un manifeste ;
  • analyse de style-maître : couleurs, polices, distribution des tailles, utilisation de maître/mise en page et motifs de flux ;
  • catalogue de modèles dérivés : indices source de base zéro, rôles de mise en page, régions utilisables, espaces réservés, structures visuelles et contraintes.

Règles

  • Garder le pont source en lecture seule et authorer indépendamment chaque coordonnée de diaporama cible.
  • Utiliser les utilitaires OOXML groupés uniquement pour les thèmes bruts, relations, notes, commentaires, animations, médias, maîtres ou mises en page que l'extraction haut niveau ne peut pas exposer.
  • Enregistrer les parties inspectées et les exceptions d'analyse dans le manifeste d'analyse.
  • Ne pas utiliser le contenu extrait, les polices, les images ou les ressources propriétaires dans un pont généré sans permission explicite et preuve de licence.

Inspection de package OOXML

Installer defusedxml depuis requirements.txt avant d'utiliser les utilitaires groupés.

  1. Exécuter scripts/inspect.py <deck.pptx> pour un rapport JSON compact d'ordre des diapositives, texte, jetons de thème, relations, notes, commentaires, animations et médias.
  2. Exécuter scripts/validate_package.py <deck.pptx> --output <report.json> pour XML mal formé, relations internes cassées, lacunes de type de contenu, liens de mise en page en doublon et parties orphelines.
  3. Exécuter scripts/unpack.py <deck.pptx> <output-dir> uniquement quand une preuve brute de package est nécessaire.
  4. Résoudre les cibles de relation relativement au propriétaire .rels ; ne jamais déduire l'ordre des diapositives à partir des noms de fichiers.

Sécurité

  • Ne jamais modifier un pont fourni ou copier aveuglément des parties de package dans un nouveau pont.
  • Exécuter les scripts depuis un espace de travail de confiance ; ils rejettent la traversée de chemin, les symlinks, les membres surdimensionnés et les bombes d'archives.
  • Analyser le XML non approuvé avec defusedxml ; ne pas activer l'expansion d'entité, le chargement de DTD ou l'accès réseau.
  • Traiter les couleurs de thème comme des jetons à moins qu'elles ne soient complètement résolues par rapport au schéma de couleurs.

Voir references/reference-deck-analysis.md pour les formes de sortie, references/reference-deck-analysis-patterns.md pour les motifs documentation uniquement, et references/ooxml-parsing.md pour les cartes de parties de package.

Skills similaires