mcpField
R
research-presentation

research-presentation

github.com/yila-aiドキュメント13967 回インストール1 週間前に更新
リポジトリ

research-presentation について

research-presentationは、論文、研究資料、既存のスライドを編集可能なプレゼンテーションにまとめるスキルです。根拠を追跡できる研究発表向けに、資料抽出から構成、作成、レンダリング後の確認までを扱い、主張の範囲を守ります。

主な機能

  1. 01研究上の根拠を抽出し出典を記録
  2. 02聴衆に合わせた発表の流れを設計
  3. 03発表者ノート付きの編集可能なスライドを作成
  4. 04内容スライドに出典アンカーを追加
  5. 05レンダリングしてレイアウトと可読性を確認

活用シーン

  1. 01論文を学術発表用スライドにまとめる
  2. 02研究ノート、表、図から発表資料を作る
  3. 03科学的内容を保って既存のPPTXを改訂
  4. 04はみ出し、引用、図の読みやすさを確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/yila-ai/awesome-research-skills --skill research-presentation

インストール後、Claude Code で/research-presentationを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

NOTICE
agents/
openai.yaml
references/
layouts.md
narrative-planning.md
paper-extraction.md
qa-contract.md
rendering.md
themes.md
scripts/
audit_pptx.py
render_slides.py

詳細

研究発表

論文や研究コーパスを、聴衆が理解し、検証し、議論できるプレゼンテーションに変換します。中心となる約束は、証拠を損なわずに論文をスライドにすることです。つまり、原文の意味を保ち、段階的に展開するストーリーを組み立て、図を読みやすくし、主張の範囲を適切に保ち、ノートとレンダリング済みの QA 記録を添えた編集可能なスライドを作成します。

このスキルは、情報源の調査から最終的なスライド QA までのワークフローを担います。著者の科学的判断に取って代わったり、結果を捏造したり、主張を暗黙のうちに強めたりすることはありません。

リクエストの振り分け

リクエストを満たす最も限定的なルートを選択します。

入力/リクエストルート
1 件以上の PDF、論文、原稿以下の論文からスライドへの全ワークフローを実施します。最初に references/paper-extraction.md を読みます
研究メモ、表、図、またはプロトコル証拠に基づくプレゼンテーションのワークフローを実施します。根拠のない項目は補完せず、明示します
修正対象の既存 PPTX元のスライドを調査し、求められている場合はビジュアル上の契約を維持してから、同じレンダリング/QA ループを実施します
情報源の文書がないプレゼンテーション概要抽出は省略しますが、主張台帳、ストーリーの概要、情報源/アセットのメモ、ビジュアル QA は作成します
「見た目をよくして」または「スタイルを変えて」編集前に現在のスライドを診断し、科学的内容と引用を維持します

作成を始める前に、次の内容を 1 文で推定します。

最後までに、[聴衆] は [理解する/判断する/議論する] できるようになります。なぜなら、[証拠に裏付けられた中心的な要点] があるからです。

不足している選択肢によってスライドの内容が大きく変わる場合(例:学位審査かジャーナルクラブか)に限り、作業を止めて確認する質問を最大 1 つ行います。それ以外の場合は、慎重な前提を置き、実行ログに記載します。

必ず守る契約

  1. 証拠を優先します。 スライドの順序を計画する前に、情報源を読みます。提示された情報源、または明示的に引用した外部情報源にたどれない図、数値、表のセル、引用、メカニズム、制約は使用しません。
  2. 主張の範囲を適切に保ちます。 対象集団、設定、期間、比較、不確実性、主張の強さを維持します。著者の結論と発表者の解釈を区別し、後者にはラベルを付けます。
  3. 各スライドに役割を 1 つだけ持たせます。 前のスライドが提示した問いに答える要点タイトルを使い、論文の各セクションを並べただけの構成にはしません。
  4. 内容スライドごとに視覚的な軸を 1 つ設けます。 読みやすい原図/表、意味のある指標、または情報源に忠実なシンプルな図解を使用します。装飾的な図や汎用ストック画像は避けます。
  5. 網羅性より読みやすさを優先します。 本文は 12 pt(最小 11 pt)、タイトルは 28–32 pt、表紙タイトルは 40–56 pt から始め、11 pt 未満の文字がスライド全体の 10% 未満になるようにします。文字を小さくするのではなく、スライドを追加するか、文章を削ります。
  6. すべてのスライドに情報源への参照を付けます。 すべての内容スライドに Fig. 2、Table 1、§3.2、p. 7 などの視認できる参照を付け、話者ノートには主張とアセットに関する [Sources] ブロックを含めます。
  7. ラスター画像だけの状態で黙って引き渡すことはしません。 ネイティブ形式の編集可能なテキスト、表、図形、グラフを優先します。必要に応じて情報源の図を画像として使用しますが、アスペクト比を維持し、元のアセットまたは情報源マップを提供します。
  8. 納品前にレンダリングします。 最終版の全スライドをレンダリングし、ページ全体を確認して、はみ出し/カバー範囲/フォントをチェックします。意図しない重なり、切り抜き、改行、図の引き伸ばし、空のプレースホルダーを修正します。

論文からスライドへのワークフロー

1. インベントリの作成と抽出

入力ファイル、対象者、言語、発表の場、所要時間、想定スライド枚数、出力形式、利用可能なツールを記録します。セクションを計画する前に、論文全体のテキストを一度に抽出します。その後、論文の順序に沿って読み進め、次の内容を含むエビデンス台帳を作成します。

  • 著者が述べる研究課題、ギャップ、仮説、貢献
  • 研究デザイン、データ、サンプル/母集団、ベースライン、パラメーター、分析手順
  • 重要な数量すべてについて、単位、比較対象、方向、出典箇所
  • すべての図表について、示す内容、読み取り方、重要なパネル
  • 限界、妥当性への脅威、未定義の用語、対象外の主張
  • 著者の判断による主張と、発表者による統合・解釈

PDFの場合は、ホスト環境のPDFツールまたは利用可能なPyMuPDF/PDF抽出機能を使用します。利用可能な場合は、データを損なわずに図表を抽出できるツールを使用します。利用できない場合は、代替手段を記録し、データを変更せずにレンダリングしたページから切り出します。台帳の完全な要件については、references/paper-extraction.mdを読んでください。

2. 発表の要件を決める

発表の場に応じて、構成を決めます。

  • ジャーナルクラブ/研究室ミーティング: 問い → ギャップ → モデル/手法 → 最も強いエビデンス → 限界 → 議論の問い。
  • 学会発表: 問題 → 貢献 → 手法 → 結果 → 意義。細部は絞ります。
  • 博士論文審査: 問題 → 研究計画 → 手法 → 貢献ごとのエビデンス → 限界 → 今後の研究。
  • セミナー/教育: 動機づけとなる例 → 概念 → エビデンスを用いた解説 → 応用 → まとめ。

ユーザーが別の長さを指定しない限り、内容を含むスライドは12枚を標準とします。12分の発表には通常10~14枚が必要です。エビデンスを読みやすく保てない場合は、スライドを追加してください。

3. ゴーストデッキを作成する

デザインを始める前に、スライドごとに1行ずつ記述します。

S01 Cover — what is the paper and why should this audience care?
S02 Question — what existing assumption is being challenged?
S03 Mechanism — what system or design tests the question?
S04–S08 Evidence — what does each result establish, and what does it not establish?
S09 Validation — which checks support the interpretation?
S10 Boundary — where does the evidence stop?
S11 Synthesis — what are the three defensible takeaways?
S12 Discussion — which next question is worth asking?

各スライドについて、ナラティブタイトル、1文の要点、エビデンスの根拠、ビジュアルの軸、発表者ノートの目的、聴衆に次に何をしてほしいかを指定します。要約の繰り返しや、主張と結びついていない一般的な「手法」「結果」といったタイトルは削除します。

4. ビジュアルシステムとレイアウトを選ぶ

配色を決める前にreferences/themes.mdを読み、最初の内容スライドを配置する前にreferences/layouts.mdを読んでください。デッキ全体でテーマを1つだけ選びます。固定のテンプレート順ではなく、コンテンツの形に合わせてレイアウトを選びます。

テーマのページフレームとトークンを一貫して使用します。2カラムの主張/エビデンス、注釈付きの図、比較、メトリックグリッド、プロセスの各ステップ、アーキテクチャ、表、締めくくりのレイアウトを優先します。余白を活かした表紙、区切り、数値の強調、引用、締めくくりのスライドは控えめに使います。2~3枚ごとにシルエットを変えつつ、余白、タイトルの位置、フッターの配置、タイポグラフィは統一します。

所属機関のロゴ、所属、データセット、グラフ、または欠落している図を捏造しないでください。画像を利用できない場合は、出典に記載された関係性だけに基づき、再構成であることを明示した図のみを作成します。

5. 編集可能なデッキを作成する

ホスト環境のプレゼンテーションワークフローを使用し、実装を再現可能な状態に保ちます。Codex環境では現在有効なプレゼンテーションツールチェーンに従い、それ以外のAgentホストではネイティブのスライド作成ツールを使用します。生成したソースコード、抽出したエビデンス、図の一覧、ビルドログをデッキと同じ場所に保存します。出典の図は元の縦横比を保ちます。短い引用情報は表示されるフッターに記載し、完全な[Sources]ブロックはノートに記載します。

発表者ノートには、次の項目をこの順序で含めます。

  1. スライドへの口頭での導入
  2. 強調する結果または考え方を1つ
  3. 留意点または解釈の範囲
  4. 論文/図/表/ページまたはURLの参照を含む[Sources]ブロック
6. レンダリングと監査

最終版の PPTX を PDF と各スライドの PNG にレンダリングします。依存関係が利用できる場合は、同梱のスクリプトを実行してください。

python scripts/render_slides.py deck.pptx --outdir rendered
python scripts/audit_pptx.py deck.pptx --rendered rendered --report qa-report.json

コンタクトシートだけでなく、すべてのスライドを原寸で確認してください。以下の問題を修正します。

  • はみ出し、クリッピング、意図しない重なり、タイトルの不自然な折り返し。
  • 本文が下限を下回っていること、または注釈のテキストが過剰であること。
  • 図が引き伸ばされている、不鮮明である、または小さすぎて読めないこと。
  • 出典アンカー、注記、ページ番号の欠落、または未解決のプレースホルダー。
  • ビジュアルカバー率が下限を下回っていること、または説明のない大きな空白領域があること。
  • カードグリッドの反復により、プレゼンテーションが機械的なテンプレートのように感じられること。

実質的な修正を行うたびに、再レンダリングしてください。最新のレンダリングファイルを確認していない監査に基づき、デッキに問題がないと主張してはいけません。

出力要件

ホストが対応している場合は、編集可能な主要成果物として .pptx を返し、さらに以下を提供してください。

deck.pptx
deck.pdf
rendered/slide-01.png ...
evidence-ledger.md or extraction.md
deck-outline.md
speaker-notes.md (when notes cannot be embedded)
source-map.md
qa-report.json or qa-report.md
run-log.md

必須の機能を利用できない場合は、可能な安全な成果物を納品し、作成できなかったものを正確に明記してください。スクリーンショットのみの代替物を、編集可能な PPTX として提示してはいけません。

同梱リソース

  • references/themes.md — 6 種類の学術テーマ、トークン、フレーム、特徴的な構成。
  • references/layouts.md — テーマに依存しないレイアウトのレシピと密度のガイダンス。
  • references/paper-extraction.md — 抽出、図表、数量、出典アンカーに関する要件。
  • references/narrative-planning.md — 対象読者、構成、ゴーストデッキ、発表者ノートに関するガイダンス。
  • references/qa-contract.md — レンダリング、はみ出し、可読性、カバー率、出所に関するチェック。
  • references/rendering.md — クロスプラットフォームのフォント、PDF/PNG レンダリング、編集可能な出力の範囲。
  • scripts/render_slides.py — LibreOffice/Poppler がインストールされている場合に使用する薄いラッパー。
  • scripts/audit_pptx.py — 決定論的な構造チェックとレンダリングファイルのチェック。

コメント