咖啡休息海報
製作一頁、以圖為核心的天文咖啡休息海報。
此技能適用於在咖啡時間、期刊俱樂部、研討會或走廊討論中快速分享 arXiv 論文。目標不是將論文縮小複製，而是讓人們停下來、觀看，並記住為什麼這篇論文有趣、它主張什麼、以及關鍵要點是什麼。
預設受眾：廣泛的天文學讀者。除非使用者明確要求，否則不要只針對專家優化。
核心產品目標
海報應作為論文的快速視覺簡報：
- 讀者應在 15-30 秒 內理解主要論點。
- 海報應在詳盡之前先引人興趣。
- 主要智慧工作在於呈現賣點 / 要點 / 為什麼重要，而不是重述方法細節。
- 圖表應承載大部分資訊；文字應引導注意力與解讀。
不要將海報變成：
- 技術評論
- 逐節論文摘要
- 方法論為主的筆記
- 文字牆配上裝飾性的圖表
工作目錄
- 如果使用者提供工作目錄，則使用之。
- 否則使用
/Users/chensj/repository/coffee_break_poster/work/<論文縮寫>/。 - 請勿將生成的海報寫入已安裝的技能目錄。
前置條件
此技能假設 cbp CLI 已透過此儲存庫的一般套件安裝或可編輯安裝，存在於 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 摘要頁面的 QR 碼。
實務上，左側文字欄應形成一個緊湊的論證：
- 為什麼人們應該關心？
- 在這篇論文之前缺少什麼？
- 這篇論文聲稱增加了什麼？
- 什麼證據讓這個主張值得記住？
工作流程
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 張強圖表。僅在第四張圖表明顯增加敘事價值時才使用。
避免主要是以下類型的圖表：
- 方法流程圖
- 參數角落圖
- 內部合理性檢查
- 需要太多背景知識的專家診斷圖
除非它們是使核心主張可信的唯一方法。
圖表說明
每個圖表說明應回答：
- 為什麼這個圖表在這裡？
- 忙碌的讀者應該從中記住什麼？
說明應解釋，而不僅僅是標籤。
不好的說明風格：
- 描述繪圖軸而不說明重點
- 僅重述面板標題
- 解釋程序細節但不說明科學意義
好的說明風格：
- 說明圖表建立了什麼
- 說明為什麼它對論文的主要主張重要
- 使用簡短、令人難忘的措辭
方法：預設克制
除非方法的可信度對主張至關重要，否則不要在海報上花費太多空間介紹方法。
少量方法僅在回答以下問題時才有用：
- 為什麼我們應該相信這個解釋？
- 證據有什麼特別之處？
- 什麼打破了先前的模糊性？
如果方法沒有承擔這個責任，就刪減它。
樣式
- 標題和主要文字字型堆疊：
Helvetica, Arial, sans-serif。 - 副標題：斜體、非粗體，使用相同的 Helvetica 堆疊。
- 知識缺口 / 突出提示可使用
"Gill Sans", "Gill Sans MT", Helvetica, Arial, sans-serif。 - 避免長段落。
- 謹慎使用粗體，僅用於人們實際應該記住的詞語。
- 圖表應承載大部分資訊。
- 海報必須在一個常見的顯示器上適合顯示，無需滾動。
- 不要強制拉伸圖片；保留圖表長寬比。
渲染前的最終自我檢查
渲染前，請驗證：
- 這張海報對未讀過論文的人有趣嗎？
- 標題是否傳達了真正的要點？
背景和知識缺口是否緊密相連？這篇論文的賣點是否清楚回應了該缺口？要記住的關鍵結果是否真正支持了賣點？- 每個圖表是否支持故事的特定部分？
- 讀者能否在 15-30 秒後解釋論文的主要論點？
- 你是否移除了未增進信任的方法細節？
- 圖表是否在視覺上承載了大部分資訊？
檢查之後佈局是否保持乾淨？
如果任何答案為否，請修改 poster.html 並重新執行 check。