菜单
調査/レポート md を発表スライド (Marp) に昇華する。report.md を要約・分割して slides.md を作り、HTML/PDF/PPTX に書き出す。「スライドにして」「発表資料を作って」「Marp で」で起動。文書とスライドは編集距離があるため別ファイル (slides.md) として作る。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | md-to-slide |
| description | 調査/レポート md を発表スライド (Marp) に昇華する。report.md を要約・分割して slides.md を作り、HTML/PDF/PPTX に書き出す。「スライドにして」「発表資料を作って」「Marp で」で起動。文書とスライドは編集距離があるため別ファイル (slides.md) として作る。 |
| user_invocable | true |
| argument_hint | <report-md-path> [-o <slides.md>] [--build] |
| origin | ai-research-pipeline/deep-research/readable-markdown-to-html-slide-presentation-2026 (§D/§E/§F) |
md→HTML→slide パイプラインの Stage 3。調査/レポート md (正) を発表スライドへ昇華する。 既定ツールは Marp（純 Markdown 寄り・最速配布・HTML/PDF/PPTX 出力）。
文書 md とスライド md は「編集距離」がある。銀の弾丸はない。 情報密度が違う（文書=高 / スライド=1 画面 1 論点）。そのまま変換せず、 要約 → 1 メッセージ/スライドに分割して
slides.mdを別ファイルで作るのが推奨。
report.md (正) は触らない。スライドは派生の slides.md として新規作成する。slides.md も「読みやすい md」原則に従う（Stage 1 の構造原則がそのまま効く）。slides.md → HTML/PDF/PPTX) は決定論スクリプト scripts/build-slides.sh が担う。--- でスライド分割。各スライドの先頭 ## がスライドタイトル。marp: true / theme / paginate / header を置く。<!-- ノート --> コメント（presenter UI に表示、配布 PDF では非表示）。report.md パス → Read して内容を把握。slides.md は既定で同ディレクトリの <name>.slides.md（-o で変更）。report の各セクションをスライド 1 枚に要約する。目安の構成:
| スライド | 内容 |
|---|---|
| 表紙 | タイトル + 発表者/日付（# 見出し 1 枚） |
| 結論 | Executive Summary を 3〜5 箇条書きに圧縮（最初に結論） |
| 背景/問い | なぜ・何を |
| 本論 (複数) | report の各 ## を 1〜2 枚に。表は列を絞る |
| まとめ | 結論再掲 + 次アクション |
templates/slides-marp.md を骨子に使ってよい。内容を盛らない——要約であって
新情報の追加ではない。判断に迷う圧縮はユーザーに確認する。
./scripts/build-slides.sh <slides.md> # HTML (既定・chromium 不要)
./scripts/build-slides.sh <slides.md> --pdf # PDF も (要 chromium)
./scripts/build-slides.sh <slides.md> --pptx # PPTX も (要 chromium)
./scripts/build-slides.sh <slides.md> --all # HTML+PDF+PPTX
marp-cli を npx で実行する。PDF/PPTX は内部でブラウザ (chromium) を使うため、 未導入環境では HTML のみ成功する（スクリプトがその旨を報告する）。
md-to-slide で発表資料を作成しました:
正: report.md
派生: report.slides.md (要約・分割)
ビルド: dist/report.slides.html (+ --pdf/--pptx で PDF/PPTX)
| やりたいこと | 推奨 |
|---|---|
| CI で slide+PDF を自動生成・最速配布 | Marp (既定) |
| リッチ/インタラクティブ発表 (live code) | Slidev |
| 自由度最大・既存 HTML 資産活用 | reveal.js |
| 文書もスライドも 1 ツールで | Pandoc / Quarto |
本バンドルは Marp を実装。他ツールが要る場合は slides.md をそのまま
pandoc -t revealjs 等に渡せる（md 構造が素直なら流用しやすい）。
slides.md から両方出る（build-slides.sh --all）。slides.md 側で作る。readable-markdown-to-html-slide-presentation-2026
の §D（スライド実践）/§E（ツール比較）/§F（昇華ワークフロー）を実装。Markdown を共通テーマの HTML（画面ダーク / 印刷は A4 ライトテーマ）に変換する。「HTML 化して」「HTML 版を作って」「PDF にしたい」で起動。調査/設計/レポート md の配布・印刷用途に。素早く出すなら scripts/render-html.sh、リッチな card/box レイアウトが要るときは LLM 整形。
Markdown を「人が読みやすく、かつ機械が HTML/スライドへ変換しやすい」構造に執筆・整形する。新規に調査/設計 md を書くときや、既存 md を昇華 (md→HTML→slide) の前に整えるときに使う。「読みやすい md にして」「昇華しやすく整形して」「調査 md を書いて」で起動。
生成した HTML / スライドが「見た目 human friendly」か、ノンデザイナーズ・デザインブックの C.R.A.P. (Contrast/Repetition/Alignment/Proximity) + タイポグラフィで品質レビューする。「デザインを見て」「読みやすい見た目か」「レイアウトをレビュー」で起動。機械監査 (design-audit.sh) を先に走らせ、静的に測れない整列・近接・視覚的印象を補う。
[2] design を実装単位に分解し、複数の [3] impl issue を起票する ([2]→[3] のブレイクダウン)。[2] を review + needs-human に遷移する。
[1] request を入力に [2] design issue を起票する ([1]→[2] のブレイクダウン)。元の [1] は close する。
status:ready の issue を claim する。遷移直前に ready を再確認してから in-progress へ atomic 遷移し、二重取得のレース窓を最小化する。issue を処理開始する直前に必ず使う。