Communitygithub.com

slides-genedit

Gere e edite apresentações acadêmicas a partir de material de pesquisa. Duas rotas: (1) gerar uma nova apresentação a partir de um artigo/anotações com restrições fixas de público, duração e número de slides, com afirmações por slide, mapeamento de evidências com citações literais, notas do apresentador e visualização em PDF; (2) edições preservando a fonte de uma apresentação existente - inventarie-a, aplique apenas as alterações locais solicitadas e prove que os slides não alterados permanecem byte-idênticos. Use quando for solicitado a transformar material de pesquisa em slides ou modificar/compactar/redirecionar para novo público uma apresentação existente sem quebrá-la.

O que é slides-genedit?

Este skill para agentes de IA (como Claude Code, Cursor ou Codex) lida com a geração e edição de apresentações acadêmicas em PowerPoint (.pptx). Ele possui duas rotas principais: **GERAR** — cria uma nova apresentação a partir de material de pesquisa (artigo, anotações, figuras) sob restrições de público, tempo e número de slides, extraindo evidências literais (citações com localização) e montando um deck com notas do apresentador, mapeamento de evidências por slide e visualização em PDF; **EDITAR** — modifica cirurgicamente uma apresentação existente, preservando slides, layouts e mestres não alterados, com verificação de identidade byte-a-byte. O skill exige que o agente tome decisões de curadoria (seleção e ordenação de conteúdo) e usa scripts Python determinísticos para as etapas de parse, montagem, edição e verificação. Ele impõe disciplina de orçamento (cerca de 7 passos de ferramenta, 64 requisições de modelo, 900 segundos) e garante que falhas honestas sejam registradas, não encobertas. O resultado final é um deck, notas, visualização PDF e um arquivo result.json com mapeamento completo de evidências.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

slides-genedit — geração e edição acadêmica de PPT com preservação de fonte

Você transforma material de pesquisa (artigo, anotações, apresentação inicial) em uma apresentação acadêmica editável e com rastreamento de evidências — e edita decks existentes sem quebrar o que não foi solicitado alterar. A parte difícil é seleção e ordenação, não copiar parágrafos: qual resultado merece sua própria página, quantos bullets um método precisa, qual figura vem primeiro, o que é cortado quando o orçamento de páginas é excedido. Você faz esses julgamentos; os scripts em scripts/ fazem o trabalho determinístico (parse, montagem, verificação, renderização). Nunca monte XML manualmente quando um script existe.

Roteamento de rota (decida primeiro, nunca misture)

Leia /input/case.json e task.md. Execute o passo 1 abaixo — parse_case.py imprime uma dica de rota com suas evidências. Confirme com o texto da tarefa:

  • GERAR — nenhum deck inicial nos inputs (material de pesquisa + restrições de público/tempo/número de slides + template). Construa um novo deck.
  • EDITAR — um deck inicial (.pptx) é fornecido E a instrução pede alterações locais (修改/压缩/换受众/加页/删页/调整). Inventarie-o e aplique operações cirúrgicas. A edição deve preservar: slides não alterados byte-idênticos, mestres/layouts intocados, estilo do template, notas de slides não visados.
  • Se um deck existe mas a instrução reescreve a maior parte do conteúdo ou reordena toda a narrativa, isso é uma execução de geração disfarçada — construa do zero com o mesmo template e mantenha o deck inicial como versão N-1. Registre a decisão de rota e suas evidências.

Disciplina de orçamento durante todo o processo: ~7 passos de ferramenta é o ideal, 64 requisições de modelo / 900 s no total. O passo 1 já escreve um result.json esqueleto completo (contrato), para que uma falha após esse ponto ainda deixe um entregável verificável. Melhore-o incrementalmente; nunca o deixe como o esqueleto.

Passo 1 — parse dos inputs, escreva o piso do result.json (ambas as rotas)

python scripts/parse_case.py --input /input/case.json --workdir /app/work --output-dir /app/output

Leia a dica de rota impressa E o texto real da tarefa antes de se comprometer com uma rota (a dica é evidência, não veredito). Verifique a varredura de restrições (case-parsed.json) contra task.md você mesmo — varreduras de palavras-chave erram e superestimam; o texto da tarefa prevalece. Leia todo arquivo de input que existir (material*.md/pdf/tex, figuras); para PDFs use pdf-text-tool / pdf-render-tool / ocr-tool conforme disponível. Nunca assuma conteúdo a partir de nomes de arquivo.

Passo 2 — extração com captura literal (gerar)

A partir do material real, extraia: pergunta de pesquisa, método, resultados, limitações (a espinha narrativa). Durante a leitura, capture citações literais com localizações (seção, tabela, figura) para todo número e afirmação que possa aparecer em um slide — este é o mapa de evidências, coletado uma vez, reutilizado nos passos 3 e 7. Se o material não tiver conclusões/resultados, aplique reference/exception-playbook.md #1: marque inferências, nunca invente.

Passo 3 — esboço por página: seu julgamento, registrado (gerar)

Crie /app/work/outline.json conforme reference/schemas.md. Este é o passo intelectual central — faça você mesmo, não por template:

  • Uma página = uma afirmação. O título expressa a mensagem da página ("Resultados: erro de forma 38,2% menor na mesma taxa de compressão", não "Resultados experimentais"). Cada slide recebe um role (problema/método/resultado/limitação/...) e notes do apresentador (o roteiro da fala — um deck sem notas está incompleto).
  • Números literais. Copie os dígitos do material exatamente (28,4 BLEU, não ~28; 41,8, não 42). A fonte de cada número vai para o evidence daquele slide. Se você não encontrar a fonte de um número, ele não vai para o slide.
  • Seleção para o público/orçamento de tempo. ~1 slide por 1–2 minutos. Colegas de grupo: detalhes do método importam. Comitê de revisão: progresso e plano importam. Defesa: contribuições e evidências importam. Ordene os resultados por força narrativa (é bom? → quanto? → se sustenta?), não pela ordem das seções do artigo.
  • Figuras: cite a imagem original com sua legenda literal quando a fonte for bitmap; redesenhe apenas quando a tabela de dados existir. Resultados apenas com imagem merecem sua própria página; figuras secundárias são mescladas ou vão para páginas de backup após o slide de encerramento.
  • Registro de decisions: cada item mantido/cortado/mesclado/reordenado com uma razão ("cortada Tabela 2 de ablação — orçamento de 6 páginas, resultados principais primeiro"). Este é tanto seu artefato de verificabilidade quanto o material de estudo de caso; decisões vazias são um bug.

Passo 4 — montagem do deck (gerar)

python scripts/assemble_deck.py --outline /app/work/outline.json \
  --template <template.pptx se fornecido> --out /app/output/deck_v1.pptx \
  --workdir /app/work/scratch

Leia assembly-report.json. Corrija o esboço (não o deck) quando ele relatar risco de estouro, fallbacks de layout ou excesso de orçamento, então re-execute — o deck e o registro de decisões devem permanecer consistentes. Os scripts garantem: o conteúdo cai nos placeholders em nível de slide (clonados do layout quando ausentes — escrever em placeholders de layout não renderiza), imagens são recortadas por proporção (não distorcidas), notas são anexadas.

Passo 2' — inventário do deck inicial (editar)

python scripts/inventory_deck.py --deck <starting.pptx> --out /app/work/inventory.json

Leia o inventário. Localize os alvos exatos que a instrução nomeia (índice do slide + índice do placeholder / nome da forma). Se um alvo de edição não existir, aplique o playbook #8: falhe alto, redirecione ou adicione — nunca ignore silenciosamente.

Passo 3' — autor das operações cirúrgicas (editar)

Escreva /app/work/ops.json conforme reference/schemas.md (esquema de ops). As ops se aplicam em ordem a índices de slide baseados em 1. Cubra APENAS o que a instrução pede: replace_text para bullets reescritos (a formatação existente é preservada), append_bullets, set_notes, insert_image (recortado por proporção), add_slide, delete_slide, move_slide, duplicate_slide. Uma reescrita completa do deck através de ops é uso indevido — mude de rota.

Passo 4' — aplicação das edições e verificação de preservação (editar)

python scripts/edit_deck.py --deck <starting.pptx> --ops /app/work/ops.json \
  --out /app/output/deck_v2.pptx --workdir /app/work/scratch

Verifique edit-report.json: todas as ops ok; slides_identical_raw >= source slides − touched slides; masters_untouched e layouts_untouched verdadeiros. Se slides não tocados não forem nem estruturalmente idênticos, a edição vazou — playbook #9. Re-renderize, então entregue.

Passo 5 — renderização e verificação (ambas as rotas)

python scripts/render_check.py --pptx /app/output/deck_v1.pptx --outdir /app/output/render/

A visualização em PDF deve existir com número de páginas == número de slides. Inspecione a visualização em busca de estouro, substituição de fontes, imagens cortadas (use pdf-render-tool / office-renderer conforme disponível). Substituição de fontes na visualização é registrada como incerteza — NÃO reescreva as fontes do template do deck para agradar o renderizador (playbook #4). Se a renderização for impossível, mantenha o .pptx e registre a falha honestamente (playbook #6).

Passo 6 — iterar deliberadamente (ambas as rotas)

O feedback do usuário chega como uma nova instrução de edição no deck atual: volte ao passo 2' (rota de edição) contra a versão mais recente. Mantenha versões anteriores (deck_v1.pptx, deck_v2.pptx, ...) — nunca sobrescreva; cada relatório de renderização mais diff de log de ops/decisões é o registro de versão. Verifique regressão a cada rodada: slides não tocados permaneceram idênticos?

Passo 7 — finalizar result.json (ambas as rotas)

Atualize /app/output/result.json (o esqueleto do passo 1) para valores finais: todo campo output_contract de case.json preenchido — arquivo de apresentação, contagem de slides, mapeamento de evidências por slide (localização + citação literal), caminho da visualização renderizada, status das notas do apresentador; execuções de edição adicionam o log de ops e a matriz de preservação. Campos que você genuinamente não pôde produzir permanecem null com a razão em unanswered. status ∈ complete | partial (nomeie os limites). Então pare — entregue o .pptx, notas, visualização PDF e result.json.

Inegociáveis

  • Números/citações nos slides rastreiam para fontes capturadas literalmente; sem figuras inventadas, sem redesenho de olho, sem arredondamento silencioso.
  • Rota de edição nunca toca em mestres/layouts ou slides não visados; a matriz de preservação prova isso.
  • Falha honesta sempre supera sucesso fingido no result.json.
  • Templates, dependências, esquemas e o playbook de exceções estão em README.md e reference/; leia-os antes de desviar.

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.

Habilidades Relacionadas