slide-wright

slide-wright

トピックや簡単なメモを、役員会にも通用するプレゼンテーションに仕上げます。優れた戦略チームやプロダクトチームが作成したデッキのようなスライドを、どのブラウザーでも動作する自己完結型の単一 HTML ファイルとして提供します。

このスキルを定義するルール

デッキを作成する前に、見た目の方向性を提案します。最初の段階では、完成したプレゼンテーションは決して作成しません。テーマを考案し、そのテーマを使った 2 枚のプレビューを作成して、ユーザーが方向性を承認するまでそこで止めます。承認された後にのみ、残りを作成します。

提案は一度に 1 つだけ提示し、選択肢の一覧にはしません。ユーザーが却下した場合は、その方向性を破棄し、明確に異なる案を試します。各テーマはそのデッキのために考案するもので、既成のプリセット集はありません。

新しいデッキを作成する場合は、まず slide-wright/references/new-deck.md を読んでください。 ここには、ステップ 1〜4（デッキの構成、見た目の提案、承認の取得、作成）と、承認ゲートの正確な手順が記載されています。

エンジン（内部情報として扱う）

デッキの表示には、CDN から読み込む reveal.js を使用しますが、これはユーザーには決して見せない実装上の詳細です。スライド、テーマ、デザインについて説明し、ライブラリ名は生成される <link> タグと <script> タグの中にだけ記載します。正確なセットアップ手順は slide-wright/references/deck-template.md にあります。

既存のデッキを編集する場合

ユーザーが既存の HTML デッキを指定した場合は、reveal.js を使って作成されているか確認します（CDN の reveal.js の <link>／<script> タグを探します）。該当する場合は、このスキルで作成したデッキかどうかにかかわらず、最初から作り直さず、内容を読み、テーマを維持したまま、その場で変更します。見た目はすでに承認済みなので、提案と承認ゲートは省略します。編集後、node <skill-dir>/scripts/check-deck.mjs <deck.html> を実行し、出力されたすべての指摘を修正します（詳細は slide-wright/references/new-deck.md を参照してください）。

新しい展示タイプを追加する場合（slide-wright/references/exhibits.md を参照）、またはコードやアニメーションを追加する場合（slide-wright/references/code-slides.md または slide-wright/references/motion-recipes.md を参照）を除き、編集時に参照ファイルは必要ありません。

HTML 形式でも reveal.js を使っていない場合（別のエンジン、通常のスライドなど）は、このスキルの編集対象外です。別のエンジンからの強制的な作り直しはせず、その旨を伝えてください。ここに記載されたその他の内容は、新しいデッキの作成に適用されます。

ステップ 5 — 納品する

1. 完成したデッキを開きます。
2. 保存場所、テーマ名、スライド枚数を伝えます。
3. 操作方法を案内します。矢印キー、スペースキー、スワイプで移動できます。全画面表示は F、スライド一覧は Esc または O、ノート付きの発表者ビューは S です。URL に ?print-pdf を追加して印刷すると PDF として保存できます（手順は slide-wright/references/export-pdf.md を参照してください）。テーマの色は :root 変数に、フォントは <link> にあります。
4. 次にできることとして、内容の修正、テーマの変更、PDF へのエクスポート、PowerPoint ファイルへのエクスポート（slide-wright/references/export-pptx.md を参照）、または共有用の公開 URL へのデプロイを案内します。デプロイを希望する場合は、slide-wright/references/deploy.md を読み、ホスティング先（Surge、Vercel、Netlify）をユーザーに選んでもらいます。こちらで決めつけないでください。

参照ファイル

以下は、必要になった時点で参照してください。すべてを一度に読む必要はありません。

• slide-wright/references/new-deck.md — 新しいデッキを作成する手順 1〜4：デッキの内容を整理し、デザインを提案して、承認を得てから作成します
• slide-wright/references/design-aesthetics.md — デッキを洗練されたデザインに仕上げる方法（手順 2）
• slide-wright/references/theme-generation.md — テーマを考案する手順（手順 2）
• slide-wright/references/deck-template.md — HTML の骨組み、レイアウト、エンジンのセットアップ（手順 2、4）
• slide-wright/references/exhibits.md — 各コンテンツスライドのビジュアルの選び方と作り方（手順 2、4）
• slide-wright/references/code-slides.md — コードスライドとそのマークアップの仕様（手順 4）
• slide-wright/references/motion-recipes.md — ユーザーから依頼があった場合のアニメーション（手順 4）
• slide-wright/references/media.md — スライド内の画像と動画（手順 4）
• slide-wright/references/export-pdf.md — デッキを PDF として保存する方法（手順 5）
• slide-wright/references/export-pptx.md — 編集可能なテキストを含めてデッキを PowerPoint にエクスポートする方法（手順 5）
• slide-wright/references/deploy.md — デッキを公開 URL に公開する方法（手順 5）