CommunityImagemgithub.com

poster-skills

Crie apresentações de slides HTML polidas a partir de modelos PPT. Invocável para trabalho web-PPT no TRAE: extração mestre, layouts cqw/cqh, QA visual, slides responsivos ou exportação 8K.

O que é poster-skills?

Esta skill oferece um fluxo de trabalho completo para transformar modelos de PowerPoint (PPT) de universidades, faculdades ou empresas em slides HTML editáveis, redimensionáveis proporcionalmente e exportáveis em alta definição, com suporte a resoluções de até 8K (7680×4320 pixels). Ela é projetada para o ambiente TRAE e baseia-se em um ciclo fechado de cinco etapas: extração de elementos mestres do template (banner, logotipo, cores, fontes e grade), criação de páginas com layouts relativos usando unidades de container query (`cqw/cqh`), inspeção visual página por página com capturas de tela, e exportação em lote via navegador headless (Edge). A skill enfatiza a localização de ativos, o uso de SVG inline para conceitos e gráficos CSS para elementos decorativos, evitando imagens de IA irrelevantes. É especialmente útil para desenvolvedores e designers que precisam manter consistência visual em apresentações web, garantindo que o layout não se desvie entre páginas e que a saída seja de alta qualidade para impressão ou exibição em telas grandes.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CanFlyhang/poster-skills/tree/HEAD

Installed? Explore more Imagem skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Perguntar na sua IA favorita

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

Documentação

Fluxo de Trabalho para Criação de Slides Web PPT no TRAE

Transforme modelos PPT de universidades, faculdades ou empresas em slides HTML editáveis, redimensionáveis proporcionalmente e exportáveis em alta definição. O ciclo completo é formado por "restrições mestre + layout página a página + inspeção visual + exportação headless".

Cenários de Uso

  • Criar slides web a partir de modelos PPT, capturas de tela de referência ou HTML mestre existente.
  • Unificar banner, logotipo, cores, fontes e grade de toda a apresentação.
  • Usar TRAE para gerar, revisar, corrigir sobreposições ou ajustar texto página por página.
  • Exportar slides HTML em lote para PNG de alta definição, incluindo imagens 8K de 7680×4320 pixels.

Se o usuário solicitar um .pptx editável por objeto, utilize a ferramenta PPTX; não faça passar uma imagem HTML por um PowerPoint editável.

Confirmações Antes de Iniciar

Leia prioritariamente os materiais existentes do usuário, não solicite informações já disponíveis na área de trabalho.

  1. Base do Template: PPT, imagem de referência, página HTML mestre ou diretrizes de marca.
  2. Conteúdo das Páginas: Esboço, título de cada página, pontos principais, dados, imagens e referências.
  3. Especificações Fixas: Proporção da página, cor principal, fonte, logotipo, cabeçalho/rodapé e elementos obrigatórios.
  4. Forma de Entrega: Arquivo HTML fonte, ativos locais, pré-visualizações, imagens 8K ou ponto de exportação.

Use valores padrão razoáveis quando informações não críticas estiverem ausentes: 16:9, fontes do sistema, ativos locais, inspeção em 1920×1080. Só pergunte se a falta de conteúdo bloquear a criação.

Princípios Centrais

  1. Extraia o mestre primeiro, depois crie as páginas: Não adivinhe o estilo enquanto gera.
  2. Elementos mestre são invariáveis: Banner, logotipo, cor principal, posição do título e grade do conteúdo não devem se deslocar entre páginas.
  3. Dimensões relativas no layout: Posicionamento, largura, altura, tamanho da fonte e espaçamento usam cqw/cqh; não misture px fixos para controlar o layout.
  4. Uma estrutura de expressão principal por página: Evite repetições desnecessárias de "imagem à esquerda, texto à direita" em páginas adjacentes, exceto em casos especiais como páginas de comparação.
  5. Ativos localizados: Não dependa de servidores de imagens temporários; fotos reais precisam de origem clara, e conceitos devem priorizar SVG inline.
  6. Inspeção visual página por página: Código sem erros não significa que a imagem esteja correta; é necessário ver o resultado renderizado.
  7. Modificações mínimas: Ao corrigir problemas em uma única página, não reorganize outros módulos ou altere todo o mestre.

Fluxo de Trabalho Padrão

Primeiro Passo: Extrair o Template e Estabelecer Invariáveis

Extraia e registre do template de referência:

CategoriaO que precisa ser confirmado
BannerFundo, posição do logotipo, posição do título, linha decorativa, altura fixa
CoresCor principal, cor secundária, cor do texto, tons de cinza, regras de uso de cores de destaque
FontesFonte do título, fonte do texto, hierarquia de tamanhos, peso da fonte
GradeMargens laterais seguras, início da área de conteúdo, espaçamento entre colunas, posição do rodapé
VariáveisTítulo de cada página, subtítulo, estrutura do texto, imagens e gráficos

Priorize o uso de fontes do sistema para evitar falhas em computadores diferentes ao usar fontes externas. Ao replicar uma imagem de referência, defina como restrição rígida que "posição, tamanho, fonte e cores devem corresponder à referência", não apenas "estilo semelhante".

Segundo Passo: Montar a Base Técnica 16:9

Todas as páginas compartilham a mesma lógica de contêiner:

/* Contêiner do slide: mantém 16:9 e habilita unidades de container query. */
.slide {
  width: min(100vw, calc(100vh * 16 / 9));
  aspect-ratio: 16 / 9;
  position: relative;
  overflow: hidden;
  container-type: size;
}

/* Elementos da página: posicionados relativamente ao contêiner, mantendo proporção ao redimensionar a janela. */
.title {
  position: absolute;
  top: 6.5cqh;
  left: 4cqw;
  font-size: 2.5cqw;
}

container-type: size é essencial para que cqw/cqh funcionem. Em uma tela de 1920×1080, 1cqw = 19.2px, 1cqh = 10.8px. A proporção do layout se mantém ao redimensionar a janela, projetar em telas maiores ou exportar em alta resolução.

Terceiro Passo: Criar a Página Mestre

Primeiro, crie um pequeno conjunto de páginas base; depois, gere o restante em lote:

  • Página de Capa: Título principal, apresentador, unidade, data e identidade visual da marca.
  • Página Mestre de Conteúdo: Banner fixo, área de título, grade de conteúdo e rodapé.
  • Página de Encerramento: Conclusão, agradecimentos ou referências, diferenciando o uso conforme o conteúdo.

Após a aprovação do mestre, use-o como base estrutural e estilística para as páginas seguintes. Antes de modificar uma página existente, leia o arquivo; não adivinhe a estrutura com base no nome do arquivo.

Quarto Passo: Gerar Página a Página, Combinando com a Estrutura de Conteúdo

Para cada nova página, especifique claramente cinco itens:

  1. Em qual página mestre se basear e quais elementos permanecem inalterados.
  2. Proporção da página, nome do arquivo e local de salvamento.
  3. Título, pontos principais, dados e conclusão desta página.
  4. Layout adotado para esta página e diferenças em relação às páginas anteriores.
  5. Origem das imagens, requisitos de localização e restrições de direitos autorais.

Escolha o layout com base no conteúdo; não sacrifique a expressão da informação por novidade:

Tipo de ConteúdoEstrutura Recomendada
CapaTítulo grande centralizado, banner da marca, uma imagem principal
Itens ParalelosCartões de largura igual, colunas comparativas
Fluxos e EtapasEscada, linha do tempo, banners progressivos
Relações Causa e EfeitoCadeia, fluxo de setas, irradiação central
Conceito CentralDiagrama central + anotações ao redor
Estrutura e PrincípiosDiagrama de seção, SVG ilustrativo + pontos principais
Dados e PainéisGráficos, cartões de indicadores, painéis frente a frente
Informações MultidimensionaisGrade 2×2, matriz, cartões agrupados
ConclusãoTese central, eixo vertical de resumo, poucos números-chave
ReferênciasCapa da referência ou captura de tela da fonte + lista formatada
AgradecimentosTexto curto e grande + imagem principal, evitar empilhamento de módulos

Quinto Passo: Escolher a Forma de Ilustração

Siga esta ordem de prioridade:

  1. Fotos Reais: Priorizar materiais fornecidos pelo usuário ou com autorização clara; materiais públicos devem ter licença verificada e origem registrada.
  2. SVG Inline: Adequado para conceitos que não podem ser fotografados diretamente, como redes cristalinas, defeitos, seções, fluxos, cadeias causais.
  3. CSS Gráficos: Adequado para elementos informativos decorativos simples, como escadas, barras de espectro, emblemas, fundos de indicadores.

Salve todas as imagens localmente e verifique os caminhos de referência. Não use imagens de IA irrelevantes para preencher o layout.

Sexto Passo: Inspeção Visual Página a Página

No Windows, use o modo headless do Edge para gerar imagens de inspeção em 1920×1080. Ajuste os caminhos do navegador e do arquivo conforme necessário:

$edge = "C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe"
& $edge --headless=new --disable-gpu --hide-scrollbars `
  --virtual-time-budget=6000 --window-size=1920,1080 `
  --screenshot="_chk.png" "file:///caminho/absoluto/para/pagina.html"

Verifique página por página:

  • A página é exibida completamente em 16:9, sem barras de rolagem inesperadas.
  • Nenhum elemento transborda, é cortado, sobreposto ou tem espaçamento muito próximo.
  • Todas as imagens carregam corretamente, sem placeholders vazios ou quebrados.
  • Hierarquia clara entre título, texto e legendas, sem palavras órfãs ou quebras de linha anormais.
  • Banner, logotipo, cores e grade consistentes com o mestre.
  • Dados, unidades, anos, termos e referências consistentes.
  • Ao redimensionar a janela, o layout ainda escala proporcionalmente; nenhum elemento com pixel fixo quebra o layout.

Ao encontrar problemas, identifique a causa raiz e modifique apenas os estilos ou elementos relevantes; faça uma nova captura de tela para verificar. Ao remover elementos como logotipos e cabeçalhos, verifique o HTML, CSS e título da página correspondentes para evitar resquícios.

Sétimo Passo: Exportar Imagens de Alta Definição

Use viewport de 1920×1080 com escala de dispositivo 4x para exportar PNG de 7680×4320:

& $edge --headless=new --disable-gpu --hide-scrollbars `
  --virtual-time-budget=6000 --window-size=1920,1080 `
  --force-device-scale-factor=4 `
  --screenshot="export/pagina.png" "file:///caminho/absoluto/para/pagina.html"

Este método faz o navegador renderizar novamente o texto, CSS e SVG em alta escala, não apenas esticando uma imagem de baixa resolução para 8K.

Para exportação em lote, priorize reutilizar scripts existentes do projeto. Após a saída do processo, confirme que o arquivo existe, tem o tamanho correto e foi gravado completamente; não confie apenas no código de saída do comando.

Oitavo Passo: Organizar os Entregáveis

Recomenda-se manter uma estrutura de diretórios clara e reutilizável:

projeto/
├── 001.html ... NNN.html
├── assets/
│   ├── images/
│   └── logos/
├── export/
└── html2img_8k.py        # Fornecido se o projeto já tiver ou o usuário solicitar

Na entrega, liste os arquivos fonte, diretório de ativos, diretório de exportação e informações que ainda precisam ser complementadas pelo usuário. Não misture capturas de tela temporárias de inspeção com os resultados finais.

Prompts Reutilizáveis

Gerar Nova Página

Com base na [página mestre] em [caminho], gere [nome do novo arquivo de página]:
1. Mantenha 16:9, banner, logotipo, fonte, cores e grade inalterados;
2. Título: [título], conteúdo inclui [ponto A] [ponto B] [ponto C];
3. Use [layout especificado], diferenciando-se estruturalmente das páginas adjacentes;
4. Posicionamento, tamanho, fonte e espaçamento usam cqw/cqh;
5. Imagens localizadas e fonte indicada; após concluir, faça captura de tela em 1920×1080 para inspeção.

Corrigir Problema Visual

Identifique a causa raiz de [sobreposição/transbordamento/imagem quebrada/quebra de linha] no [módulo específico] da [página em caminho],
corrija apenas o problema relevante, mantendo outros módulos e o mestre inalterados; após a modificação, faça nova captura de tela para verificar.

Ajustar Texto

Substitua [texto original] por [novo texto] na [página em caminho],
mantenha o layout atual, verifique exibição em linha única, palavras órfãs, transbordamento e espaçamento entre módulos.

Problemas Comuns

ProblemaO que verificar primeiro
cqw/cqh não funcionamO contêiner tem container-type: size? O elemento está dentro desse contêiner?
Fonte muda ao trocar de computadorEstá usando fontes externas ou não instaladas? Troque para fontes do sistema.
Imagem em branco ou 404Nome do arquivo, maiúsculas/minúsculas, caminho relativo, caracteres especiais e espaços de largura zero.
Nome de arquivo com espaço de largura zero U+200BRenomeie o arquivo ou codifique o caractere como %E2%80%8B na URL.
Módulo invade a área do títuloInício da área de conteúdo, altura do módulo, elevação da escada muito grandes.
Palavra órfã em parágrafoOtimize o texto primeiro, depois ajuste o tamanho da fonte ou largura do contêiner.
Estilo da página se desvia gradualmentePulou o mestre e fez algo por conta própria? Refaça a verificação das invariáveis.
Imagem 8K borradaUsou escala de dispositivo 4x para re-renderizar, ou apenas ampliou uma captura existente?
Arquivo exportado incompletoAguardou a renderização da página e a gravação estável do arquivo?

Critérios de Conclusão

A tarefa só é considerada concluída quando todas as condições abaixo são atendidas:

  • O mestre e todas as páginas têm estilo consistente; a estrutura do conteúdo serve à expressão da informação.
  • Todas as páginas novas ou modificadas foram verificadas com renderização real.
  • Referências a imagens, fontes, logotipos e scripts estão funcionais; os ativos estão localizados.
  • As imagens exportadas têm o tamanho correto; saída 8K é 7680×4320.
  • O diretório de entrega está claro; arquivos temporários estão separados dos resultados finais.

Habilidades Relacionadas