Gerador de PPTX com Python

Visão Geral

Use esta habilidade quando o usuário desejar um script Python pronto para executar que crie uma apresentação do PowerPoint com python-pptx. O foco é transformar um resumo do tópico em um script completo de apresentação de slides com conteúdo real, estrutura sensata e uma etapa de salvamento funcional.

Quando Usar Esta Habilidade

• Use quando o usuário desejar um script Python que gere um arquivo .pptx automaticamente
• Use quando o usuário precisar de conteúdo de slides redigido e codificado diretamente em python-pptx
• Use quando o usuário desejar um gerador rápido de apresentações para demonstrações, aulas ou briefings internos

Como Funciona

Etapa 1: Coletar o Resumo da Apresentação

Pergunte sobre o tópico, público, tom e número de slides desejado, caso a solicitação ainda não os inclua. Se faltarem restrições, escolha padrões conservadores e declare-os nos comentários do script gerado.

Etapa 2: Planejar o Arco Narrativo

Esboce a apresentação antes de escrever o código:

1. Slide de título
2. Agenda ou contexto
3. Pontos centrais de ensino ou negócios
4. Resumo ou próximos passos

Mantenha o número de slides realista para o público solicitado e evite slides de preenchimento.

Etapa 3: Gerar o Script Python

Escreva um script completo que:

• importe Presentation de python-pptx
• crie a apresentação
• selecione layouts integrados apropriados
• escreva títulos e marcadores reais
• salve o arquivo com um nome de arquivo claro
• imprima uma mensagem de sucesso após o salvamento

Etapa 4: Manter a Saída Executável

A resposta final deve ser um bloco de código Python que possa ser executado após a instalação de python-pptx. Evite pseudocódigo, placeholders ou importações ausentes.

Exemplos

Exemplo 1: Apresentação Educacional

User: Create a 5-slide presentation on the basics of machine learning for a high school class.
Output: A complete Python script that creates a title slide, overview, core concepts, examples, and recap.

Exemplo 2: Briefing de Negócios

User: Generate a 7-slide deck for sales leadership on Q2 pipeline risks and mitigation options.
Output: A python-pptx script with executive-friendly slide titles, concise bullets, and a final recommendations slide.

Melhores Práticas

• ✅ Use layouts python-pptx padrão, a menos que o usuário solicite posicionamento personalizado
• ✅ Escreva marcadores apropriados para o público em vez de placeholders
• ✅ Salve o arquivo de saída explicitamente no script, por exemplo output.pptx
• ✅ Mantenha os títulos dos slides curtos e a hierarquia dos marcadores legível
• ❌ Não retorne trechos parciais que exijam que o usuário monte o restante
• ❌ Não invente APIs de estilo não suportadas sem verificar as capacidades de python-pptx

Notas de Segurança e Proteção

• Instale python-pptx apenas em um ambiente que você controla, por exemplo, um ambiente virtual local
• Se o usuário for executar o script em uma máquina compartilhada, escolha um caminho de saída seguro e evite sobrescrever apresentações existentes sem confirmação
• Se a solicitação incluir conteúdo de apresentação proprietário ou sensível, mantenha-o fora de exemplos públicos e nomes de arquivos de amostra

Armadilhas Comuns

• Problema: O script gerado usa texto placeholder em vez de conteúdo real Solução: Redija a narrativa primeiro, depois transforme cada slide em títulos e marcadores específicos

• Problema: A apresentação usa muitos slides para o público solicitado Solução: Comprima o esboço para os 4 a 8 slides mais importantes, a menos que o usuário queira explicitamente uma apresentação mais longa

• Problema: O script esquece de salvar ou imprimir uma mensagem de conclusão Solução: Sempre termine com prs.save(...) e um breve print de sucesso

Habilidades Relacionadas

• @pptx-official - Use quando a tarefa for sobre inspecionar ou editar arquivos PowerPoint existentes
• @docx-official - Use quando a saída solicitada for um documento em vez de uma apresentação de slides

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
• Não trate a saída como um substituto para validação específica do ambiente, testes ou revisão especializada.
• Pare e peça esclarecimentos se entradas, permissões, limites de segurança ou critérios de sucesso necessários estiverem ausentes.