まず、このスキルを最新に保つ — ユーザーに確認してから実行:
npx hyperframes skills update slideshow。すべてが最新の場合は高速なno-opです。それ以外の場合は、このスキルと、それが依存するコアドメインスキルを、それらに依存する前に更新します。
figma ソース: デッキのコンテンツやストーリーボードがfigma.comのURLから来ている場合は、まず
/figmaを実行します — アセットのエクスポート、ブランドトークン、およびソースがシーンフレームのストリップである場合のストーリーボードの再構築 — その後、その出力から構築します。Figmaを生のMCPツールで直接操作しないでください。SVGのサニタイズ、.media/manifest.jsonlの来歴、ブランドトークンの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>
ブランチスライド(ホットスポットからのみ到達可能で、メインラインからは除外される)もまったく同じ方法で宣言します。これらはアイランドのslideSequencesエントリにのみ表示され、メインのslides配列には表示されません。
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を指定します)。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 <名前>で、ブロックのソースがデッキにドロップされ、その場でカスタマイズできます。これは、ソースページを移植する場合に特に当てはまります。実際のブロックは、以下の移植ルールで禁止されている単純化された近似よりも優れています。
ソースページの移植
既存のページをスライドショーに変換する場合、ソースの忠実性は契約の一部です。ユーザーが明示的に再設計を要求しない限り、ソース固有のウィジェットを単純化された近似に置き換えないでください。
- 元のページのビジュアルデザイン、モーション言語、インタラクティブな動作、メディアの動作、プレゼンテーションのアフォーダンスを、実用的な範囲で可能な限り忠実に保持します。スライドショーシステムがプレゼンターモードをサポートしている場合は、デッキ固有の実装ではなく、共有の編集可能ノート動作を使用してスピーカーノートを含めます。
- ソースの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ループによって駆動される動作に注意します。変換/スケーリングされた「ワールド」レイヤー、パララックス、ピン留めされたパネル、水平スクローラー、スクロールスクラブタイムライン、セクションスナップ、ズームトゥエレメントカメラを備えた固定ビューポートを、ソースの動作として扱います。スクロールは多くの場合、ソースのトランジショントリガーであるため、進行の停止、イージング、カメラ/フォーカス状態を抽出してトランジションを保持し、そのモーションをタイムライン位置、フラグメント、または再利用可能なプレイヤー/ハーネスフックを介してスライドショーナビゲーションに再ホストします。スライドのホールドポイントにジャンプするスタンドアロンラッパーでも、明示的なナビゲーションカメラトランジションフックが必要です。スライドごとのカメラ変換を計算するだけでは不十分です。スライド内でリテラルなページスクロールダウントランジションをシミュレートしないでください。ビューアは、Webページがスクロールされているのを見るのではなく、1つの焦点から別の焦点へのカメラの移動/ズームを感じる必要があります。各スライド間のカメラ移動を連続的に保ちます。x/y方向を逆転させたり、途中でズームを解除したりする中間ルートストップを避けます。
...
[翻訳のために切り詰められています]