slides-genedit — génération et édition préservant la source de présentations PPT académiques
Vous transformez des documents de recherche (article, notes, diaporama existant) en une présentation académique modifiable et tracée par les preuves — et vous modifiez des diaporamas existants sans casser ce que vous n'avez pas été invité à toucher. La partie difficile est la sélection et l'ordonnancement, pas la copie de paragraphes : quel résultat mérite sa propre diapo, combien de puces une méthode nécessite, quelle figure vient en premier, ce qui est coupé lorsque le budget de diapositives est dépassé. Vous prenez ces décisions rédactionnelles ; les scripts dans scripts/ effectuent le travail déterministe (parsing, assemblage, vérification, rendu). N'assemblez jamais manuellement du XML quand un script existe.
Aiguillage des routes (décider d'abord, ne jamais mélanger)
Lisez /input/case.json et task.md. Exécutez l'étape 1 ci-dessous — parse_case.py affiche une indication de route avec ses preuves. Confirmez par rapport à la formulation de la tâche :
- GÉNÉRER — aucun diaporama de départ dans les entrées (documents de recherche + contraintes de public/durée/nombre de diapositives + modèle). Construisez un nouveau diaporama.
- MODIFIER — un diaporama de départ (.pptx) est fourni ET la demande demande des modifications locales (修改/压缩/换受众/加页/删页/调整). Inventoriez-le et appliquez des opérations chirurgicales. La modification doit préserver : les diapositives non modifiées identiques octet par octet, les masters/layouts intacts, le style du modèle, les notes des diapositives non ciblées.
- Si un diaporama existe mais que la demande réécrit la plupart du contenu ou réorganise l'ensemble du récit, il s'agit d'un génération déguisée — construisez un nouveau diaporama à partir du même modèle et conservez le diaporama de départ comme version N-1. Enregistrez la décision de route et ses preuves.
Discipline budgétaire tout au long : ~7 étapes d'outils est le point idéal, 64 requêtes de modèle / 900 s au total. L'étape 1 écrit déjà un skeleton result.json complet, donc un crash après cela laisse quand même un livrable vérifiable. Améliorez-le de manière incrémentale ; ne le laissez jamais à l'état de squelette.
Étape 1 — analyser les entrées, écrire le socle de result.json (les deux routes)
python scripts/parse_case.py --input /input/case.json --workdir /app/work --output-dir /app/output
Lisez l'indication de route imprimée ET le texte réel de la tâche avant de vous engager sur une route (l'indication est une preuve, pas un verdict). Vérifiez l'analyse des contraintes (case-parsed.json) par rapport à task.md vous-même — les analyses par mots-clés manquent et font des sur-correspondances ; le libellé de la tâche prévaut. Lisez tous les fichiers d'entrée qui existent (material*.md/pdf/tex, figures) ; pour les PDF, utilisez pdf-text-tool / pdf-render-tool / ocr-tool selon disponibilité. Ne présumez jamais du contenu à partir des noms de fichiers.
Étape 2 — extraction avec capture textuelle (génération)
À partir du matériel réel, extrayez : question de recherche, méthode, résultats, limitations (la colonne vertébrale narrative). Pendant la lecture, capturez des citations textuelles avec emplacements (section, tableau, figure) pour chaque nombre et affirmation susceptible d'apparaître sur une diapositive — c'est la cartographie des preuves, collectée une fois, réutilisée aux étapes 3 et 7. Si le matériel manque de conclusions/résultats, appliquez reference/exception-playbook.md #1 : marquez les inférences, n'inventez jamais.
Étape 3 — plan niveau page : votre jugement, enregistré (génération)
Rédigez /app/work/outline.json selon reference/schemas.md. C'est l'étape intellectuelle centrale — faites-la vous-même, pas par modèle :
- Une page = une affirmation. Le titre énonce le message de la page ("Résultat : erreur de forme 38,2 % inférieure au même taux de compression", pas "Résultats expérimentaux"). Chaque diapositive reçoit un
role(problem/method/result/limitation/...) et desnotesde présentation (le script de l'exposé — un diaporama sans notes est incomplet). - Nombres textuellement. Copiez les chiffres du matériel exactement (28,4 BLEU, pas ~28 ; 41,8, pas 42). La source de chaque nombre va dans la section
evidencede cette diapositive. Si vous ne trouvez pas la source d'un nombre, il ne va pas sur une diapositive. - Sélection pour le public/le budget temps. ~1 diapositive par 1–2 minutes. Collègues : les détails de la méthode comptent. Comité de suivi : l'avancement et le plan comptent. Soutenance : les contributions et les preuves comptent. Ordonnez les résultats par force narrative (est-ce bon ? → combien ? → ça tient ?), pas par ordre de section de l'article.
- Figures : citez l'image originale avec sa légende textuelle lorsque la source est une image bitmap ; ne redessinez que lorsque la table de données existe. Les résultats uniquement sous forme d'image méritent leur propre page ; les figures secondaires fusionnent ou vont dans les pages de sauvegarde après la diapositive de clôture.
- Journal
decisions: chaque élément conservé/coupé/fusionné/réorganisé avec une raison ("coupé tableau 2 ablation — budget de diapositives 6 pages, résultats principaux prioritaires"). C'est à la fois votre artefact de vérifiabilité et le matériel d'étude de cas ; des décisions vides sont un bogue.
Étape 4 — assembler le diaporama (génération)
python scripts/assemble_deck.py --outline /app/work/outline.json \
--template <template.pptx si fourni> --out /app/output/deck_v1.pptx \
--workdir /app/work/scratch
Lisez assembly-report.json. Corrigez le plan (pas le diaporama) lorsqu'il signale un risque de débordement, des replis de mise en page ou un dépassement de budget, puis relancez — le diaporama et le journal des décisions doivent rester cohérents. Les scripts garantissent : le contenu atterrit dans les espaces réservés des diapositives (clonés depuis la mise en page si manquants — écrire dans les espaces réservés de la mise en page ne s'affiche pas), les images sont recadrées par aspect (pas déformées), les notes sont attachées.
Étape 2' — inventorier le diaporama de départ (modification)
python scripts/inventory_deck.py --deck <starting.pptx> --out /app/work/inventory.json
Lisez l'inventaire. Localisez les cibles exactes que l'instruction nomme (index de diapositive + idx d'espace réservé / nom de forme). Si une cible de modification n'existe pas, appliquez le playbook #8 : échouez bruyamment, reciblez ou ajoutez — ne sautez jamais silencieusement.
Étape 3' — rédiger les opérations chirurgicales (modification)
Rédigez /app/work/ops.json selon reference/schemas.md (schéma des opérations). Les opérations s'appliquent dans l'ordre sur les indices de diapositives basés sur 1. Couvrez UNIQUEMENT ce que l'instruction demande : replace_text pour les puces réécrites (le formatage existant est préservé), append_bullets, set_notes, insert_image (recadrage par aspect), add_slide, delete_slide, move_slide, duplicate_slide. Une réécriture complète du diaporama via des opérations est une mauvaise utilisation — changez de route à la place.
Étape 4' — appliquer les modifications et vérifier la préservation (modification)
python scripts/edit_deck.py --deck <starting.pptx> --ops /app/work/ops.json \
--out /app/output/deck_v2.pptx --workdir /app/work/scratch
Vérifiez edit-report.json : toutes les opérations ok ; slides_identical_raw >= diapositives source − diapositives touchées ; masters_untouched et layouts_untouched vrai. Si les diapositives non touchées ne sont même pas structurellement identiques, la modification a fui — playbook #9. Refaites le rendu, puis livrez.
Étape 5 — rendu et vérification (les deux routes)
python scripts/render_check.py --pptx /app/output/deck_v1.pptx --outdir /app/output/render/
L'aperçu PDF doit exister avec un nombre de pages == nombre de diapositives. Inspectez l'aperçu pour détecter les débordements, les substitutions de polices, les images rognées (utilisez pdf-render-tool / office-renderer si disponible). La substitution de polices dans l'aperçu est enregistrée comme incertitude — NE réécrivez PAS les polices du modèle du diaporama pour satisfaire le rendu (playbook #4). Si le rendu est impossible, conservez le .pptx et enregistrez l'échec honnêtement (playbook #6).
Étape 6 — itérer délibérément (les deux routes)
Les retours utilisateur arrivent comme une nouvelle instruction de modification sur le diaporama actuel : revenez à l'étape 2' (route modification) sur la dernière version. Conservez les versions précédentes (deck_v1.pptx, deck_v2.pptx, ...) — n'écrasez jamais ; chaque rapport de rendu plus le journal des opérations/diff des décisions est l'enregistrement de version. Vérifiez la régression à chaque tour : les diapositives non touchées sont-elles restées identiques ?
Étape 7 — finaliser result.json (les deux routes)
Mettez à jour /app/output/result.json (le squelette de l'étape 1) avec les valeurs finales : chaque champ output_contract de case.json rempli — fichier de présentation, nombre de diapositives, cartographie des preuves par diapositive (emplacement + citation textuelle), chemin de l'aperçu rendu, état des notes de présentation ; les exécutions de modification ajoutent le journal des opérations et la matrice de préservation. Les champs que vous n'avez pas pu produire honnêtement restent null avec la raison dans unanswered. status ∈ complete | partial (nommez les limites). Arrêtez-vous ensuite — livrez le .pptx, les notes, l'aperçu PDF et result.json.
Non-négociables
- Les nombres/citations sur les diapositives renvoient aux sources capturées textuellement ; pas de chiffres inventés, pas de redessins approximatifs, pas d'arrondis silencieux.
- La route modification ne touche jamais aux masters/layouts ni aux diapositives non ciblées ; la matrice de préservation le prouve.
- Échec honnête plutôt que succès falsifié dans result.json, toujours.
- Les modèles, dépendances, schémas et le playbook d'exceptions se trouvent dans
README.mdetreference/; lisez-les avant de vous écarter.