フロントエンドスライド
依存関係ゼロでアニメーション豊かなHTMLプレゼンテーションを作成し、ブラウザ上で完全に動作させます。
zarazhangrui氏の作品(クレジット: @zarazhangrui)で紹介された視覚的探索アプローチに触発されています。
アクティベートするタイミング
- トークデッキ、ピッチデッキ、ワークショップデッキ、社内プレゼンテーションを作成する場合
.pptまたは.pptxスライドをHTMLプレゼンテーションに変換する場合- 既存のHTMLプレゼンテーションのレイアウト、モーション、タイポグラフィを改善する場合
- デザインの好みがまだわからないユーザーとプレゼンテーションスタイルを探索する場合
絶対条件
- ゼロ依存: デフォルトでは、インラインCSSとJSを含む自己完結型の単一HTMLファイルとします。
- ビューポートフィットは必須: すべてのスライドは内部スクロールなしで1つのビューポート内に収まらなければなりません。
- 見せる、語らない: 抽象的なスタイルアンケートではなく、視覚的なプレビューを使用します。
- 特徴的なデザイン: 一般的な紫のグラデーション、Inter on white、テンプレート風のデッキは避けてください。
- プロダクション品質: コードはコメント付き、アクセシブル、レスポンシブ、パフォーマンスが高い状態に保ちます。
生成する前に、STYLE_PRESETS.md を読んで、ビューポートセーフなCSSベース、密度制限、プリセットカタログ、CSSの落とし穴を確認してください。
ワークフロー
1. モードの検出
以下のいずれかのパスを選択します:
- 新規プレゼンテーション: ユーザーにトピック、メモ、または完全なドラフトがある場合
- PPT変換: ユーザーが
.pptまたは.pptxを持っている場合 - 強化: ユーザーが既にHTMLスライドを持っており、改善を希望する場合
2. コンテンツの発見
必要最小限のことだけを尋ねます:
- 目的: ピッチ、教育、カンファレンストーク、社内アップデート
- 長さ: 短い(5-10)、中程度(10-20)、長い(20+)
- コンテンツの状態: 完成したコピー、大まかなメモ、トピックのみ
ユーザーがコンテンツを持っている場合は、スタイリングの前にそれを貼り付けるよう依頼します。
3. スタイルの発見
デフォルトでは視覚的探索とします。
ユーザーが希望するプリセットを既に知っている場合は、プレビューをスキップして直接使用します。
それ以外の場合:
- デッキがどのような印象を与えるべきかを尋ねます: 印象的、活気づける、集中させる、インスピレーションを与える。
.ecc-design/slide-previews/に 3つの単一スライドプレビューファイル を生成します。- 各プレビューは自己完結型で、タイポグラフィ/色/モーションを明確に示し、スライドコンテンツは約100行以内に収めます。
- どのプレビューを残すか、またはどの要素を混ぜるかをユーザーに尋ねます。
STYLE_PRESETS.md のプリセットガイドを使用して、ムードをスタイルにマッピングします。
4. プレゼンテーションの構築
以下のいずれかを出力します:
presentation.html[presentation-name].html
デッキに抽出された画像やユーザー提供の画像が含まれる場合のみ、assets/ フォルダを使用します。
必要な構造:
- セマンティックなスライドセクション
STYLE_PRESETS.mdからのビューポートセーフなCSSベース- テーマ値のためのCSSカスタムプロパティ
- キーボード、ホイール、タッチナビゲーションのためのプレゼンテーションコントローラークラス
- リビールアニメーションのためのIntersection Observer
- reduced-motion対応
5. ビューポートフィットの強制
これを厳格なゲートとして扱います。
ルール:
- すべての
.slideはheight: 100vh; height: 100dvh; overflow: hidden;を使用しなければなりません - すべてのタイプとスペーシングは
clamp()でスケーリングされなければなりません - コンテンツが収まらない場合は、複数のスライドに分割します
- オーバーフローを読みやすいサイズ以下に縮小して解決しないでください
- スライド内にスクロールバーを許可しないでください
STYLE_PRESETS.md の密度制限と必須CSSブロックを使用します。
6. 検証
完成したデッキを以下のサイズで確認します:
- 1920x1080
- 1280x720
- 768x1024
- 375x667
- 667x375
ブラウザ自動化が利用可能な場合は、それを使用してスライドのオーバーフローがないこと、キーボードナビゲーションが機能することを確認します。
7. 引き渡し
引き渡し時:
- ユーザーが保持を希望しない限り、一時的なプレビューファイルを削除します
- 有用な場合は、プラットフォームに適したオープナーでデッキを開きます
- ファイルパス、使用したプリセット、スライド数、簡単なテーマカスタマイズポイントを要約します
現在のOSに適したオープナーを使用します:
- macOS:
open file.html - Linux:
xdg-open file.html - Windows:
start "" file.html
PPT / PPTX変換
PowerPoint変換の場合:
- テキスト、画像、ノートを抽出するには、
python3とpython-pptxを優先します。 python-pptxが利用できない場合は、インストールするか、手動/エクスポートベースのワークフローにフォールバックするかを尋ねます。- スライドの順序、スピーカーノート、抽出されたアセットを保持します。
- 抽出後、新規プレゼンテーションと同じスタイル選択ワークフローを実行します。
変換はクロスプラットフォームに保ちます。Pythonで解決できる場合、macOS専用ツールに依存しないでください。
実装要件
HTML / CSS
- ユーザーが明示的にマルチファイルプロジェクトを希望しない限り、インラインCSSとJSを使用します。
- フォントはGoogle FontsまたはFontshareから取得できます。
- 雰囲気のある背景、強いタイプ階層、明確なビジュアルディレクションを優先します。
- イラストではなく、抽象的な形状、グラデーション、グリッド、ノイズ、幾何学を使用します。
JavaScript
以下を含めます:
- キーボードナビゲーション
- タッチ/スワイプナビゲーション
- マウスホイールナビゲーション
- 進捗インジケーターまたはスライドインデックス
- 表示時アニメーショントリガー
アクセシビリティ
- セマンティック構造を使用します(
main,section,nav) - コントラストは読みやすい状態を保ちます
- キーボードのみのナビゲーションをサポートします
prefers-reduced-motionを尊重します
コンテンツ密度制限
ユーザーが明示的に密度の高いスライドを要求し、読みやすさが保たれる場合を除き、以下の最大値を使用します:
| スライドタイプ | 制限 |
|---|---|
| タイトル | 1見出し + 1サブタイトル + オプションのタグライン |
| コンテンツ | 1見出し + 4〜6箇条書き または 2つの短い段落 |
| フィーチャーグリッド | 最大6カード |
| コード | 最大8〜10行 |
| 引用 | 1引用 + 帰属 |
| 画像 | ビューポートに制約された1画像 |
アンチパターン
- 視覚的アイデンティティのない一般的なスタートアップグラデーション
- 意図的に編集的な場合を除くシステムフォントデッキ
- 長い箇条書きの壁
- スクロールが必要なコードブロック
- 短い画面で壊れる固定高さのコンテンツボックス
-clamp(...)のような無効な否定CSS関数
関連ECCスキル
frontend-patterns: デッキを中心としたコンポーネントとインタラクションパターンliquid-glass-design: プレゼンテーションが意図的にAppleのガラス美学を借用する場合e2e-testing: 最終デッキの自動ブラウザ検証が必要な場合
成果物チェックリスト
- プレゼンテーションがローカルファイルからブラウザで動作する
- すべてのスライドがスクロールなしでビューポートに収まる
- スタイルが特徴的で意図的である
- アニメーションが意味があり、ノイズになっていない
- reduced motionが尊重されている
- ファイルパスとカスタマイズポイントが引き渡し時に説明されている