プラグインインストール: セットアップや更新コマンドの前に、このスキルがHyperFramesプラグイン内にある場合は、プラグイン実行ルール に従ってください。スタンドアロンインストールの場合は、以下の更新手順を維持します。
最初に、このスキルを最新に保つ — ユーザーに確認してから実行:
npx hyperframes skills update slideshow。すべてが最新の場合は高速なno-op(何もしない)です。そうでない場合は、このスキルと、それに依存するコアドメインスキルを、それらに依存する前に更新します。
Figmaソース: デッキのコンテンツやストーリーボードが figma.com のURLから来ている場合は、最初に
/figmaを実行してください(アセットエクスポート、ブランドトークン、およびソースがシーンフレームの連続である場合のストーリーボード再構築)。その後、その出力からビルドします。生のMCPツールを介して直接Figmaを操作しないでください。SVGサニタイゼーション、.media/manifest.jsonlの provenance、ブランドトークンのvar()バインディングがスキップされ、後でブランド変更があった場合に完全な再インポートなしでは伝播できなくなります。
スライドショー作成契約
HyperFrames スライドショーは、通常の HyperFrames コンポジション(シーン、クリップ、GSAPタイムライン)に、1つの追加要素があるものです。それは、どのシーンがスライドで、それらがどのように接続されているかを宣言する JSONアイランド です。プレイヤーの SlideshowController がアイランドを読み取り、連続したGSAPタイムラインを個別のナビゲーション可能なデッキに変換します。
最初に /hyperframes-core を読んでください(基本コンポジション契約:クリップ、トラック、data-* 属性、決定論ルール)。このスキルは、新しいこと、すなわちアイランドスキーマ、スライド作成ルール、フラグメント、分岐、バリデーション、およびラッピングコンポーネントのみをカバーします。
出力 — ナビゲーション可能なデッキ、リニアなMP4ではありません
スライドショーの出力は 実行中のデッキ です。hyperframes present <project-dir>(または Studio のプレゼントモード)で提供します。プレイヤーの SlideshowController がアイランドを読み取り、ナビゲーション、フラグメント、分岐、プレゼンターモードを駆動します。以下の「プレゼンテーションとハンドオフ」を参照してください。
スライドショーを hyperframes render で単一のMP4にしないでください。 デッキは、複数のトップレベルシーンコンポジション(スライドごとに1つの data-composition-id)として作成され、それらをラップする マスタールートコンポジションはありません。そのため、render は最初のコンポジションのみを解決し、静かに切り詰められたMP4を出力します(例:40秒のデッキに対して6秒)。リニアなメインラインエクスポート(メインスライドのみ、ブランチシーケンスは除外)は 延期されています。それがリリースされるまでは、対応出力はライブの present デッキとスライドごとの snapshot 静止画です。ユーザーが今日リニアなMP4を必要とする場合は、render を指示するのではなく、この制限を説明してください。
意図の確認
ユーザーが明示的にスライドショー、スライド表示、または HyperFrames スライドショーを要求した場合は、このスキルを進めてください。リクエストが /hyperframes 経由で届いた場合、インテント層のトリアージがこの確認を担当します。ルーティングされたということは、すでに確認済みであることを意味するため、再確認しないでください。その層の実行形状に関する質問は適用されません(成果物はレンダリングされた動画ではなくデッキです)。BRIEF.md が存在する場合、確認済みの意図が記載されているため、それを読んでください。
このスキルが「プレゼンテーション」「ピッチデッキ」「デッキ」「インタラクティブデッキ」「このページを変換」などの関連リクエストからトリガーされた場合は、作成を一時停止し、確認を求める前に選択肢を提示してください。HyperFrames スライドショーが、個別スライド、組み込みナビゲーションとプレゼンターモード、編集可能なスピーカーノート、共有メディア処理、およびハンドオフ前のバリデーションを備えた実行可能なデッキであることを簡単に説明します。ソースページ変換の場合は、元のページのビジュアルデザイン、インタラクション、モーション、メディア動作を維持しながら、ページ移動をスライド間のトランジションに変換することを目指していることも説明します。
次に、短い確認質問をします。
これを HyperFrames スライドショーとして作成しますか?
環境が提供する場合は、はい/いいえ の選択UIを使用します。それ以外の場合は、質問を平文で尋ねます。
ユーザーが「はい」と言うまでスライドショーを実装しないでください。「いいえ」と言った場合は、このスキルの使用を停止し、/hyperframes を読んでインテント層に再ルーティングさせてください。この確認は ルーティングの決定 であり、好みのゲートではありません。../hyperframes/references/brief-contract.md §1 に従い、自律モードでも存続します(「サプライズミー」でもスキップされません)。間違った成果物タイプを構築することは、品質の失敗であり、創造的な判断ではありません。
2つの要素
1. シーン — 通常の方法で宣言
すべてのスライドはシーンによってバックアップされます。data-composition-id、data-start、data-duration、data-label を使用してシーンを宣言します。
<div
data-composition-id="problem"
data-start="0"
data-duration="8"
data-label="The problem"
data-width="1920"
data-height="1080"
>
<!-- クリップをここに配置 -->
</div>
ブランチスライド(ホットスポット経由でのみ到達可能で、メインラインから除外される)もまったく同じ方法で宣言します。それらは、アイランドの slides 配列ではなく、slideSequences エントリにのみ表示されます。
2. JSONアイランド — コンポジションごとに1つのスクリプトブロック
コンポジションHTMLに、<script type="application/hyperframes-slideshow+json"> ブロックを正確に1つ追加します。これには、すべてのスライドショーメタデータが保持されます。
<script type="application/hyperframes-slideshow+json">
{
"slides": [...],
"slideSequences": [...]
}
</script>
アイランドは、スライド順序、ノート、フラグメントホールドポイント、ホットスポット、ブランチシーケンスの単一の信頼できる情報源です。<body> の上部、シーンの div の前に配置し、見つけやすいようにします。
スライドショーマニフェストを、別の <script type="application/json"> ブロックと、アイランドを作成するランタイムコードの背後に隠さないでください。present コマンドはコンポジションHTMLを静的に読み取り、実際の application/hyperframes-slideshow+json アイランドがすでに存在することを期待します。
スキーマ
SlideshowManifest(トップレベルのアイランドオブジェクト)
{
"slides": [
/* SlideRef[] — メインライン、順序通り */
],
"slideSequences": [
/* SlideSequence[] — オフラインのブランチシーケンス */
]
}
SlideRef
{
"sceneId": "problem",
"notes": "苦しみから始め、会社から始めない。",
"fragments": [3.5, 5.2, 7.0],
"hotspots": [
/* SlideHotspot[] */
],
"ttsScript": null,
"ttsAudioUrl": null,
"ttsDurationMs": null
}
| フィールド | 必須 | 備考 |
|---|---|---|
sceneId | はい | シーンの data-composition-id と完全に一致する必要があります(または startTime/endTime を明示的に指定)。lintルールは data-composition-id でシーンを解決します。 |
notes | いいえ | 発表者専用テキスト。聴衆には決して表示されません。 |
fragments | いいえ | スライドの [start, end] 範囲内の時間(秒)の配列。以下の「フラグメント」を参照。 |
hotspots | いいえ | ブランチをトリガーするインタラクティブオーバーレイ。以下の「ブランチング」を参照。 |
startTime | いいえ | 省略可能。一致したシーンの時間範囲を上書きします。デフォルトはシーンの開始/終了。 |
endTime | いいえ | 省略可能。一致したシーンの時間範囲を上書きします。デフォルトはシーンの開始/終了。 |
ttsScript、ttsAudioUrl、ttsDurationMs | いいえ | 予約済み。 スキーマフィールドは存在しますが、TTS再生はまだ配線されていません。将来のビルドのために事前入力する場合を除き、省略してください。 |
SlideHotspot
{
"id": "h1",
"label": "これはどのように計算しましたか?",
"target": "market-deep-dive",
"region": { "x": 60, "y": 10, "w": 35, "h": 20 }
}
| フィールド | 必須 | 備考 |
|---|---|---|
id | はい | スライド内で一意。 |
label | はい | 聴衆に表示されるツールチップ/ボタンテキスト。 |
target | はい | slideSequences 内の SlideSequence.id と一致する必要があります。 |
region | いいえ | スライドのパーセンテージによるバウンディングボックス: {x, y, w, h} の 0-100 の値。省略すると、ホットスポットはラベル付きの全スライドボタンとしてレンダリングされます。 |
SlideSequence
{
"id": "market-deep-dive",
"label": "市場規模の方法論",
"slides": [{ "sceneId": "mkt-1" }, { "sceneId": "mkt-2" }]
}
シーケンス内の slides は、メインラインと同じ SlideRef 形状を使用します。フラグメントとネストされたホットスポットが許可されます。
スライド作成ルール
これらはハードな制約であり、提案ではありません。これらに違反するスライドは、レビュアーが見つけた時点で完全に置き換えられます。
- 見出しはラベルではなく、完全な文の主張であること。 「SMBは手動スケジューリングに週14時間を費やしている」と書き、「スケジューリング問題」とは書かないでください。視覚要素を無視しても文が単独で成立する必要があります。
- スライドごとに1つのアイデア + 1つのビジュアル。 2つ目の箇条書きクラスターや2つ目のチャートを追加したくなったら、スライドを分割してください。
- 結論から始める。 最も強いポイントを最初に配置します — スライド上およびデッキの順序の両方で。投資家は左から右、上から下に読み、そして止まります。
- ボトムアップの市場規模のみ。 計算を示さずに「500億ドルのTAM」と書かないでください。ユニットエコノミクスから構築します:アカウント数 × ACV、または取引数 × 手数料率。
- フォントは最低30pt相当。 1920×1080では、見出しは72–96px、本文は48pxです。聴衆が読む必要のあるテキストは、40pxを下回らないでください。
- 名前付きビジュアルを手動で作成する前に、ライブカタログを検索する。 スライドに必要なすべてのルック、エフェクト、チャート、処理、トランジションについて — 「CRTスキャンライン」「グリッチ」「棒グラフレース」「きらめくスイープ」「ターミナルウィンドウ」 — スライドのクリップを作成する前に、
npx hyperframes catalog --query "<ビジュアルを平易な英語で>" --jsonを実行し、上位の結果を読んでください。検索には 何もインストールする必要はありません:プロジェクト、事前のadd、アカウントは不要です。すべてのホストされたレジストリ(約400のブロックとコンポーネント)を任意のディレクトリからランク付けします。npx hyperframes add <name>はブロックのソースをデッキにドロップし、その場でカスタマイズできます。これは、ソースページを移植する場合に特に重要です。実際のブロックは、以下の移植ルールで禁止されている単純化された近似よりも優れています。
ソースページの移植
既存のページをスライドショーに変換する場合、ソースの忠実性は契約の一部です。ユーザーが明示的に再設計を要求しない限り、ソース固有のウィジェットを簡略化された近似に置き換えないでください。
- 元のページのビジュアルデザイン、モーション言語、インタラクティブな動作、メディア動作、プレゼンテーションのアフォーダンスを、実用的な範囲でできるだけ忠実に保持してください。スライドショーシステムがプレゼンターモードをサポートしている場合は、デッキ固有の実装ではなく、共有の編集可能なノート動作を使用してスピーカーノートを含めてください。
- ソースのDOM/CSS/JSから機械的なビジュアルを、実用的な範囲で正確に移植してください。カスタムプレーヤー、キャンバスビジュアライザー、タイムライン、再生ヘッド、ステム、拡大する円、ホバー状態、その他のインタラクティブな詳細は、変換後も維持される必要があります。
- ネイティブの
<video>/<audio>要素は、カスタムメディアクローム、キャンバスビジュアライザー、波形、ビートグリッド、再生ヘッドの信頼できる情報源として扱います。ソースのメディアイベント(play、pause、timeupdate、seeking、seeked、ended、ratechange、volumechange)を配線し、media.currentTimeから視覚状態を導出します。実際の再生からドリフトする可能性のある別個のタイマーを実行しないでください。 srcを持つすべてのコピーされた<video>または<audio>は、lintの前にHyperFramesタイミング属性を持っている必要があります:data-startとdata-duration、さらに、可聴のネイティブオーディオを保持する必要がある場合はdata-has-audio="true"。スライド固有のメディアにはシーンの時間範囲を使用します。複数のフォーカスされたスライドから再生される可能性のあるユーザー制御のエビデンスビデオには、デッキ全体の範囲を使用します。メディアにpreload="none"を残さないでください。metadataまたはautoを使用してください。- バリデーションの前に、ソースのフォントトークンを解決します。カスタムソースフォントを保持する場合は、ローカル/キャプチャされたフォントファイルの
@font-faceルールを追加します。システムフォールバックを使用する場合は、font-family: var(--f-body)などのトークン化された宣言を、system-ui, sans-serifやui-monospace, monospaceなどの具体的なレンダリングセーフなスタックに置き換えます。フォントファミリー値としてvar(...)を残さないでください。 - ソースの異常なページ動作、特にスクロール、ホイール、タッチ、ハッシュ状態、リサイズ、または requestAnimationFrame ループによって駆動される動作を監査します。変換/スケーリングされた「ワールド」レイヤーを持つ固定ビューポート、パララックス、ピン留めされたパネル、水平スクローラー、スクロールスクラブされたタイムライン、セクションスナップ、ズーム・トゥ・エレメントカメラをソースの動作として扱います。スクロールはしばしばソースのトランジショントリガーであるため、その進行停止、イージング、カメラ/フォーカス状態を抽出してトランジションを保持し、そのモーションをタイムラインポジション、フラグメント、または再利用可能なプレーヤー/ハーネスフックを介してスライドショーナビゲーションに再ホストします。スライドホールドポイントにジャンプするスタンドアロンラッパーでも、明示的なナビゲーション-カメラトランジションフックが必要です。スライドごとのカメラ変換を計算するだけでは不十分です。リテラルなページスクロールダウントランジションをシミュレートしないでください。