Humanize PPT

Use esta habilidade quando o usuário quiser transformar material bruto, anotações, transcrições de voz, documentos ou links em um esboço pronto para apresentação e decisões de mídia por página, antes de delegar a renderização para uma habilidade downstream. Arquivos PPT/PPTX antigos não são lidos diretamente: extraia o texto deles primeiro (veja a saída de dump/inspect de scripts/pptx_qa.py) e, em seguida, alimente esse texto como --source. Um deck que o Humanize PPT já renderizou passa por --qa-from <rendered.pptx> em vez disso — a verificação da apresentação, não o modo de resumo.

Posicionamento

Humanize PPT é um sistema de apresentação, nascido para a fala: um Diretor de Esboço (AST audience-state-transfer — cada virada de página avança a audiência), um Diretor de Aprimoramento Visual por Página (imagem real / diagrama SVG / vídeo Remotion), um Orquestrador de Briefing de Produção, um Executor de Verificação de Apresentação (演讲体检; anteriormente o loop de QA, flag CLI ainda --qa-from) e um handoff para o Modo Apresentador. A motivação: habilidades de template HTML-PPT são ótimas em exibição de conceito, mas transformam uma ideia simples em uma dúzia de páginas bonitas, enquanto uma palestra real de 90 minutos tem cerca de 30 — a casca bonita supera a densidade do conteúdo. Humanize fecha essa lacuna: mantém a beleza (renderizada nativamente pela habilidade de template downstream) e a torna apresentável — uma linha que você pode apresentar. Habilidades de template downstream são responsáveis por "renderizar lindamente"; Humanize é responsável por "é uma palestra, e alguém a verificou".

A verificação da apresentação em uma frase: ela não avalia a beleza, ela avalia o esboço. Ela compara cada página renderizada com sua página de esboço, retira as páginas que só podem ser olhadas, mas não faladas, e continua até que cada página seja uma que o apresentador possa apresentar. Uma página falha, em termos simples: uma página que contém poucas palavras e nunca termina seu ponto, ou uma página que falha na transferência de estado da audiência que prometeu (o ouvinte sai dessa página no mesmo estado em que entrou). Tal página não deveria existir; a verificação a retira e gera instruções de correção.

Humanize é amplamente compatível com renderizadores downstream que podem consumir markdown simples + JSON. Rotas verificadas são: Chinês HTML → guizang-ppt-skill; Inglês HTML → frontend-slides / beautiful-html-templates; PowerPoint editável nativo → ppt-master. Outros downstreams permanecem hot-pluggable; os níveis de suporte estão em registry/renderer_registry.json e se movem apenas com saída real.

Ele roda antes das habilidades de slides PPT / HTML downstream e ao redor da verificação de apresentação pós-renderização. Ele é responsável pelo contrato AST, pela decisão de mídia por página (esta página precisa de uma foto, um diagrama de sistema, um clipe de processo de 10 segundos, nada?), pelo briefing de produção que o próximo agente consome e pela passagem de verificação em HTML/PPTX renderizado. Ele não é responsável pelo deck renderizado em si.

Existem dois portões de revisão humana antes da renderização: a prévia do esboço e o portão de estilo do renderizador. Rotas HTML usam as ≥4 capas reais de --style-gallery do Humanize. PPT Master já possui uma Confirmação de UI obrigatória em três estágios com prévias visuais nativas, então --renderer ppt-master --style-gallery delega para esse portão e escreve style_gallery_plan.json + commands/style-gallery/ppt-master-confirm-ui.md em vez de duplicar o catálogo.

O usuário chama o Humanize PPT uma vez para o briefing, entrega o briefing para uma habilidade downstream para renderização nativa e, em seguida, chama o Humanize novamente com --qa-from <rendered.html|native.pptx> para executar a verificação de apresentação de 3 iterações. Cada iteração escreve qa_report.md, fix_prompt.md e qa_iteration.json. Após 3 rodadas com falhas remanescentes, o status muda para needs-human.

Humanize PPT nunca copia o template de uma habilidade downstream, nunca injeta seções personalizadas nele, e nunca faz pós-processamento de HTML ou PPTX renderizado. Correções retornam à fonte do autor downstream. Veja references/guizang-production-brief-orchestrator.md e adapters/ppt-master-bridge-notes.md.

Para posicionamento público, descreva o Humanize PPT como um orquestrador de briefing que se associa a renderizadores downstream nativos. Não o apresente como um renderizador em si, e não o apresente como um "roteador" que escolhe o melhor estilo visual para o usuário — essa decisão reside no briefing, nos templates próprios da habilidade downstream e na revisão humana. Quando um usuário quer apenas uma página de template bonita, esse é um trabalho da habilidade de renderização, não do Humanize: declare a escolha, não uma proibição.

Teoria AST

AST significa Audience-State-Transfer (Transferência de Estado da Audiência).

…