咖啡休息海报

创建一屏、以图形为主的天体物理咖啡休息海报。

此技能适用于咖啡休息、期刊俱乐部、研讨会或走廊讨论中的快速 arXiv 分享。目标不是将论文缩微复制，而是让人们停下来、观看并记住论文为何有趣、它声称了什么以及结论是什么。

默认受众：广泛的宇宙学读者。除非用户明确要求，否则不要仅针对专家优化。

核心产品目标

海报应作为论文的快速视觉推介：

读者应在 15-30 秒 内理解主要观点。
海报应在详尽之前先有趣。
主要的智力工作在于揭示卖点/结论/为何重要，而非重述方法细节。
图形应承载大部分信息；文字应引导注意力和解读。

不要将海报变成：

一份技术综述
按章节的论文摘要
侧重方法的笔记
以文字为主、图形仅作装饰的“文字墙”

工作目录

如果用户提供了工作目录，则使用它。
否则使用 /Users/chensj/repository/coffee_break_poster/work/<论文缩写>/。
不要将生成的海报写入已安装的技能目录。

前提条件

此技能假设 cbp CLI 可以通过该仓库的正常 pip 安装或可编辑安装存在于 PATH 中。

预期输出

生成一个单屏 16:9 的 HTML 海报，可进行布局检查并渲染为 PNG/PDF。

对于微信/iPhone 风格的分享，改为生成一个配套的 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

手机格式是一个紧凑的推介，而不是完整的论文摘要。建议使用一张主图加 1-2 张辅助图，并将文案重写为一个简短钩子、“为何重要”、“本文展示的内容”和“记住”。不要将 16:9 的文本直接倒入竖版卡片中。

默认海报结构恰好包含以下文本块：

背景
知识空白
本文的卖点
需要记住的关键结果

外加 2-4 张图形，配有简短说明。

当可以推断出 arXiv ID 时，右/头部元数据包含一个可点击的 arXiv 链接、规范的 arXiv DOI 以及指向 arXiv 摘要页面的二维码。

实际上，左侧文本列应读起来像一个紧凑的论点：

人们为什么要在意？
在本文之前缺少什么？
本文声称增加了什么？
哪些证据使这一主张值得记住？

工作流程

1. 归一化输入

cbp ingest INPUT --workdir work

2. 检查确定性的论文清单

cbp inspect PAPER_DIR --json

使用此命令检查章节、图像文件、尺寸和候选说明。此命令不会为您总结论文。

3. 仅选择性阅读所需内容，然后做出科学/编辑决策

有选择地阅读 paper.md。不要转储或改写整篇论文。专注于：

摘要和结论
理解核心主张所需的少数段落
您可能使用的图形周围的局部上下文

然后做出海报层面的决策：

撰写一个标题，陈述我们从论文中学到的内容，而不仅仅是主题。
撰写一个副标题，框定有趣的天体物理利害关系或钩子。
填充文本块，使其形成一个连贯的故事。
选择 2-4 张图形，通常选择 2-3 张强的，而不是机械地填满所有位置。
除非方法对建立信任至关重要，否则保持简短。

4. 脚手架搭建与编辑

cbp scaffold PAPER_DIR

直接编辑 poster.html。默认模板为 16:9，左侧为文本，右侧为图形。

只使用承载故事的图形。不要用弱图填满位置。如果海报需要少于四张图，则将图形面板调整为有意的低数量布局，而不是一个包含空位或弱位的 2x2 网格：

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

1 图模板使用一个大的视觉主图。2 图模板使用一张主图加一个辅助面板。3 图模板使用一张大主图加两张辅助图。当所选图形在科学上比完整的四插槽网格更强时，使用这些模式。

对于手机分享卡片，明确选择竖版模板：

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

仅当用户明确要求四张图形时，才为手机输出使用 --figure-count 4；对于压缩的分享图像，四张图通常过于密集。

5. 检查与迭代

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

对于手机输出，使用格式感知视口：

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

这是一个硬性关卡。如果检查报告溢出、裁剪的后代元素、微小的图形、损坏的图像、空白的图形区域或折叠的布局区域，则编辑 poster.html 并重新运行。工具测量布局；智能体必须调整内容、图形选择、说明和 CSS。

要获得需要更改内容的简洁说明，请运行：

cbp diagnose PAPER_DIR/poster.html

布局调整顺序：

缩短散文和说明。
如果一个或多个图形是次要的，则切换到 1、2 或 3 图布局，而不是填充空位。
调整 CSS 变量，如文本缩放、说明缩放、页眉高度、图形间距或文本/图形比例。
仅当上述步骤无法解决测量的问题时，才更改结构布局。

6. 渲染

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

对于手机输出：

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

render 首先运行布局检查，如果海报未通过，则拒绝覆盖预览输出。仅用于调试损坏的布局时使用 --force，绝不用于最终交付。

编辑规则

标题

标题应说明论文教会了我们什么。

好标题的特性：

更像是主张而非主题
足够短，可快速浏览
对非专业的天体物理读者来说易于记忆
锚定在论文最强的知识增量上

避免仅包含以下内容的标题：

论文标题的改写
模糊的主题标签
当真正的要点是科学结果时，以方法为先的框架

副标题

副标题应是一个简短的钩子，通常为一句话。

用它来回答以下问题之一：

这一结果为何令人惊讶？
它连接到了什么更大的问题？
什么类型的证据使这篇论文有趣？

不要将副标题用于类似摘要的冗长总结。

背景

背景 回答：

为何广泛的天体物理受众应该在意？
这与什么更大的天体物理问题相关？

不要以调查名称、样本大小、仪器细节或一连串技术限定词开头，除非这些正是真正的钩子。

知识空白

知识空白 应是推动论文的精确缺失部分。

它必须紧密关联到背景。一个好的空白将故事从“这个领域很重要”锐化为“这就是在本文之前我们仍然无法解释或确定的内容。”

空白通常应与论文的实际贡献规模相匹配：

案例研究论文 -> 案例识别/解读空白
群体论文 -> 人口统计/趋势/比较空白
理论论文 -> 机制/一致性/预测空白

如果论文只提供了一个对象的证据，则不要提出群体层面问题，除非海报明确将该论文框定为存在性证明或方法锚点。

本文的卖点

本节应有 2-3 句话。

它应回答：

论文试图说服我们相信什么？
这里最强的知识增量是什么？
为什么这篇论文值得在咖啡休息时分享？

这不是一份审稿报告。如有需要，可以包含轻微的限定，但主要工作是识别论文的最强卖点。

需要记住的关键结果

使用 3-4 个简短要点。

每个要点应是：

以证据为中心
足够具体，便于记忆
明确关联到卖点
去除非必要的方法细节

优先选择听起来像“忙碌读者结论”的要点，而不是笔记本片段。

故事逻辑：部分必须连贯

海报应读作一个论点，而不是四个独立的摘要。

所需的逻辑链：

背景 解释问题为何重要。
知识空白 陈述在本文之前缺少什么。
本文的卖点 说明论文声称增加或澄清了什么。
需要记住的关键结果 提供支持该主张的证据或令人难忘的后果。

如果故事不按此顺序流动，则重写它。

需避免的常见失败模式：

背景 很宽泛，但 知识空白 是关于其他事情。
卖点 很一般，没有回答已陈述的空白。
关键结果 是论文中的真实事实，但不支持卖点。
海报提出一个问题，却回答了另一个。
文字在技术上正确但无趣。

图形选择规则

选择有助于读者快速理解故事的图形。

按顺序优先选择：

定义对象、样本或问题的图形
展示主要结果的图形
将结果置于更广泛背景或比较中的图形

通常保留 2-3 张强图。仅当第 4 张图明显增加叙事价值时才使用它。

避免主要是以下内容的图形：

方法流程图
参数角图
内部健全性检查
需要大量背景知识的专业诊断图

除非它们是使核心主张可信的唯一方式。

图形说明

每条图形说明应回答：

为什么这张图在这里？
忙碌的读者应从图中记住什么？

说明应解读，而不仅仅是标记。

不好的说明风格：

描述坐标轴但不说明要点
仅重述面板标题
解释程序细节而不说明科学含义

好的说明风格：

说明图形确立了什么
说明它为何对论文的主要主张重要
使用简短、易记的措辞

方法：默认克制

不要在海报上花费大量空间用于方法，除非方法信任对主张至关重要。

仅当方法回答了以下问题时，才提供一点方法：

为什么我们应该相信这种解读？
证据有何特别之处？
什么打破了之前的歧义？

如果方法没有承担这一责任，则删减它。

风格

标题和正文文本字体栈：Helvetica, Arial, sans-serif。
副标题：斜体、非粗体，使用相同的 Helvetica 栈。
知识空白/高亮提示可使用 "Gill Sans", "Gill Sans MT", Helvetica, Arial, sans-serif。
避免长段落。
谨慎使用粗体，仅用于人们真正应该记住的词语。
图形应承载大部分信息。
海报必须适合一个普通显示屏幕而无须滚动。
不要强制拉伸图像；保留图形的宽高比。

渲染前的最终自查

在渲染之前，验证：

海报对尚未阅读论文的人是否有趣？
标题是否传达了真实的结论？
背景 和 知识空白 是否紧密关联？
本文的卖点 是否明确回答了该空白？
需要记住的关键结果 是否实际支持卖点？
每张图形是否支持故事的特定部分？
读者是否能在 15-30 秒后解释论文的主要观点？
是否已删除不能提高信任度的方法细节？
图形是否在视觉上承载了大部分信息？
在 check 之后布局是否保持整洁？

如果任何答案为否，则修改 poster.html 并重新运行 check。

咖啡休息海报（天体物理）