Communitygithub.com

USTC-Astro/coffee_break_poster

Créez un poster de pause-café astro sur un seul écran à partir d'un répertoire d'article au format MinerU, d'un PDF, d'une URL arXiv ou d'une URL PDF directe. Utilisez les outils déterministes sous tools/ pour l'ingestion, l'inspection, les vérifications de mise en page et le rendu ; utilisez l'agent pour la synthèse, le choix des figures, la conception narrative et les modifications HTML.

Qu'est-ce que coffee_break_poster ?

Cette compétence permet de générer rapidement un poster de pause-café en astronomie, conçu pour être partagé lors d'un journal club, d'un séminaire ou d'une discussion informelle. L'objectif principal est de créer un support visuel percutant qui permet à un lecteur de comprendre l'essentiel d'un article en 15 à 30 secondes, sans reproduire l'article en miniature. La compétence prend en charge les entrées sous forme de répertoire d'article structuré (format MinerU), de fichier PDF, ou d'URL arXiv/PDF. Le flux de travail combine des outils déterministes (ingestion, inspection, vérification de mise en page, rendu) avec un agent IA pour les tâches nécessitant un jugement éditorial : synthèse, sélection des figures, rédaction narrative et ajustements HTML. Le résultat attendu est un poster HTML 16:9 unique (ou une carte de partage téléphone 9:16) avec une mise en page optimisée : texte à gauche, figures à droite, et une structure narrative en quatre blocs (Contexte, Lacune, Proposition, Résultats clés). La compétence insiste sur une sélection rigoureuse des figures (2-4, de préférence 2-3 fortes), des légendes interprétatives et un auto-contrôle final avant rendu (vérification de mise en page, cohérence narrative).

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add USTC-Astro/coffee_break_poster

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Coffee Break Poster (Affiche de Pause-Café Astronomique)

Créez un poster de pause-café astronomique sur un seul écran, mettant en avant les figures.

Cette compétence est destinée au partage rapide d'articles arXiv pendant une pause-café, un journal club, un séminaire ou une discussion informelle. L'objectif n'est pas de reproduire l'article en miniature. L'objectif est d'inciter les gens à s'arrêter, à regarder et à retenir pourquoi l'article est intéressant, ce qu'il affirme, et quel est le message à retenir.

Public par défaut : lecteurs d'astronomie généralistes. Sauf demande explicite de l'utilisateur, n'optimisez pas uniquement pour des spécialistes.

Objectif Principal du Produit

Le poster doit fonctionner comme un argumentaire visuel rapide pour l'article :

  • Un lecteur doit comprendre l'idée principale en 15 à 30 secondes.
  • Le poster doit être intéressant avant d'être exhaustif.
  • Le principal travail intellectuel consiste à mettre en évidence le point fort / message à retenir / pourquoi c'est important, pas à reformuler les détails de la méthode.
  • Les figures doivent porter la majeure partie de l'information ; le texte doit guider l'attention et l'interprétation.

Ne transformez pas le poster en :

  • une revue technique
  • un résumé article section par section
  • une note lourde en méthodologie
  • un mur de texte avec des figures collées comme décoration

Répertoire de Travail

  • Si l'utilisateur fournit un répertoire de travail, utilisez-le.
  • Sinon, utilisez /Users/chensj/repository/coffee_break_poster/work/<paper_slug>/.
  • N'écrivez pas les posters générés dans un répertoire de compétence installé.

Prérequis

Cette compétence suppose que l'interface en ligne de commande cbp est disponible dans le PATH via une installation normale du paquet ou une installation modifiable de ce dépôt.

Résultat Attendu

Produisez un poster HTML unique au format 16:9 pouvant être vérifié et converti en PNG/PDF.

Pour un partage de style WeChat/iPhone, produisez plutôt une carte de partage téléphone 9:16 :

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

Le format téléphone est un argumentaire condensé, pas un résumé complet de l'article. Privilégiez une figure vedette plus 1 à 2 figures de soutien, et réécrivez le texte en un accroche courte, Pourquoi c'est important, Ce que cet article montre, et À retenir. Ne versez pas le texte du format 16:9 dans la carte verticale.

La structure par défaut du poster comprend exactement ces blocs de texte :

  1. Contexte (Background)
  2. Lacune (Knowledge gap)
  3. Ce que cet article propose (What this paper is selling)
  4. Résultats clés à retenir (Key results to remember)

plus 2 à 4 figures avec des légendes courtes.

Lorsqu'un identifiant arXiv peut être déduit, les métadonnées de droite/en-tête incluent un lien arXiv cliquable, le DOI arXiv canonique, et un code QR vers la page du résumé arXiv.

En pratique, la colonne de texte de gauche doit se lire comme un argumentaire compact :

  1. Pourquoi les gens devraient-ils s'y intéresser ?
  2. Qu'est-ce qui manquait avant cet article ?
  3. Que prétend apporter cet article ?
  4. Quelles preuves rendent cette affirmation digne de mémoire ?

Flux de Travail

1. Normaliser l'entrée

cbp ingest INPUT --workdir work

2. Inspecter l'inventaire déterministe de l'article

cbp inspect PAPER_DIR --json

Utilisez ceci pour inspecter les sections, les fichiers image, les dimensions et les légendes candidates. Cette commande ne résume pas l'article pour vous.

3. Lire uniquement ce dont vous avez besoin, puis prendre les décisions scientifiques/rédactionnelles

Lisez paper.md de manière sélective. Ne déversez pas et ne paraphrasez pas l'intégralité de l'article. Concentrez-vous sur :

  • le résumé et la conclusion
  • les quelques paragraphes nécessaires pour comprendre l'affirmation centrale
  • le contexte local autour des figures que vous pourriez utiliser

Ensuite, prenez les décisions au niveau du poster :

  • Écrivez un titre qui énonce ce que nous apprenons de l'article, pas seulement le sujet.
  • Écrivez un sous-titre qui cadre l'enjeu astrophysique intéressant ou l'accroche.
  • Remplissez les blocs de texte pour qu'ils forment une histoire cohérente.
  • Choisissez 2 à 4 figures, généralement 2 à 3 figures fortes plutôt que de remplir les emplacements mécaniquement.
  • Gardez les méthodes courtes sauf si elles sont essentielles pour la crédibilité.

4. Ébaucher et éditer

cbp scaffold PAPER_DIR

Éditez poster.html directement. Le modèle par défaut est 16:9, avec le texte à gauche et les figures à droite.

Utilisez uniquement les figures qui portent l'histoire. Ne remplissez pas les emplacements avec des figures faibles. Si le poster nécessite moins de quatre figures, ébauchez ou révisez le panneau de figures comme une mise en page délibérément à faible nombre, pas comme une grille 2x2 avec des emplacements vides ou faibles :

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

Le modèle à 1 figure utilise une grande figure vedette visuelle. Le modèle à 2 figures utilise une figure principale plus un panneau de soutien. Le modèle à 3 figures utilise une grande figure vedette plus deux figures de soutien. Utilisez ces modes lorsque les figures sélectionnées sont scientifiquement plus fortes qu'une grille complète de quatre emplacements.

Pour une carte de partage téléphone, choisissez explicitement le modèle vertical :

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

Utilisez --figure-count 4 pour la sortie téléphone uniquement si l'utilisateur demande explicitement quatre figures ; c'est généralement trop dense pour une image de partage compressée.

5. Vérifier et itérer

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

Pour une sortie téléphone, utilisez la fenêtre d'affichage adaptée au format :

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

C'est une étape obligatoire. Si la vérification signale un débordement, des descendants tronqués, des figures trop petites, des images cassées, une zone de figure vide ou une région de mise en page effondrée, éditez poster.html et relancez la vérification. Les outils mesurent la mise en page ; l'agent doit adapter le contenu, le choix des figures, les légendes et le CSS.

Pour une explication compacte de ce qu'il faut changer, exécutez :

cbp diagnose PAPER_DIR/poster.html

Ordre d'adaptation de la mise en page :

  1. Raccourcissez la prose et les légendes.
  2. Si une ou plusieurs figures sont secondaires, passez à une mise en page à 1, 2 ou 3 figures au lieu de remplir les emplacements vides.
  3. Ajustez les variables CSS telles que l'échelle du texte, l'échelle des légendes, la hauteur de l'en-tête, l'espacement des figures ou le rapport texte/figure.
  4. Modifiez la structure de la mise en page uniquement si les étapes précédentes ne résolvent pas le problème mesuré.

6. Rendu

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

Pour une sortie téléphone :

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

render exécute d'abord la vérification de mise en page et refuse d'écraser les sorties de prévisualisation si le poster ne réussit pas la vérification. Utilisez --force uniquement pour le débogage d'une mise en page cassée, jamais pour la livraison finale.

Règles Éditoriales

Titre

Le titre doit dire ce que l'article nous apprend.

Bonnes propriétés d'un titre :

  • plutôt une affirmation qu'un sujet
  • assez court pour être parcouru rapidement
  • mémorable pour un lecteur astronome non spécialiste
  • ancré dans l'apport de connaissance le plus fort de l'article

Évitez les titres qui ne sont que :

  • le titre de l'article reformulé
  • une étiquette de sujet vague
  • un cadrage axé sur la méthode quand le vrai point est un résultat scientifique

Sous-titre

Le sous-titre doit être une courte accroche, généralement une phrase.

Utilisez-le pour répondre à l'une de ces questions :

  • pourquoi ce résultat est surprenant
  • à quel problème plus large il se rattache
  • quel type de preuve rend l'article intéressant

N'utilisez pas le sous-titre pour un long résumé de type abstract.

Contexte

Contexte répond à :

  • pourquoi un large public astronomique devrait-il s'y intéresser ?
  • à quelle question astrophysique plus large cela est-il lié ?

Ne commencez pas par les noms de relevés, les tailles d'échantillons, les menus détails instrumentaux ou une chaîne de qualificatifs techniques, sauf si c'est l'accroche réelle.

Lacune

Lacune doit être la pièce manquante précise qui motive l'article.

Elle doit être étroitement liée au contexte. Une bonne lacune affine l'histoire de « ce domaine est important » à « voici ce que nous ne pouvions pas encore expliquer ou établir avant cet article ».

La lacune doit généralement correspondre à l'échelle réelle de la contribution de l'article :

  • article d'étude de cas -> lacune d'identification / interprétation de cas
  • article de population -> lacune démographique / de tendance / de comparaison
  • article théorique -> lacune de mécanisme / cohérence / prédiction

Ne posez pas une question au niveau de la population si l'article ne fournit qu'une preuve portant sur un objet, à moins que le poster ne présente explicitement l'article comme une preuve d'existence ou un ancrage méthodologique.

Ce que cet article propose

Cette section doit comporter 2 à 3 phrases.

Elle doit répondre à :

  • que l'article essaie-t-il de nous persuader de croire ?
  • quel est le plus fort apport de connaissance ici ?
  • pourquoi cet article mérite-t-il d'être partagé pendant une pause-café ?

Ce n'est pas un rapport d'évaluation. Si nécessaire, vous pouvez inclure une réserve légère, mais le travail principal est d'identifier le point fort de vente de l'article.

Résultats clés à retenir

Utilisez 3 à 4 puces courtes.

Chaque puce doit être :

  • centrée sur les preuves
  • suffisamment concrète pour être mémorisée
  • clairement liée au point fort de vente
  • débarrassée des détails méthodologiques non essentiels

Préférez des puces qui ressemblent à des « messages à retenir pour le lecteur pressé », pas à des fragments de cahier de laboratoire.

Logique Narrative : Les Sections Doivent Être Connectées

Le poster doit se lire comme un seul argumentaire, pas comme quatre résumés indépendants.

Chaîne logique requise :

  1. Contexte explique pourquoi la question est importante.
  2. Lacune énonce ce qui manquait avant cet article.
  3. Ce que cet article propose dit ce que l'article prétend apporter ou clarifier.
  4. Résultats clés à retenir fournissent les preuves ou conséquences mémorables qui soutiennent cette affirmation.

Si l'histoire ne suit pas cet ordre, réécrivez-la.

Modes d'échec courants à éviter :

  • Contexte est large, mais Lacune concerne autre chose.
  • Proposition est générique et ne répond pas à la lacune énoncée.
  • Résultats clés sont des faits vrais de l'article mais ne soutiennent pas le point fort.
  • Le poster pose une question mais en répond à une autre.
  • Le texte semble techniquement correct mais n'est pas intéressant.

Règles de Sélection des Figures

Choisissez des figures qui aident un lecteur à comprendre rapidement l'histoire.

Priorisez, dans l'ordre :

  1. une figure qui définit l'objet, l'échantillon ou le problème
  2. une figure qui montre le résultat principal
  3. une figure qui replace le résultat dans un contexte ou une comparaison plus large

Conservez généralement 2 à 3 figures fortes. N'utilisez une 4e figure que si elle ajoute clairement une valeur narrative.

Évitez les figures qui sont principalement :

  • des organigrammes de méthodes
  • des graphiques de coins de paramètres
  • des vérifications internes de cohérence
  • des diagnostics de spécialistes nécessitant trop de contexte

à moins qu'elles ne soient le seul moyen de rendre crédible l'affirmation centrale.

Légendes des Figures

Chaque légende de figure doit répondre à :

  • pourquoi cette figure est-elle ici ?
  • que doit en retenir un lecteur pressé ?

Les légendes doivent interpréter, pas simplement étiqueter.

Mauvais style de légende :

  • décrit les axes du graphique sans dire le point essentiel
  • reformule uniquement le titre du panneau
  • explique des détails procéduraux mais pas la signification scientifique

Bon style de légende :

  • dit ce que la figure établit
  • dit pourquoi cela importe pour l'affirmation principale de l'article
  • utilise une formulation courte et mémorable

Méthodes : Retenue par Défaut

Ne consacrez pas beaucoup d'espace du poster aux méthodes, sauf si la confiance dans la méthode est centrale pour l'affirmation.

Un peu de méthode n'est utile que lorsqu'elle répond à :

  • pourquoi devrions-nous faire confiance à cette interprétation ?
  • qu'y a-t-il de spécial dans les preuves ?
  • qu'est-ce qui lève une ambiguïté antérieure ?

Si la méthode ne porte pas ce fardeau, supprimez-la.

Style

  • Police pour le titre et le texte principal : Helvetica, Arial, sans-serif.
  • Sous-titre : italique, non gras, dans la même police Helvetica.
  • Lacune / mise en évidence : peut utiliser "Gill Sans", "Gill Sans MT", Helvetica, Arial, sans-serif.
  • Évitez les longs paragraphes.
  • Utilisez le gras avec parcimonie, uniquement pour les mots que les gens devraient réellement retenir.
  • Les figures doivent porter la majeure partie de l'information.
  • Le poster doit tenir sur un seul écran commun sans défilement.
  • Ne forcez pas l'étirement des images ; préservez les proportions des figures.

Auto-Vérification Finale Avant le Rendu

Avant de rendre, vérifiez :

  1. Le poster est-il intéressant pour quelqu'un qui n'a pas lu l'article ?
  2. Le titre communique-t-il un véritable message à retenir ?
  3. Contexte et Lacune sont-ils étroitement liés ?
  4. Ce que cet article propose répond-il clairement à cette lacune ?
  5. Les Résultats clés à retenir soutiennent-ils réellement le point fort ?
  6. Chaque figure soutient-elle une partie spécifique de l'histoire ?
  7. Un lecteur pourrait-il expliquer l'idée principale de l'article après 15 à 30 secondes ?
  8. Avez-vous supprimé les détails méthodologiques qui n'améliorent pas la confiance ?
  9. Les figures portent-elles visuellement la majeure partie de l'information ?
  10. La mise en page reste-t-elle propre après check ?

Si la réponse à l'une de ces questions est non, révisez poster.html et relancez check.

Skills associés