Communitygithub.com

USTC-Astro/coffee_break_poster

Crie um pôster de coffee break astro em uma única tela a partir de um diretório de artigo no estilo MinerU, PDF, URL do arXiv ou URL direta de PDF. Use as ferramentas determinísticas em tools/ para ingestão, inspeção, verificação de layout e renderização; use o agente para sumarização, escolha de figuras, design narrativo e edições HTML.

O que é coffee_break_poster?

Este skill permite que um agente de IA (como Claude Code, Cursor ou Codex) crie pôsteres de coffee break astronômicos em formato de tela única (16:9) ou cartão de compartilhamento para celular (9:16), ideais para divulgação rápida em grupos de discussão, journal clubs, seminários ou conversas de corredor. O skill automatiza o fluxo de trabalho completo: ingestão de artigos via CLI `cbp` (a partir de PDF, URL do arXiv, ID do arXiv ou diretório MinerU), inspeção determinística do inventário do artigo (seções, figuras, legendas), sumarização inteligente e escolha narrativa das figuras, criação do HTML do pôster com layout configurável (1-4 figuras), verificação de layout (overflow, figuras quebradas) e renderização final para PNG/PDF. O foco é gerar um pitch visual rápido e interessante, onde as figuras carregam a maior parte da informação e o texto guia a atenção, em vez de reproduzir o artigo em miniatura. O skill é compatível com macOS/Linux e requer a instalação do pacote `cbp`.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add USTC-Astro/coffee_break_poster

Perguntar na sua IA favorita

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

Documentação

Pôster de Coffee Break

Crie um pôster de coffee break astro em uma única tela, com foco em figuras.

Este skill é para compartilhamento rápido do arXiv durante um coffee break, journal club, seminário ou conversa de corredor. O objetivo não é reproduzir o artigo em miniatura. O objetivo é fazer as pessoas pararem, olharem e lembrarem por que o artigo é interessante, o que ele está afirmando e qual é a mensagem principal.

Público-alvo padrão: leitores amplos de astronomia. A menos que o usuário peça explicitamente o contrário, não otimize apenas para especialistas.

Objetivo Principal do Produto

O pôster deve funcionar como um pitch visual rápido para o artigo:

  • Um leitor deve entender o ponto principal em 15-30 segundos.
  • O pôster deve ser interessante antes de ser exaustivo.
  • O principal trabalho intelectual é destacar o ponto de venda / mensagem principal / por que isso importa, não reafirmar detalhes de método.
  • As figuras devem carregar a maior parte da informação; o texto deve guiar a atenção e a interpretação.

Não transforme o pôster em:

  • uma revisão técnica
  • um resumo do artigo seção por seção
  • uma nota com ênfase em metodologia
  • um bloco de texto com figuras coladas como decoração

Diretório de Trabalho

  • Se o usuário fornecer um diretório de trabalho, use-o.
  • Caso contrário, use /Users/chensj/repository/coffee_break_poster/work/<paper_slug>/.
  • Não escreva pôsteres gerados em um diretório de skill instalado.

Pré-requisito

Este skill assume que a CLI cbp está disponível no PATH através de uma instalação normal de pacote ou instalação editável deste repositório.

Saída Esperada

Produza um pôster HTML 16:9 de tela única que possa ser verificado e renderizado para PNG/PDF.

Para compartilhamento no estilo WeChat/iPhone, produza um cartão de compartilhamento de celular 9:16 complementar:

cbp scaffold PAPER_DIR --format phone --figure-count 1
cbp check PAPER_DIR/poster.html --format phone --json-out PAPER_DIR/layout.json
cbp render PAPER_DIR/poster.html --format phone --png --pdf

O formato de celular é um pitch condensado, não um resumo completo do artigo. Prefira uma figura herói mais 1-2 figuras de apoio, e reescreva o texto em um gancho curto, Por que isso importa, O que este artigo mostra e Lembre-se. Não despeje o texto do formato 16:9 no cartão vertical.

A estrutura padrão do pôster tem exatamente estes blocos de texto:

  1. Contexto
  2. Lacuna de conhecimento
  3. O que este artigo está vendendo
  4. Resultados principais para lembrar

mais 2-4 figuras com legendas curtas.

Quando um ID do arXiv puder ser inferido, os metadados do cabeçalho/direito incluem um link clicável para o arXiv, o DOI canônico do arXiv e um código QR para a página de resumo do arXiv.

Na prática, a coluna de texto à esquerda deve ler como um argumento compacto:

  1. Por que as pessoas deveriam se importar?
  2. O que faltava antes deste artigo?
  3. O que este artigo está reivindicando adicionar?
  4. Que evidência torna essa reivindicação digna de ser lembrada?

Fluxo de Trabalho

1. Normalizar entrada

cbp ingest INPUT --workdir work

2. Inspecionar inventário determinístico do artigo

cbp inspect PAPER_DIR --json

Use isso para inspecionar seções, arquivos de imagem, dimensões e legendas candidatas. Este comando não resume o artigo para você.

3. Leia apenas o que precisa, depois faça as escolhas científicas/editoriais

Leia paper.md seletivamente. Não despeje ou parafraseie o artigo inteiro. Concentre-se em:

  • o resumo e a conclusão
  • os poucos parágrafos necessários para entender a reivindicação central
  • o contexto local ao redor das figuras que você pode usar

Em seguida, faça as escolhas no nível do pôster:

  • Escreva um título que declare o que aprendemos com o artigo, não apenas o tópico.
  • Escreva um subtítulo que enquadre o interesse astrofísico ou o gancho.
  • Preencha os blocos de texto para formar uma história coerente.
  • Escolha 2-4 figuras, geralmente 2-3 fortes, em vez de preencher espaços mecanicamente.
  • Mantenha os métodos curtos, a menos que sejam essenciais para a credibilidade.

4. Scaffold e edição

cbp scaffold PAPER_DIR

Edite poster.html diretamente. O template padrão é 16:9, com texto à esquerda e figuras à direita.

Use apenas as figuras que carregam a história. Não preencha espaços com figuras fracas. Se o pôster precisar de menos de quatro figuras, crie ou revise o painel de figuras como um layout deliberado de contagem reduzida, não como uma grade 2x2 com espaços vazios ou fracos:

cbp scaffold PAPER_DIR --figure-count 1
cbp scaffold PAPER_DIR --figure-count 2
cbp scaffold PAPER_DIR --figure-count 3

O template de 1 figura usa uma grande figura herói visual. O template de 2 figuras usa uma figura principal mais um painel de apoio. O template de 3 figuras usa uma grande figura herói mais duas figuras de apoio. Use estes modos quando as figuras selecionadas forem cientificamente mais fortes do que uma grade completa de quatro espaços.

Para um cartão de compartilhamento de celular, escolha o template vertical explicitamente:

cbp scaffold PAPER_DIR --format phone --figure-count 2

Use --figure-count 4 para saída de celular apenas quando o usuário pedir explicitamente quatro figuras; geralmente é muito denso para uma imagem de compartilhamento compactada.

5. Verificar e iterar

cbp check PAPER_DIR/poster.html --json-out PAPER_DIR/layout.json

Para saída de celular, use o viewport com conhecimento de formato:

cbp check PAPER_DIR/poster.html --format phone --json-out PAPER_DIR/layout.json

Esta é uma verificação obrigatória. Se a verificação relatar overflow, descendentes cortados, figuras pequenas, imagens quebradas, área de figura em branco ou uma região de layout colapsada, edite poster.html e execute novamente. As ferramentas medem o layout; o agente deve adaptar conteúdo, escolha de figuras, legendas e CSS.

Para uma explicação compacta do que mudar, execute:

cbp diagnose PAPER_DIR/poster.html

Ordem de adaptação de layout:

  1. Encurte a prosa e as legendas.
  2. Se uma ou mais figuras forem secundárias, mude para um layout de 1, 2 ou 3 figuras em vez de preencher espaços vazios.
  3. Ajuste variáveis CSS como escala de texto, escala de legenda, altura do cabeçalho, espaço entre figuras ou proporção texto/figura.
  4. Mude o layout estrutural apenas se as etapas anteriores não resolverem o problema medido.

6. Renderizar

cbp render PAPER_DIR/poster.html --png --pdf

Para saída de celular:

cbp render PAPER_DIR/poster.html --format phone --png --pdf

render executa a verificação de layout primeiro e se recusa a sobrescrever saídas de visualização se o pôster não passar. Use --force apenas para depurar um layout quebrado, nunca para entrega final.

Regras Editoriais

Título

O título deve dizer o que o artigo nos ensina.

Boas propriedades de título:

  • parece uma afirmação, não um tópico
  • curto o suficiente para ser escaneado rapidamente
  • memorável para um leitor de astronomia não especialista
  • ancorado no maior incremento de conhecimento do artigo

Evite títulos que sejam apenas:

  • o título do artigo reescrito
  • um rótulo de tópico vago
  • enquadramento metodológico quando o ponto real é um resultado científico

Subtítulo

O subtítulo deve ser um gancho curto, geralmente uma frase.

Use-o para responder a uma destas:

  • por que este resultado é surpreendente
  • a que problema maior ele se conecta
  • que tipo de evidência torna o artigo interessante

Não use o subtítulo para um resumo longo no estilo de resumo.

Contexto

Contexto responde:

  • por que um público amplo de astronomia deveria se importar?
  • a que questão astrofísica maior isso está conectado?

Não comece com nomes de levantamentos, tamanhos de amostra, minúcias de instrumentos ou uma cadeia de qualificadores técnicos, a menos que esses sejam o gancho real.

Lacuna de conhecimento

Lacuna de conhecimento deve ser a peça faltante precisa que motiva o artigo.

Ela deve estar firmemente ligada ao contexto. Uma boa lacuna afia a história de “esta área importa” para “isto é o que ainda não conseguíamos explicar ou estabelecer antes deste artigo.”

A lacuna geralmente deve corresponder à escala real de contribuição do artigo:

  • artigo de estudo de caso -> lacuna de identificação / interpretação de caso
  • artigo de população -> lacuna demográfica / de tendência / de comparação
  • artigo teórico -> lacuna de mecanismo / consistência / previsão

Não faça uma pergunta no nível populacional se o artigo fornecer apenas evidência de um objeto, a menos que o pôster enquadre explicitamente o artigo como uma prova de existência ou âncora de método.

O que este artigo está vendendo

Esta seção deve ter 2-3 frases.

Ela deve responder:

  • o que o artigo está tentando nos convencer a acreditar?
  • qual é o maior incremento de conhecimento aqui?
  • por que este artigo vale a pena compartilhar durante um coffee break?

Isto não é um relatório de revisão. Se necessário, você pode incluir uma ressalva moderada, mas o principal trabalho é identificar o ponto de venda mais forte do artigo.

Resultados principais para lembrar

Use 3-4 marcadores curtos.

Cada marcador deve ser:

  • centrado em evidências
  • concreto o suficiente para ser lembrado
  • claramente ligado ao ponto de venda
  • livre de detalhes metodológicos não essenciais

Prefira marcadores que soem como “mensagens principais para o leitor ocupado”, não fragmentos de caderno.

Lógica da História: Seções Devem Se Conectar

O pôster deve ser lido como um argumento, não quatro resumos independentes.

Cadeia lógica obrigatória:

  1. Contexto explica por que a questão importa.
  2. Lacuna de conhecimento afirma o que faltava antes deste artigo.
  3. O que este artigo está vendendo diz o que o artigo afirma adicionar ou esclarecer.
  4. Resultados principais para lembrar fornecem a evidência ou consequências memoráveis que apoiam essa afirmação.

Se a história não fluir nessa ordem, reescreva-a.

Modos comuns de falha a evitar:

  • Contexto é amplo, mas Lacuna de conhecimento é sobre outra coisa.
  • Vendendo é genérico e não responde à lacuna declarada.
  • Resultados principais são fatos verdadeiros do artigo, mas não apoiam o ponto de venda.
  • O pôster faz uma pergunta, mas responde outra.
  • O texto parece tecnicamente correto, mas não interessante.

Regras de Seleção de Figuras

Escolha figuras que ajudem um leitor a entender a história rapidamente.

Priorize, em ordem:

  1. uma figura que defina o objeto, amostra ou problema
  2. uma figura que mostre o resultado principal
  3. uma figura que coloque o resultado em um contexto ou comparação mais ampla

Geralmente, mantenha 2-3 figuras fortes. Use uma 4ª apenas se ela claramente adicionar valor narrativo.

Evite figuras que sejam principalmente:

  • fluxogramas de métodos
  • gráficos de cantos de parâmetros
  • verificações de sanidade internas
  • diagnósticos de especialistas que exigem muita configuração

a menos que sejam a única maneira de tornar a afirmação central confiável.

Legendas de Figuras

Cada legenda de figura deve responder:

  • por que esta figura está aqui?
  • o que um leitor ocupado deve lembrar dela?

As legendas devem interpretar, não apenas rotular.

Estilo ruim de legenda:

  • descreve eixos de gráfico sem dizer o ponto
  • reafirma apenas o título do painel
  • explica detalhes processuais, mas não o significado científico

Estilo bom de legenda:

  • diz o que a figura estabelece
  • diz por que isso importa para a afirmação principal do artigo
  • usa frases curtas e memoráveis

Métodos: Moderação Padrão

Não gaste muito espaço do pôster com métodos, a menos que a confiança no método seja central para a afirmação.

Um pouco de método é útil apenas quando responde:

  • por que devemos confiar nesta interpretação?
  • o que há de especial na evidência?
  • o que quebra uma ambiguidade anterior?

Se o método não está carregando esse peso, corte-o.

Estilo

  • Pilha de fontes do título e texto principal: Helvetica, Arial, sans-serif.
  • Subtítulo: itálico, sem negrito, na mesma pilha Helvetica.
  • O prompt de lacuna de conhecimento / destaque pode usar "Gill Sans", "Gill Sans MT", Helvetica, Arial, sans-serif.
  • Evite parágrafos longos.
  • Use negrito com moderação, apenas para as palavras que as pessoas devem realmente lembrar.
  • As figuras devem carregar a maior parte da informação.
  • O pôster deve caber em uma tela comum sem rolagem.
  • Não force esticamento de imagem; preserve as proporções das figuras.

Autoavaliação Final Antes da Renderização

Antes de renderizar, verifique:

  1. O pôster é interessante para alguém que não leu o artigo?
  2. O título comunica uma mensagem principal real?
  3. Contexto e Lacuna de conhecimento estão firmemente ligados?
  4. O que este artigo está vendendo responde claramente a essa lacuna?
  5. Resultados principais para lembrar realmente apoiam o ponto de venda?
  6. Cada figura apoia uma parte específica da história?
  7. Um leitor poderia explicar o ponto principal do artigo após 15-30 segundos?
  8. Você removeu detalhes de método que não melhoram a confiança?
  9. As figuras carregam a maior parte da informação visualmente?
  10. O layout permanece limpo após a verificação check?

Se alguma resposta for não, revise poster.html e execute check novamente.

Habilidades Relacionadas