paper-deck

Paper Deck — ビジュアルスライドディレクター

論文や知識コンテンツを、本当にデザインされたように見えるスライドに仕上げます。

基本方針は、PPT のオブジェクトを使って無理にレイアウトを組むのではなく、次のとおりです。

1. まず内容を理解し、デッキの概要と各ページのストーリーを作成します。
2. 各ページについて、「観客に何を見て、何を感じ、何を覚えてもらうか」を明確にします。
3. 画像生成モデルを使って、16:9 のスライド画像を生成します。
4. PPTX/PDF に合成し、修正可能なソースファイルとしてプロンプトを保持します。

必須の画像生成要件

Paper Deck の V1 は、ラスター画像を最優先する AIGC スライド画像のワークフローです。ユーザーが「画像生成はしない」「コードで描く」「編集可能な PPT のみ」「HTML/SVG/Canvas を使って生成」と明示的に要求しない限り、各ページの画像を生成するために、実際のラスター画像生成バックエンドを必ず呼び出してください。

次の成果物を、本スキルの「画像生成ページ」と偽って提供することを固く禁じます。

• Python/Pillow、SVG、HTML/CSS、Canvas、Mermaid、matplotlib、PPT の図形、その他のローカル描画コードで直接描いたページ全体の画像
• テンプレート、単純なレイアウトスクリプト、スクリーンショット、プレースホルダー画像、手作業で組み合わせた要素で、画像生成バックエンドの出力を置き換えたもの
• まずローカルでページ全体を描き、わずかなフィルター処理や後処理だけを行って AIGC スライド画像として扱うこと

許可されるローカル処理は次のとおりです。

• 画像生成バックエンドの出力ファイルの移動、コピー、名前変更
• 必要な形式変換、圧縮、サイズ検証、PPTX/PDF への合成
• ユーザーが混合方式を明示的に選択した場合に、画像生成した背景の上へ少量の編集可能な文字レイヤーを重ねること。この場合、deck-brief.md と納品説明に「混合文字レイヤー」と明記し、ページ内の文字すべてを画像生成モデルが作成したと主張してはなりません。

現在の環境で利用可能なラスター画像生成バックエンドがない場合は、処理を停止し、画像生成バックエンドがないことを説明してください。代替としてローカル描画に切り替えてはなりません。

使用する場面

適しています。

• 論文の研究会、答弁、reading group、技術共有
• 「テンプレート PPT に見えない」ビジュアル報告が必要な場合
• 各ページが高品質な画像であることを許容し、全体的な見栄えや伝わりやすさを優先したい場合
• ページ単位で修正したい場合：第 N ページの作り直し、スタイルの変更、リアリティの追加、AI らしさの低減

適していません。

• PowerPoint で複数人が各テキストボックスを細かく編集する必要がある場合
• 表、財務報告書、コンプライアンス資料が大量にある場合
• 既存の企業用 PPT マスターを正確に再現する必要がある場合

完全に編集可能な PPT が必要な場合は、本スキルの V1 がラスター画像を優先する方式であることを説明してください。通常の PPTX ツールを使うか、「画像背景＋編集可能な文字レイヤー」の混合方式を生成できます。

ワークフロー

Step 1: 入力の分析

次の入力を受け付けます。

• arXiv / DOI / ウェブページのリンク
• PDF のパス
• Markdown / テキスト / 記事
• 既存のアウトライン
• 参考画像または参考 PPT のスクリーンショット

論文の場合は、paper-analyzer の読み方を優先して再利用します。要約、手法、実験、図表、結論を読み、必要に応じてコードリポジトリを検索します。長文を書くことではなく、スライドに適した中心的なストーリーを抽出することが目的です。

analysis.md を出力して保存します。

• テーマ、対象読者、発表の場面
• 論文／コンテンツの主張を 1 文で表したもの
• 明確に伝える必要がある 3～5 個の要点
• 推奨ページ数、推奨スタイル、言語
• 生成が必要な画像の種類：表紙、メカニズム図、フロー図、データページ、結論ページなど
• そのまま使用できる実際の素材：論文の Figure/Table、PDF のスクリーンショット、ユーザー提供のスクリーンショット、コードのスクリーンショット、実験曲線

Step 2: 生成前の確認

デフォルトでは必ず確認し、画像をすぐに生成してはなりません。ただし、ユーザーが「すぐに生成／確認不要／デフォルトどおり」と明示した場合を除きます。

質問は 3 つ以内にします。

1. ページ数と用途：研究会／答弁／公開発表／商用プレゼンのどれで、何ページ必要ですか？
2. スタイル：references/style-system.md を参照してください。
3. 実際の素材を挿入しますか？PDF／論文の図表からスクリーンショットを取得すること、またはユーザー提供のスクリーンショット／画像を使うことを許可しますか？許可される場合は、どのページでどの実素材を使う予定かを説明します。

推奨する質問文：

我建议做 12 页，风格用 journal-minimal：像 Nature/IEEE 论文图 + 正式学术汇报，清晰、克制、不花哨。
也可以换成 business-research 做商业研究分享，warm-notes 做手记风，或 liquid-glass 做 Apple 式玻璃质感。
这篇论文我建议在第 4 页插入原论文方法图局部截图，第 8 页插入实验曲线/表格截图，再基于这些真实素材做设计化排版。
确认后我会先生成 outline.md 和每页 prompt，再逐页出图并合成 PPTX/PDF。

Step 3: Deck Brief

deck-brief.md を保存します。次の項目を必ず含めてください。

• style_preset
• audience
• slide_count
• language
• visual_rules
• do_not_use
• reference_images（存在する場合）
• source_visual_plan：実際の図表／スクリーンショットを使用するページ、出典、処理方法

必要に応じて、スタイルの詳細は references/style-system.md を参照してください。 実素材の方針は、必要に応じて references/source-visuals.md を参照してください。

Step 4: Outline

outline.md を保存します。各ページには、次の固定形式を使用します。

## 01. Slide Title
- Role: cover / context / method / mechanism / evidence / result / takeaway
- Message: 这一页唯一要讲清楚的观点
- Visual: 画面主视觉和构图
- Text: 页面上允许出现的短文字
- Evidence: 引用的论文图表/公式/实验数据/代码位置
- Source visual: 是否使用真实截图/论文图表；来源、裁剪范围和落位
- Repair handle: 后续返修时可引用的定位描述

ルール：

• 各ページには、中心となる主張を 1 つだけ載せます。
• ページ上の文字はできるだけ少なくし、複雑な説明はスピーカースクリプトやノートに記載します。
• メカニズムを説明するページでは、抽象的なひらめきではなく、「入力 → 処理 → 出力」を優先して図示します。
• データページには、最も説得力のある数値を 1～3 個だけ載せます。
• 実際の論文の図やスクリーンショットは、根拠なく生成したものより信頼性が高いのが一般的です。実素材を使える場合は、優先して配置を計画します。
• 余白を空けすぎないでください。表紙や章の区切りページを除き、主となるビジュアル、図表、または証拠を示す領域が、通常は画面の 60～80％を占めるようにします。
• 8 ページ以上の場合は、表紙、問題、手法、メカニズム、根拠、結論に変化をつけ、展開にリズムを持たせます。

Step 5: Prompt Files

各ページについて、画像生成ツールを呼び出す前に、必ずプロンプトファイルを作成します。

パス：

paper-deck/{topic-slug}/
├── analysis.md
├── deck-brief.md
├── outline.md
├── prompts/
│   ├── 01-slide-cover.md
│   ├── 02-slide-context.md
│   └── ...
├── images/
│   ├── 01-slide-cover.png
│   ├── 02-slide-context.png
│   └── ...
├── {topic-slug}.pptx
└── {topic-slug}.pdf

プロンプトの書き方は references/prompt-template.md を参照してください。

必須ルール：

• プロンプトで 16:9 を明示します。
• スタイル、構図、文字の言語、文字数の制限を明確に記載します。
• モデルにページ番号、ロゴ、透かし、PPT の外枠を生成させないでください。
• 正確な文字が必要な場合は、画像内の文字をできるだけ減らします。後から混合文字レイヤーを追加できます。
• このページで実素材を使う場合は、素材を画面の一部としてどのように配置するかをプロンプトに記載します。埋め込み、トリミング、ガラス風パネルへの配置、注釈、拡大枠などを指定し、事実をモデルに一から描き直させないでください。

Step 6: 画像の生成

画像生成バックエンドの選択：

1. Codex 環境では、組み込みの imagegen を優先して使います。
2. ユーザーが baoyu-imagine、Gemini、OpenAI、Seedream などのバックエンドを指定した場合は、指定どおりにします。
3. 利用可能な画像生成バックエンドがない場合は処理を停止し、ラスター画像生成バックエンドが必要であることをユーザーに伝えます。

画像生成の必須条件：

• 画像生成ツールを呼び出す前に、対象ページの prompts/NN-*.md を必ず作成しておきます。
• 最終的に images/ に配置する各ページのメイン画像は、実際のラスター画像生成バックエンドから取得しなければなりません。
• Python/Pillow、SVG、HTML/CSS、Canvas、Mermaid、matplotlib、PPT の図形、ローカル描画スクリプトを使ってページ全体のメイン画像を生成し、画像生成の代わりにすることは禁止です。
• 中国語の文字の誤りを懸念して画像生成バックエンドを使わず、ローカル描画でページ全体を作ることは禁止です。正しい対応は、画像内の文字を減らす、プロンプトを修正して再生成する、またはユーザーの同意を得て「画像生成した背景＋編集可能な文字レイヤー」の混合方式を使うことです。
• 混合文字レイヤーを使う場合も、images/ に各ページの画像生成背景または画像生成したページ全体の画像を残し、後から追加した文字を deck-brief.md に記録します。
• 生成後は、各ページで使ったバックエンド、プロンプトファイル、出力ファイル、生成時刻を generation-log.md に記録します。生成記録のない画像を最終納品ページに使ってはなりません。

生成方針：

• まず第 1 ページを生成し、スタイルの基準とします。
• 後続ページでバックエンドが参照画像に対応している場合は、第 1 ページをスタイルの参考として使用し、スタイルのずれを抑えます。
• 3～4 ページごとにサムネイルを確認し、スタイルのずれがあればプロンプトを修正してから続けます。
• 生成に失敗したページは保存し、成功したページを上書きしないでください。

Step 7: PPTX/PDF への合成

画像を生成した後、次を実行します。

python3 <SKILL_ROOT>/scripts/merge_deck.py paper-deck/{topic-slug}

スクリプトは images/NN-*.png|jpg|webp を読み込み、同じ名前の .pptx と .pdf を出力します。各画像は 16:9 の 1 ページ全体に配置されます。

Step 8: 品質チェック

納品前に references/quality-gate.md に従って確認します。

• 一目で本物のデザイン作品に見えるか。テンプレートを寄せ集めたように見えないか
• 各ページに主張が 1 つだけあるか
• 意味のない余白が多すぎないか。重要な内容が画面の十分な部分を占めているか
• 実素材を使ったページについて、出典、ページ番号／図番号、配置が明確に記録されているか
• スタイルに一貫性があるか
• 画像内の文字が読みやすく、誤字や文字化けがないか
• AI によくある問題がないか：偽の UI、偽のロゴ、文字化けしたラベル、過剰なサイバーパンク表現、プラスチックのような 3D、意味のない装飾
• generation-log.md が存在し、すべてのページについて、実際のラスター画像生成バックエンド、プロンプトファイル、出力ファイルが記録されているか
• ローカル描画／テンプレート／スクリーンショットを画像生成ページとして偽っていないか。該当する場合は作り直すか、ユーザーが確認した Paper Deck 以外の方法に明確に切り替える必要があります
• PPTX/PDF を開けるか。ページ数は正しいか

Step 9: 返修

返修时永远先改源文件：

用户说	操作
“第 5 页更学术一点”	改 prompts/05-*.md，保留旧图，生成新图
“统一成第 1 页的质感”	把第 1 页风格锚点追加到相关 prompts
“第 7 页文字太多”	修改 outline 的 Text，再改 prompt
“只重做背景，不动内容”	在 prompt 中保留 Message/Text，重写 Visual
“新增一页机制细节”	更新 outline，新增 prompt，生成图片，重跑合成脚本

不要用程序在生成图上涂改文字。文字错了就改 prompt 重生成，或切换到混合文字层方案。

参考文件

• references/style-system.md：风格预设和选择规则
• references/layouts.md：常用页面角色与构图
• references/source-visuals.md：PDF 截图、论文图表、用户图片的使用策略
• references/prompt-template.md：逐页生图 prompt 模板
• references/quality-gate.md：交付前检查和返修标准