プラグインのインストール: セットアップまたはフレッシュネスコマンドを実行する前に、このスキルが HyperFrames プラグイン内にある場合は、プラグイン実行ルール に従ってください。スタンドアロンでインストールする場合は、以下の更新手順を維持します。
最初に、このスキルを最新の状態に保つ — ユーザーに確認してから実行:
npx hyperframes skills update slideshow。すべてが最新の場合は高速にスキップされます。そうでない場合は、このスキルと、それに依存するコアドメインスキルを、それらに依存する前に更新します。
figma ソース: デッキのコンテンツやストーリーボードが figma.com の URL から来ている場合は、最初に
/figmaを実行してください — アセットのエクスポート、ブランドトークン、ストーリーボードの再構築(ソースがシーンフレームのストリップの場合)を行い、その出力からビルドします。Figma を生の MCP ツールで直接操作しないでください。SVG サニタイゼーション、.media/manifest.jsonlの来歴、ブランドトークンのvar()バインディングをスキップするため、後でブランドが変更された場合に完全な再インポートなしでは伝播できません。
スライドショー作成契約
HyperFrames スライドショーは、通常の HyperFrames コンポジション(シーン、クリップ、GSAP タイムライン)に、1つの追加要素である JSON アイランド を加えたものです。この 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>
アイランドは、スライドの順序、ノート、フラグメントの保持ポイント、ホットスポット、ブランチシーケンスに関する唯一の信頼できる情報源です。シーンの <div> の前に、<body> の上部近くに配置して、見つけやすくします。
スライドショーマニフェストを代替の <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 を指定)。リントルールは 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つのアイデアと1つのビジュアル。 2つ目の箇条書きや2つ目のチャートを追加したくなったら、スライドを分割してください。
- 結論を最初に述べる。 最も強いポイントを最初に — スライド上とデッキの順序の両方で。投資家は左から右、上から下に読み、そして読み終えます。
- ボトムアップの市場規模推計のみ。 計算を示さずに「500億ドルのTAM」と書かないでください。ユニットエコノミクスから構築します:アカウント数×ACV、またはトランザクション数×手数料率。
- フォントは最低30pt相当。 1920×1080では、見出しは72–96px、本文は48pxです。観客が読まなければならないテキストには、40px未満を使用しないでください。
- 名前付きビジュアルを手動で構築する前に、ライブカタログを検索する。 スライドに必要なすべてのルック、エフェクト、チャート、処理、トランジション(「CRTスキャンライン」「グリッチ」「棒グラフレース」「きらめくスイープ」「ターミナルウィンドウ」など)について、スライドのクリップを作成する前に
npx hyperframes catalog --query "<そのビジュアルを平易な英語で>" --jsonを実行し、上位の結果を読んでください。検索には 何もインストールする必要はありません:プロジェクトも、事前のaddも、アカウントも不要です。ホストされているレジストリ全体(約400のブロックとコンポーネント)を任意のディレクトリからランク付けします。npx hyperframes add <名前>でブロックのソースがデッキに取り込まれ、その場でカスタマイズできます。これはソースページを移植する場合に特に重要です:実際のブロックは、以下の移植ルールで禁止されている簡略化された近似よりも優れています。
ソースページの移植
既存のページをスライドショーに変換する場合、ソースの忠実度は契約の一部です。ユーザーが明示的に再デザインを要求しない限り、ソース固有のウィジェットを簡略化された近似に置き換えないでください。
- 元のページのビジュアルデザイン、モーション言語、インタラクティブ動作、メディア動作、プレゼンテーション機能を可能な限り忠実に維持します。スライドショーシステムがプレゼンターモードをサポートしている場合は、デッキ固有の実装ではなく、共有の編集可能なノート動作を使用してスピーカーノートを含めます。
- ソースのDOM/CSS/JSからの機械的なビジュアルを可能な限り正確に移植します:カスタムプレイヤー、キャンバスビジュアライザー、タイムライン、プレイヘッド、ステム、拡大する円、ホバー状態、その他のインタラクティブな詳細は変換後も維持される必要があります。
- ネイティブの
<video>/<audio>要素は、カスタムメディアクローム、キャンバスビジュアライザー、ウェーブフォーム、ビートグリッド、プレイヘッドの信頼できる情報源として扱います。ソースのメディアイベント(play、pause、timeupdate、seeking、seeked、ended、ratechange、volumechange)を配線し、media.currentTimeからビジュアル状態を導出します。実際の再生からずれる可能性のある別のタイマーを実行しないでください。 - コピーされた
<video>またはsrcを持つ<audio>はすべて、リントの前に 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 ループによって駆動される動作を監査します。変換/スケーリングされた「ワールド」レイヤー、パララックス、ピン留めされたパネル、水平スクローラー、スクロールスクラブされたタイムライン、セクションスナップ、ズーム-to-要素カメラを備えた固定ビューポートをソース動作として扱います。多くの場合、スクロールがソースのトランジショントリガーであるため、その進行停止、イージング、カメラ/フォーカス状態を抽出し、そのモーションをタイムラインポジション、フラグメント、または再利用可能なプレイヤー/ハーネスフックを介してスライドショーナビゲーションに再ホストすることで、トランジションを保存します。スライドの保持ポイントにジャンプするスタンドアロンラッパーには、明示的なナビゲーション-カメラトランジションフックが必要です。スライドごとのカメラ変換を計算するだけでは不十分です。リテラルなページ下スクロールトランジションをシミュレートしないでください。
[翻訳の都合で一部省略されました]