Communitygithub.com

slides-genedit

Générer et modifier des présentations académiques à partir de documents de recherche. Deux modes : (1) générer un nouveau diaporama à partir d'un article/notes avec contraintes de public, durée et nombre de diapositives, incluant preuves textuelles, notes de présentation et aperçu PDF ; (2) modifications préservant la source d'un diaporama existant – inventaire, modifications locales ciblées, vérification d'identité des diapositives non modifiées.

Qu'est-ce que slides-genedit ?

Cette compétence est conçue pour les agents IA (comme Claude Code, Cursor, Codex) afin de transformer des documents de recherche en présentations académiques de haute qualité, tout en assurant une traçabilité rigoureuse des preuves (citations textuelles, numéros). Elle prend en charge deux workflows distincts : la **génération** d'un nouveau diaporama à partir de zéro, avec contraintes de public, durée et nombre de diapositives, et l'**édition** préservant la source d'un diaporama existant, où seules les diapositives explicitement ciblées sont modifiées (les autres restent identiques octet par octet). La valeur ajoutée réside dans les scripts automatisés (dans `scripts/`) qui assurent le parsing, l'assemblage, la vérification et le rendu, tandis que l'agent se concentre sur les décisions éditoriales (sélection, ordonnancement, coupures). Elle fonctionne sur tout système disposant de Python et des dépendances mentionnées dans `README.md`. Le flux comprend 7 étapes clés : extraction des preuves, création du plan, assemblage/modification, rendu PDF, et finalisation d'un `result.json` complet, même en cas d'échec partiel. Les non-négociables incluent l'absence de chiffres inventés, la préservation des masters/layouts en mode édition, et l'honnêteté dans les rapports d'échec.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/qingyulzx/pku-efficiency3-skills/tree/HEAD/slides-genedit

Demander à votre IA préférée

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

Documentation

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 des notes de 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 evidence de 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.md et reference/ ; lisez-les avant de vous écarter.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

biopathway-mechanism-diagram

Build or edit publication-grade biological mechanism/pathway diagrams from research materials (PDF/text) as a challengeable mechanism statement - three-layer model (typed entities, typed directed edges with verbatim evidence, compartment layout), semantics-correct SVG source, PNG/PDF exports and a traceable, uncertainty-aware result.json. Use for tasks asking to draw, generate or edit signaling pathways, mechanism figures, crosstalk diagrams or pathway flowcharts; refuses to guess regulation direction and marks unstated information instead.

graphical-abstract-builder

Build a single-page graphical abstract (question, method, results, conclusion) from research material as a traceable, editable SVG with PNG/PDF exports. Use when asked to create or edit a graphical abstract, science summary figure, mechanism or flow diagram, or data chart from a paper, study notes or experimental records, especially when editable source files and element-to-source traceability are required.

paper-to-academic-ppt

Turn a research paper (PDF) into a structured, evidence-traceable, template-compliant academic slide deck. Two phases: agent-authored narrative spine and page-level claims (each with paper locators and verbatim quotes), then scripted template adaptation that writes content into real master/layout placeholders, embeds original paper figures, checks overflow/aspect/notes, and exports a PDF preview. Handles missing conclusions, figure-trimming, layout mismatch and over-limit slide counts with explicit rules.

relationship-schematic

Generate or edit scientific entity-relationship schematics (mechanism diagrams, pathway chains, experimental workflows, structural containment) as traceable, editable SVG with verified relation semantics. Extracts an evidence-quoted entity/relation table first, renders a layered SVG from it, reads the drawing back to verify every relation type, direction and containment, then exports 300-dpi PNG and vector PDF. Use for any "draw a mechanism/workflow/relationship figure from this paper or case material" task where scientific correctness of entities, arrow directions and hierarchy matters.

Skills associés