sci-html

Sci HTML

このスキルを使用すると、Aut_Sci_Write スイート内でブラウザー上で表示する学術スライドデッキを作成できます。用意された Markdown／JSON から作成することも、PDF から構造化された知見や抽出した図を経て HTML デッキを作成する、論文の全ワークフローを実行することもできます。

共有可能なブラウザー出力には sci-html を使用してください。ユーザーが実際の .pptx を必要としている場合は sci-ppt を使用してください。ユーザーがプレゼンテーション成果物を必要とせず、テキスト分析のみを希望している場合は sci-extract を使用してください。

使用する場面

ユーザーが HTML スライド、クリック操作可能なプレゼンテーション用ウェブページ、ブラウザー上で表示する学術プレゼンテーション、Markdown からスライドデッキへの変換、論文の要約からウェブプレゼンテーションへの変換、PDF 論文から HTML レポートへの変換、または左右のナビゲーション機能を備えた PPT 風の HTML ファイルを求めている場合に、このスキルを使用してください。

出力

必ず、index.html、deck.json、assets/style.css、assets/deck.js、および assets/figures/ 内のローカル図のコピーを含むデッキディレクトリを作成してください。

単一ファイルの HTML は作成しないでください。ディレクトリへの出力が標準モードです。プレゼンテーションの保守性を保ち、埋め込みアセットによるファイルの肥大化を避けられます。

ワークフロー

1. ユーザーのソースコンテンツをデッキモデルに変換します。
2. 必要に応じて、表紙、目次、セクション、まとめ、終了スライドを追加します。
3. 画像パスとスライド構造を検証します。
4. HTML、CSS、JS をレンダリングします。
5. 出力パスとナビゲーション操作をユーザーに伝えます。

PDF 論文のワークフロー

ソースが PDF の場合は、個別の sci-extract スキルや sci-figure スキルを別途要求せず、統合された paper コマンドを使用してください。

python scripts/generate_html_deck.py paper paper.pdf -o out/paper-report --author "Presenter"

Aut_Sci_Write リポジトリのルートから作業する場合は、次を実行してください。

python skills/sci-html/scripts/generate_html_deck.py paper paper.pdf -o skills/sci-html/out/paper-report --author "Presenter"

これにより、structured_insights.json、figure_manifest.json、figures/ 内の抽出ファイル、生成された {paper-stem}-deck.md、および最終的な index.html が出力されます。

PDF ワークフローでは、sci-extract と sci-figure からコピーされた統合機能を使用します。PyMuPDF、pdfplumber、numpy、opencv-python、Pillow、pytesseract が必要です。Tesseract OCR は任意であり、小図の OCR にのみ影響します。

統合された sci-extract ロジックは、原著論文とレビュー論文を判別します。原著論文のデッキでは、問題、手法、結果、新規性、応用、限界を重視します。レビュー、サーベイ、システマティックレビュー、スコーピングレビュー、メタ分析のデッキでは、対象範囲、分類体系、エビデンスベース、合意点、論争点、エビデンスの質、研究ギャップ、今後の方向性、重要な図や表を重視します。自動判定を上書きする場合は、ユーザーの希望に応じて --paper-type auto|research|review を使用してください。

プレゼンテーションのマークアップ

• Markdown のスライドブロックの先頭に layout: section を置くと、章の区切りスライドを作成できます。
• layout: section の下に subtitle: 01 を置くと、章番号が表示されます。
• 赤字で強調するには、**key phrase** または ==key phrase== を使用します。
• 箇条書きは簡潔にしてください。生成される箇条書きスライドでは、デフォルトで番号付きのキーポイントカードが使用されます。
• スライドの内容が箇条書き 1～2 項目のみの場合は、項目番号を表示せず、通常の文としてレンダリングします。
• 長いスライドタイトルと論文タイトルは、見出しを縮小して行幅を広げることで、自動的にページ内に収まるよう調整されます。
• 余白の多いスライドには、タイトルや箇条書きのキーワードをもとに、控えめなトピックモチーフが自動的に追加されます。追加の画像アセットを用意する必要はありません。

ナビゲーション操作

生成されたデッキでは、マウスクリック、左側 3 分の 1 のクリックによる前のスライドへの移動、明示的な Prev／Next ボタン、左右の矢印キー、スペースキー、Home／End、F キーによる全画面表示、#/3 のような URL ハッシュ状態に対応しています。

デザインルール

スライドは学術的で読みやすく、プレゼンテーションに適したものにしてください。長い段落は避けてください。図、簡潔な番号付きポイント、セクションの区切り、明確な階層構造を優先してください。余白を減らすために、装飾的でありながら目立ちすぎない視覚パターンを使用してください。セクションスライドと終了スライドは中央揃えにしてください。デフォルトでは、ユーザー提供の HTML をエスケープしてください。生成するデッキに API キーや .env の値を書き込まないでください。

Aut_Sci_Write 連携

• sci-html は、sci-ppt と並ぶ本スイートの出力スキルの 1 つです。
• 論文のワークフローでは、Aut_Sci_Write の抽出および図の処理ロジックをローカルで再利用するため、デッキの生成前にユーザーが sci-extract と sci-figure を手動で連続実行する必要はありません。
• 生成されたデッキは out/ またはユーザーが選択した別の出力フォルダーに保存してください。これらの出力は、リポジトリおよびパッケージのルールで意図的に無視されます。
• このスキル用のローカルな .env ファイルを作成したり、必要としたりしないでください。ユーザーが任意の依存関係をインストールした場合を除き、このスキルはオフラインで動作します。