Communitygithub.com

コーヒーブレイクポスター(天文学論文用)

MinerU形式の論文ディレクトリ、PDF、arXiv URL、またはPDFの直接URLから、天文学コーヒーブレイク用の1画面ポスターを作成します。取り込み、検査、レイアウトチェック、レンダリングには deterministic な tools/ 以下のツールを使用し、要約、図の選択、ナラティブデザイン、HTML編集にはエージェントを使用します。

コーヒーブレイクポスター(天文学論文用) とは?

このスキルは、天文学の論文を迅速に共有するための1画面16:9 HTMLポスター、またはWeChat/iPhone向けの9:16縦型共有カードを作成するためのものです。主な目的は、論文を縮小コピーすることではなく、コーヒーブレイク、ジャーナルクラブ、セミナーなどで、人々が足を止めて「なぜこの論文が面白いのか」「何を主張しているのか」「何が takeaways か」を理解できるようにすることです。デフォルトの対象読者は天文学の幅広い読者で、専門家だけに最適化するのではありません。ワークフローは、まず cbp ingest で入力を標準化し、cbp inspect で論文の構造を確認、その後エージェントが論文を選択的に読み、科学的・編集的判断を行います。cbp scaffold でポスターテンプレートを生成し、cbp check でレイアウトのオーバーフローなどをチェック、cbp render で最終的なPNG/PDFを出力します。このスキルは、天文学者、大学院生、サイエンスコミュニケーターがarXiv論文を迅速に共有・議論するのに役立ちます。

対応~Claude Code~Codex CLI~Cursor
npx skills add USTC-Astro/coffee_break_poster

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

コーヒーブレイクポスター(天文学論文用) は何をしますか?

1画面、図表重視の天文学コーヒーブレイクポスターを作成します。

このスキルは、コーヒーブレイク、ジャーナルクラブ、セミナー、廊下での議論中にarXiv論文を素早く共有するためのものです。目的は論文を縮小コピーすることではなく、人々に立ち止まってもらい、論文がなぜ面白いのか、何を主張しているのか、何がtake-awayなのかを見てもらい、覚えてもらうことです。

デフォルトの対象読者:天文学の幅広い読者。ユーザーから明示的に別の指定がない限り、専門家だけに最適化しないでください。

コアプロダクト目標

ポスターは論文の高速ビジュアルピッチとして機能する必要があります:

  • 読者は15~30秒で主旨を理解できること。
  • ポスターは網羅的である前に面白いこと。
  • 主な知的作業は、売り/ take-away / なぜこれが重要なのかを表面化することで、方法の詳細を言い換えることではありません。
  • 図が情報の大部分を担い、テキストは注意と解釈を導くこと。

ポスターを次のようにしてはいけません:

  • 技術レビュー
  • セクションごとの論文要約
  • 方法論重視のメモ
  • 図を装飾として貼り付けたテキストの壁

作業ディレクトリ

  • ユーザーが作業ディレクトリを指定した場合はそれを使用します。
  • それ以外の場合は /Users/chensj/repository/coffee_break_poster/work/<paper_slug>/ を使用します。
  • 生成したポスターをインストール済みスキルディレクトリに書き込まないでください。

前提条件

このスキルは、cbp CLI が通常のパッケージインストールまたはこのリポジトリの編集可能インストールにより PATH 上で使用可能であることを前提とします。

期待される出力

1画面 16:9 HTML ポスター を生成し、PNG/PDF にチェック&レンダリングできるようにします。

WeChat/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つのヒーロー図と1~2の補足図を優先し、コピーを短いフック、「なぜ重要なのか」、「この論文が示すこと」、「忘れないで」に書き直してください。16:9のテキストをそのまま縦型カードに流し込まないでください。

デフォルトのポスター構造は、正確に以下のテキストブロックで構成されます:

  1. 背景
  2. 知識のギャップ
  3. この論文の売り
  4. 覚えておくべき主な結果

さらに 2~4の図 と短いキャプション。

arXiv ID が推測できる場合、右側/ヘッダーのメタデータにはクリック可能なarXivリンク、正規のarXiv DOI、arXiv抄録ページへのQRコードが含まれます。

実際には、左のテキスト列は1つのコンパクトな議論として読めるべきです:

  1. なぜ人々が気にかけるべきか?
  2. この論文以前に欠けていたものは何か?
  3. この論文は何を追加すると主張しているか?
  4. その主張を記憶に値ものとする証拠は何か?

ワークフロー

1. 入力を正規化

cbp ingest INPUT --workdir work

2. 決定論的な論文インベントリを検査

cbp inspect PAPER_DIR --json

これを使用して、セクション、画像ファイル、寸法、候補キャプションを検査します。このコマンドは論文を要約しません。

3. 必要なものだけを読み、科学的/編集上の選択を行う

paper.md を選択的に読みます。論文全体をダンプしたり言い換えたりしないでください。以下に焦点を当てます:

  • 抄録と結論
  • 中心的な主張を理解するために必要な数段落
  • 使用する可能性のある図の周辺のローカルコンテキスト

次に、ポスターレベルの選択を行います:

  • 見出し を書きます。トピックだけでなく、論文から学べることを述べます。
  • サブタイトル を書きます。興味深い天文学上のステークやフックをフレーミングします。
  • テキストブロックを1つのまとまったストーリーになるように埋めます。
  • 2~4の図を選びます。通常は機械的にスロットを埋めるのではなく2~3の強い図を選びます。
  • 信頼性に不可欠でない限り、方法は短く保ちます。

4. スキャフォールドと編集

cbp scaffold PAPER_DIR

poster.html を直接編集します。デフォルトテンプレートは16:9で、左にテキスト、右に図です。

ストーリーを伝える図のみを使用します。弱い図でスロットを埋めないでください。ポスターに必要な図が4つ未満の場合は、2x2グリッドに空のスロットや弱いスロットを作るのではなく、意図的に図の少ないレイアウトをスキャフォールドまたは修正します:

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

1図テンプレートは1つの大きなビジュアルヒーローを使用します。2図テンプレートはメインの図と1つの補助パネルを使用します。3図テンプレートは1つの大きなヒーロー図と2つの補助図を使用します。選択した図が4スロットグリッド全体よりも科学的に強い場合にこれらのモードを使用してください。

電話共有カードの場合は、明示的に縦型テンプレートを選択します:

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

電話出力で --figure-count 4 を使用するのは、ユーザーが明示的に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. 1つ以上の図が二次的な場合は、空のスロットを埋める代わりに1、2、3図レイアウトに切り替えます。
  3. テキストスケール、キャプションスケール、ヘッダー高さ、図のギャップ、テキスト/図比率などのCSS変数を調整します。
  4. 上記の手順で測定された問題が解決しない場合のみ、構造レイアウトを変更します。

6. レンダリング

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

電話出力の場合:

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

render は最初にレイアウトチェックを実行し、ポスターが合格しない場合はプレビュー出力の上書きを拒否します。--force は壊れたレイアウトのデバッグにのみ使用し、最終納品には決して使用しないでください。

編集ルール

見出し

見出しは論文が教えてくれることを述べるべきです。

良い見出しの特性:

  • 主張らしく、トピックらしくない
  • 素早くスキャンできるほど短い
  • 非専門家の天文読者が覚えやすい
  • 論文の最も強い知識増分に基づいている

以下のような見出しは避けてください:

  • 論文タイトルを言い換えただけ
  • 漠然としたトピックラベル
  • 本当のポイントが科学的結果である場合の方法優先のフレーミング

サブタイトル

サブタイトルは短いフック、通常は1文にします。

以下のいずれかに答えるために使用します:

  • この結果がなぜ驚くべきか
  • どのようなより大きな問題に結びついているか
  • どのような種類の証拠が論文を興味深いものにしているか

長い抄録風の要約にサブタイトルを使用しないでください。

背景

背景 は以下に答えます:

  • なぜ幅広い天文読者が気にかけるべきか?
  • これはどのようなより大きな天体物理学的問題に結びついているか?

調査名、サンプルサイズ、機器の細部、または技術的な修飾語の連鎖で始めないでください。それらが実際のフックである場合を除きます。

知識のギャップ

知識のギャップ は、論文の動機となる正確に欠けているピースであるべきです。

背景と密接にリンクしている必要があります。良いギャップはストーリーを「この分野が重要」から「これがこの論文以前に説明または確立できなかったこと」へと研ぎ澄まします。

ギャップは通常、論文の実際の貢献の規模に一致するべきです:

  • ケーススタディ論文 → ケース同定/解釈のギャップ
  • 集団論文 → 人口統計/傾向/比較のギャップ
  • 理論論文 → メカニズム/整合性/予測のギャップ

論文が1つの対象の証拠しか提供しない場合、集団レベルの質問をしないでください。ポスターがその論文を存在証明や方法のアンカーとして明確にフレーミングしている場合を除きます。

この論文の売り

このセクションは2~3文にします。

以下に答えるべきです:

  • 論文は私たちに何を信じさせるよう試みているか?
  • ここで最も強い知識増分は何か?
  • なぜこの論文はコーヒーブレイク中に共有する価値があるか?

これはレビューレポートではありません。必要であれば軽微な注意事項を含めても構いませんが、主な仕事は論文の最も強い売りポイントを特定することです。

覚えておくべき主な結果

3~4の短い箇条書きを使用します。

各箇条書きは:

  • 証拠中心
  • 覚えられるほど具体的
  • 売りポイントに明確に結びついている
  • 非本質的な方法の詳細を取り除いている

「忙しい読者のtake-away」のように聞こえる箇条書きを優先し、ノートブックの断片のようにはしないでください。

ストーリーのロジック:セクションは接続されていなければならない

ポスターは4つの独立した要約ではなく、1つの議論として読めるべきです。

必要な論理チェーン:

  1. 背景 はなぜその問題が重要なのかを説明します。
  2. 知識のギャップ はこの論文以前に何が欠けていたかを述べます。
  3. この論文の売り は論文が何を追加/明確化すると主張するかを述べます。
  4. 覚えておくべき主な結果 はその主張を支持する証拠または記憶に残る結果を提供します。

ストーリーがその順序で流れていない場合は、書き直してください。

避けるべき一般的な失敗モード:

  • 背景 が広範だが、知識のギャップ が別のことについてである。
  • 売り が一般的で、述べられたギャップに答えていない。
  • 主な結果 が論文からの真実の事実だが、売りポイントを支持していない。
  • ポスターがある質問をしているが、別の質問に答えている。
  • テキストが技術的には正しいが、面白くない。

図の選択ルール

読者がストーリーを素早く理解するのに役立つ図を選びます。

優先順位は次の順です:

  1. オブジェクト、サンプル、または問題を定義する図
  2. 主な結果を示す図
  3. 結果をより広いコンテキストまたは比較に置く図

通常は2~3の強い図を保持します。明確にナラティブ価値を追加する場合のみ4つ目を使用します。

主に以下のような図は避けてください:

  • 方法フローチャート
  • パラメータ相関プロット
  • 内部の健全性チェック
  • セットアップに多くの説明が必要な専門家向け診断図

ただし、それらがコアクレームを信頼できるものにする唯一の方法である場合は除きます。

図のキャプション

各図のキャプションは以下に答えるべきです:

  • なぜこの図がここにあるのか?
  • 忙しい読者はそれから何を覚えるべきか?

キャプションは解釈すべきであり、単にラベル付けするだけではいけません。

悪いキャプションのスタイル:

  • ポイントを伝えずにプロット軸を説明する
  • パネルタイトルだけを言い換える
  • 手続き上の詳細を説明するが、科学的意味は説明しない

良いキャプションのスタイル:

  • 図が何を確立するかを述べる
  • それが論文の主な主張にとってなぜ重要かを述べる
  • 短くて覚えやすいフレーズを使う

方法:デフォルトの抑制

方法の信頼性が主張の中心でない限り、ポスターのスペースを方法にあまり割かないでください。

少量の方法は、以下の質問に答える場合にのみ有用です:

  • なぜこの解釈を信頼すべきか?
  • この証拠の何が特別か?
  • 何が以前の曖昧さを打破するか?

方法がその負担を負っていない場合は、削減します。

スタイル

  • タイトルと本文フォントスタック:Helvetica, Arial, sans-serif。
  • サブタイトル:イタリック、非太字、同じHelveticaスタック。
  • 知識ギャップ/強調プロンプトには "Gill Sans", "Gill Sans MT", Helvetica, Arial, sans-serif を使用できます。
  • 長い段落を避けてください。
  • 太字は控えめに、人々が実際に覚えるべき単語にのみ使用します。
  • 図が情報の大部分を担うべきです。
  • ポスターは1つの一般的なディスプレイにスクロールなしで収まる必要があります。
  • 画像の引き伸ばしを強制しないでください。図のアスペクト比を保持します。

レンダリング前の最終セルフチェック

レンダリング前に、以下を確認します:

  1. 論文を読んでいない人にとってポスターは面白いか?
  2. 見出しは実際のtake-awayを伝えているか?
  3. 背景 と 知識のギャップ は密接にリンクしているか?
  4. この論文の売り はそのギャップに明確に答えているか?
  5. 覚えておくべき主な結果 は実際に売りポイントを支持しているか?
  6. 各図はストーリーの特定の部分を支持しているか?
  7. 読者は15~30秒後に論文の主旨を説明できるか?
  8. 信頼性を向上させない方法の詳細を削除したか?
  9. 図が情報の大部分を視覚的に担っているか?
  10. check 後もレイアウトはクリーンか?

いずれかの答えが「いいえ」の場合は、poster.html を修正して check を再実行します。

関連スキル