USTC-Astro/coffee_break_poster

Póster de Pausa para Café

Crea un póster de una sola pantalla, centrado en figuras, para una pausa de café astro.

Esta habilidad es para compartir rápidamente un artículo de arXiv durante una pausa para café, un club de revistas, un seminario o una discusión informal. El objetivo no es reproducir el artículo en miniatura. El objetivo es hacer que las personas se detengan, miren y recuerden por qué el artículo es interesante, qué afirma y cuál es la conclusión principal.

Audiencia predeterminada: lectores amplios de astronomía. A menos que el usuario solicite explícitamente lo contrario, no optimices solo para especialistas.

Objetivo Principal del Producto

El póster debe funcionar como un discurso visual rápido para el artículo:

• Un lector debe comprender el punto principal en 15-30 segundos.
• El póster debe ser interesante antes que exhaustivo.
• El trabajo intelectual principal es resaltar el punto de venta / conclusión / por qué esto es importante, no reafirmar los detalles del método.
• Las figuras deben transmitir la mayor parte de la información; el texto debe guiar la atención y la interpretación.

No conviertas el póster en:

• una revisión técnica
• un resumen del artículo sección por sección
• una nota con mucho énfasis en la metodología
• un muro de texto con figuras pegadas como decoración

Directorio de Trabajo

• Si el usuario proporciona un directorio de trabajo, úsalo.
• De lo contrario, usa /Users/chensj/repository/coffee_break_poster/work/<paper_slug>/.
• No escribas pósters generados dentro de un directorio de skill instalado.

Requisito Previo

Esta habilidad asume que el CLI cbp está disponible en PATH a través de una instalación normal del paquete o una instalación editable de este repositorio.

Resultado Esperado

Produce un póster HTML de una sola pantalla con formato 16:9 que se pueda revisar y renderizar a PNG/PDF.

Para compartir al estilo WeChat/iPhone, produce una tarjeta de teléfono 9:16 complementaria:

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

El formato de teléfono es un resumen condensado, no un resumen completo del artículo. Prefiere una figura principal más 1-2 figuras de apoyo, y reescribe el texto en un gancho corto, Por qué es importante, Lo que muestra este artículo y Recuerda. No viertas el texto del formato 16:9 en la tarjeta vertical.

La estructura predeterminada del póster tiene exactamente estos bloques de texto:

1. Antecedentes
2. Brecha de conocimiento
3. Lo que este artículo vende
4. Resultados clave para recordar

más 2-4 figuras con leyendas cortas.

Cuando se pueda inferir un ID de arXiv, los metadatos del encabezado/derecha incluyen un enlace clickeable a arXiv, el DOI canónico de arXiv y un código QR a la página del resumen de arXiv.

En la práctica, la columna de texto izquierda debe leerse como un argumento compacto:

1. ¿Por qué la gente debería preocuparse?
2. ¿Qué faltaba antes de este artículo?
3. ¿Qué afirma este artículo que añade?
4. ¿Qué evidencia hace que esa afirmación valga la pena recordarla?

Flujo de Trabajo

1. Normalizar la entrada

cbp ingest INPUT --workdir work

2. Inspeccionar el inventario determinista del artículo

cbp inspect PAPER_DIR --json

Úsalo para inspeccionar secciones, archivos de imagen, dimensiones y leyendas candidatas. Este comando no resume el artículo por ti.

3. Lee solo lo que necesitas, luego toma las decisiones científicas/editoriales

Lee paper.md de forma selectiva. No vuelques ni parafrasees todo el artículo. Concéntrate en:

• el resumen y la conclusión
• los pocos párrafos necesarios para entender la afirmación central
• el contexto local alrededor de las figuras que puedas usar

Luego toma las decisiones a nivel de póster:

• Escribe un titular que indique lo que aprendemos del artículo, no solo el tema.
• Escribe un subtítulo que enmarque el interés o gancho astrofísico.
• Completa los bloques de texto para que formen una historia coherente.
• Elige 2-4 figuras, generalmente 2-3 fuertes, en lugar de llenar espacios mecánicamente.
• Mantén los métodos cortos a menos que sean esenciales para la confianza.

4. Andamiaje y edición

cbp scaffold PAPER_DIR

Edita poster.html directamente. La plantilla predeterminada es 16:9, con texto a la izquierda y figuras a la derecha.

Usa solo las figuras que transmiten la historia. No llenes espacios con figuras débiles. Si el póster necesita menos de cuatro figuras, haz el andamiaje o revisa el panel de figuras como un diseño deliberado de bajo recuento, no como una cuadrícula 2x2 con espacios vacíos o débiles:

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

La plantilla de 1 figura usa una gran figura heroica visual. La plantilla de 2 figuras usa una figura principal más un panel de apoyo. La plantilla de 3 figuras usa una figura heroica grande más dos figuras de apoyo. Usa estos modos cuando las figuras seleccionadas sean científicamente más fuertes que una cuadrícula completa de cuatro espacios.

Para una tarjeta de teléfono, elige la plantilla vertical explícitamente:

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

Usa --figure-count 4 para salida de teléfono solo cuando el usuario solicite explícitamente cuatro figuras; generalmente es demasiado denso para una imagen de teléfono comprimida.

5. Verificar e iterar

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

Para salida de teléfono, usa la ventana gráfica consciente del formato:

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

Esta es una puerta estricta. Si la verificación reporta desbordamiento, descendientes recortados, figuras diminutas, imágenes rotas, área de figura en blanco o una región de diseño colapsada, edita poster.html y vuelve a ejecutar. Las herramientas miden el diseño; el agente debe adaptar el contenido, la elección de figuras, las leyendas y el CSS.

Para una explicación compacta de qué cambiar, ejecuta:

cbp diagnose PAPER_DIR/poster.html

Orden de adaptación del diseño:

1. Acorta la prosa y las leyendas.
2. Si una o más figuras son secundarias, cambia a un diseño de 1, 2 o 3 figuras en lugar de llenar espacios vacíos.
3. Ajusta variables CSS como escala de texto, escala de leyenda, altura del encabezado, espacio entre figuras o proporción texto/figura.
4. Cambia la estructura del diseño solo si los pasos anteriores no resuelven el problema medido.

6. Renderizar

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

Para salida de teléfono:

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

render ejecuta la verificación de diseño primero y se niega a sobrescribir las salidas de vista previa si el póster no pasa. Usa --force solo para depurar un diseño roto, nunca para la entrega final.

Reglas Editoriales

Titular

El titular debe decir lo que el artículo nos enseña.

Buenas propiedades del titular:

• más parecido a una afirmación que a un tema
• lo suficientemente corto para escanear rápidamente
• memorable para un lector de astro no especialista
• anclado en el incremento de conocimiento más fuerte del artículo

Evita titulares que sean solo:

• el título del artículo reescrito
• una etiqueta de tema vaga
• un encuadre centrado en el método cuando el punto real es un resultado científico

Subtítulo

El subtítulo debe ser un gancho corto, generalmente una oración.

Úsalo para responder a una de estas:

• por qué este resultado es sorprendente
• a qué problema más grande se conecta
• qué tipo de evidencia hace que el artículo sea interesante

No uses el subtítulo para un resumen largo tipo abstract.

Antecedentes

Antecedentes responde:

• ¿por qué debería importarle a una audiencia amplia de astro?
• ¿a qué pregunta astrofísica más grande está conectado esto?

No empieces con nombres de estudios, tamaños de muestra, detalles de instrumentos o una cadena de calificativos técnicos a menos que esos sean el gancho real.

Brecha de conocimiento

Brecha de conocimiento debe ser la pieza faltante precisa que motiva el artículo.

Debe estar estrechamente vinculada a los antecedentes. Una buena brecha agudiza la historia de "esta área importa" a "esto es lo que aún no podíamos explicar o establecer antes de este artículo".

La brecha generalmente debe coincidir con la escala real de contribución del artículo:

• artículo de estudio de caso -> brecha de identificación/interpretación del caso
• artículo de población -> brecha demográfica/tendencia/comparación
• artículo teórico -> brecha de mecanismo/consistencia/predicción

No hagas una pregunta a nivel de población si el artículo solo proporciona evidencia de un objeto, a menos que el póster enmarque explícitamente el artículo como una prueba de existencia o un ancla metodológica.

Lo que este artículo vende

Esta sección debe tener 2-3 oraciones.

Debe responder:

• ¿qué está tratando de persuadirnos el artículo para que creamos?
• ¿cuál es el incremento de conocimiento más fuerte aquí?
• ¿por qué vale la pena compartir este artículo durante una pausa para café?

Esto no es un informe de revisión. Si es necesario, puedes incluir una advertencia leve, pero el trabajo principal es identificar el punto de venta más fuerte del artículo.

Resultados clave para recordar

Usa 3-4 viñetas cortas.

Cada viñeta debe ser:

• centrada en la evidencia
• lo suficientemente concreta para recordar
• claramente vinculada al punto de venta
• despojada de detalles de método no esenciales

Prefiere viñetas que suenen como "conclusiones para el lector ocupado", no fragmentos de cuaderno.

Lógica de la Historia: Las Secciones Deben Conectarse

El póster debe leerse como un argumento, no cuatro resúmenes independientes.

Cadena lógica requerida:

1. Antecedentes explica por qué la pregunta importa.
2. Brecha de conocimiento indica lo que faltaba antes de este artículo.
3. Lo que este artículo vende dice lo que el artículo afirma añadir o aclarar.
4. Resultados clave para recordar proporcionan la evidencia o las consecuencias memorables que respaldan esa afirmación.

Si la historia no fluye en ese orden, reescríbela.

Modos de fallo comunes a evitar:

• Antecedentes es amplio, pero Brecha de conocimiento trata de otra cosa.
• Lo que vende es genérico y no responde a la brecha indicada.
• Resultados clave son hechos verdaderos del artículo pero no respaldan el punto de venta.
• El póster hace una pregunta pero responde otra.
• El texto suena técnicamente correcto pero no interesante.

Reglas de Selección de Figuras

Elige figuras que ayuden a un lector a entender la historia rápidamente.

Prioriza, en orden:

1. una figura que defina el objeto, muestra o problema
2. una figura que muestre el resultado principal
3. una figura que coloque el resultado en un contexto o comparación más amplio

Generalmente, mantén 2-3 figuras fuertes. Usa una cuarta solo si claramente añade valor narrativo.

Evita figuras que sean principalmente:

• diagramas de flujo de métodos
• gráficos de esquinas de parámetros
• comprobaciones internas de cordura
• diagnósticos de especialistas que requieren demasiada preparación

a menos que sean la única forma de hacer que la afirmación central sea confiable.

Leyendas de Figuras

Cada leyenda de figura debe responder:

• ¿por qué está esta figura aquí?
• ¿qué debería recordar un lector ocupado de ella?

Las leyendas deben interpretar, no solo etiquetar.

Mal estilo de leyenda:

• describe los ejes del gráfico sin decir el punto
• reafirma solo el título del panel
• explica detalles de procedimiento pero no el significado científico

Buen estilo de leyenda:

• dice lo que establece la figura
• dice por qué es importante para la afirmación principal del artículo
• usa una redacción corta y memorable

Métodos: Moderación Predeterminada

No gastes mucho espacio del póster en métodos a menos que la confianza en el método sea central para la afirmación.

Un poco de método es útil solo cuando responde:

• ¿por qué deberíamos confiar en esta interpretación?
• ¿qué tiene de especial la evidencia?
• ¿qué rompe una ambigüedad anterior?

Si el método no está soportando esa carga, recórtalo.

Estilo

• Pila de fuentes del título y texto principal: Helvetica, Arial, sans-serif.
• Subtítulo: cursiva, no negrita, en la misma pila Helvetica.
• El indicador de brecha de conocimiento/prompt resaltado puede usar "Gill Sans", "Gill Sans MT", Helvetica, Arial, sans-serif.
• Evita párrafos largos.
• Usa negrita con moderación, solo para las palabras que la gente realmente debería recordar.
• Las figuras deben transmitir la mayor parte de la información.
• El póster debe caber en una pantalla común sin desplazarse.
• No fuerces el estiramiento de imágenes; preserva las relaciones de aspecto de las figuras.

Autoverificación Final Antes de Renderizar

Antes de renderizar, verifica:

1. ¿El póster es interesante para alguien que no ha leído el artículo?
2. ¿El titular comunica una conclusión real?
3. ¿Antecedentes y Brecha de conocimiento están estrechamente vinculados?
4. ¿Lo que este artículo vende responde claramente a esa brecha?
5. ¿Resultados clave para recordar realmente respaldan el punto de venta?
6. ¿Cada figura apoya una parte específica de la historia?
7. ¿Podría un lector explicar el punto principal del artículo después de 15-30 segundos?
8. ¿Has eliminado detalles de método que no mejoran la confianza?
9. ¿Las figuras transmiten la mayor parte de la información visualmente?
10. ¿El diseño permanece limpio después de check?

Si alguna respuesta es no, revisa poster.html y vuelve a ejecutar check.