O que PPT Builder (brief → deck) faz?
Produza uma apresentação em dois artefatos: uma especificação de conteúdo por slide (JSON) e — quando o python-pptx existir — um arquivo .pptx real renderizado a partir dela. A especificação é a fonte da verdade; a renderização é mecânica.
Entradas
| Entrada | Obrigatório | Padrão | Observações |
|---|---|---|---|
| topic | sim | — | o que o deck argumenta ou explica |
| audience | não | 通用商务 | define tom e profundidade |
| slide_count | não | 10 | incluindo capa e encerramento |
| style | não | 简洁商务 | ex.: 学术答辩 / 融资路演 / 教学课件 |
Se o tópico estiver ausente, pergunte UMA VEZ:
请给出 PPT 主题与用途（汇报对象是谁）。可选告知：页数（默认 10）、 风格（默认简洁商务）、是否已有大纲或素材文件。
Verificação pré-voo
python -c "import pptx; print('pptx-ok')"
- Imprime
pptx-ok→ exportação .pptx habilitada (Passo 3a). - ModuleNotFoundError → caminho markdown (Passo 3b). Informe o usuário com uma linha:
pip install python-pptxhabilita a exportação direta de .pptx da próxima vez. NÃO instale você mesmo a menos que o usuário peça explicitamente.
Fluxo de trabalho
Passo 1: Estrutura
Estruture o argumento (não tópicos) nesta ordem: 钩子开场（一个问题或反直觉事实）→ 全局地图 → 核心论点 2–3 个（每个配证据/案例）→ 反驳或边界 → 行动号召. Esperado: numeração onde cada slide afirma UMA tese.
Passo 2: Especificação por slide
Escreva slides_spec.json:
{
"deck_title": "...",
"slides": [
{"title": "...", "bullets": ["<=18字/条, 最多5条"], "notes": "讲稿口语版", "visual": "图表/截图/留白提示"}
]
}
Regras: título ≤ 16 caracteres e contenha um ponto de vista (não palavras vagas como "介绍"); notes devem ser frases completas que possam ser lidas em voz alta.
Passo 3a: Renderizar .pptx (pptx disponível)
python "<skill-dir>/scripts/make_pptx.py" slides_spec.json deck.pptx
Esperado: exit 0 mais wrote deck.pptx (N slides). Exit 3 significa python-pptx ausente → cair para 3b e informar o motivo. Exit 2 significa especificação inválida — leia o erro impresso, corrija slides_spec.json e execute novamente.
Passo 3b: Entregável alternativo
Emita deck_outline.md: H1 título do deck, H2 por slide com bullets e a nota do apresentador abaixo de cada um. O usuário cola em qualquer ferramenta.
Passo 4: Auto-revisão antes da entrega
Verifique: cada slide defende apenas um argumento; nenhum bullet excede 5 itens; cada slide tem uma dica visual específica; o total de palavras nas notas sustenta a duração alvo (cerca de 1 minuto por slide). Corrija violações na especificação e re-renderize, em vez de corrigir o texto.
Tratamento de falhas
| Sintoma | Causa provável | Ação |
|---|---|---|
| script sai com 2 listando slide N | violação de schema da especificação | corrija os campos daquele slide conforme o formato do Passo 2 |
| script sai com 3 | python-pptx ausente | mude para Passo 3b, ofereça a dica do pip |
| bullets continuam excedendo 18 caracteres | outline muito denso | divida o slide em dois, re-renderize |
| usuário quer o template da empresa | estilo fora do escopo da v1 | entregue especificação + outline.md para reestilização manual |
Padrão de entrega
Sucesso = ou deck.pptx (abrir, N slides correspondendo à especificação) ou deck_outline.md, MAIS slides_spec.json, todos os três caminhos relatados com a contagem de slides. Qualquer outra coisa não está concluída — diga isso claramente.
Referências
scripts/make_pptx.py— execute-o (rode, não leia); valida a especificação e renderiza