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/...) enotesdo 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
evidencedaquele 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.mdereference/; leia-os antes de desviar.