hyperframes-studio

プラグインのインストール： このスキルが HyperFrames プラグイン内にある場合、セットアップや最新状態の確認コマンドを実行する前に、プラグインの実行ルールに従ってください。スタンドアロンでインストールした場合は、以下の更新手順に従ってください。

HyperFrames Studio の規約

Studio では、トップレベル要素ごとにタイムラインの行が1つ表示されます。 以下のルールに従ったプロジェクトは、短く読みやすいタイムラインとして開きます。従わないプロジェクトは、ユーザーが編集できない、ラベルのない行が並ぶ画面として開きます。以下は、何を作るかについての規約です。 クリップの変更方法については、/hyperframes-core の references/creator-editing-recipes.md に従い、同じ編集を別の形式で行わないでください。

0. 作る前に話す

ファイルを開く前に、メッセージを読んでください。何を求めているかを判断します。

相手	あなた
変更を具体的に頼んでいる（どれだけ丁寧な言い方でも、「タイトルを大きくして」「3番目のシーンをカットしてくれる？」など）	実行します。
完成した映像について感覚的な感想を述べている（「イントロの動きがぎこちない」「尺が足りない」など）	原因を見つけ、測定できる要素を変更し、その感想の意味と何を変更したかを伝え、STORYBOARD.md に記録します。
変更を頼まずに質問している（「タイトルが跳ねるのはなぜ？」など）	質問に答えます。何も変更しません。
何も変更しないで、保留にして、「考えているだけ」「話し合おう」と言っている	気づいた修正であっても、ファイルは変更しません。文章で提案します。
具体的な変更を指定せず、この映像のアイデアを出している（「エンディングをもっと盛り上げたい」など）	変更を提案し、計画（以下）に追加します。コンポジションのファイルは変更しません。
新しい映像を依頼している	計画を立てます（§ 5）。
計画を承認している（「作って」「進めて」など）	承認された内容を作ります。

質問をしながら変更も指定しているメッセージには、質問への回答と変更の両方を行います。何かを求めているか判断できない場合に限り、会話として対応します。誤った回答なら1回のメッセージで済みますが、誤った制作では長い作業と修正のやり取りが必要になります。

会話での返信：

• まず、平易な言葉で数文以内に答えます。
• 映像に影響する質問だけをし、それぞれに推奨案とそのトレードオフを添えます（「30秒ならフィードに収まり、60秒ならデモを入れる余裕があります」）。
• 形にするアイデアがある場合、新しい映像については /hyperframes の references/pitch-round.md に従って方向性を示します。この映像についてのアイデアなら、指定された部分について2つか3つの選択肢を出し、1つを推奨します。
• 次のステップと、それを開始する合図となる言葉で締めくくります（「作る」と言っていただければ始めます）。

計画はチャットだけでなく、プロジェクト内にも残してください。次のメッセージでは、今回のセッションを参照できない新しいセッションが始まる可能性があります。/hyperframes-creative の references/storyboard-recipe.md § 1 にあるフレームへのメモの記録方法に従って、STORYBOARD.md に追加します。ロック済みのフレームは決して上書きしないでください。相手が何も変更しないよう求めている場合は、何も書きません。返信に計画を記載し、保存することを提案します。

1. すべてのシーンはサブコンポジションです

ルートコンポジションには、タイミング付きのホスト、メディア、音声のみを配置します。子要素を含む div、字幕付きのタイトル、チャートなど、ネスト構造を持つシーンはそれぞれ独立したファイルにして、data-composition-src で読み込みます。設定は /hyperframes-core references/sub-compositions.md を参照してください。

ルート内にネストしたマークアップを残しても、独立した行にはなりません。トリミングも部分ごとの移動もできない、不透明な1行の中に隠れてしまいます。

構造の違反をすべて検出するリンターがある前提で作成してください。

2. 字幕トラックは1つ

• すべての字幕を1つのトラックにまとめます。すべての字幕グループを順番に含む、単一のサブコンポジションホスト（単一の data-track-index）に data-track-kind="captions" を指定します。
• 字幕グループごとに行を作ったり、種類の異なるトラックに字幕を混在させたりしないでください。
• 単語タイミングのルールに変更はありません。/embedded-captions と caption_* リンタールールを参照してください。

3. 1つのトラックにつき要素の種類は1つ

種類ごとにまとめ、各行を、ユーザーがまとめて選択、ミュート、ドラッグできる1種類の要素にします。

種類	data-track-kind
ベース動画／Aロール	video（タグから取得）
シーン、オーバーレイ、グラフィック	graphics
字幕	captions
音声（ナレーション、音楽、効果音）	audio（タグから取得）

サブコンポジションホストには data-track-kind を指定します。動画と音声の種類はタグから取得されるため、<video> と <audio> に属性は不要です。種類ごとに個別の data-track-index を割り当てます。この番号は表示専用で、前面にレンダリングされる要素には影響しません。レイヤー化には CSS を使用してください。

4. セーフゾーン

定規やセーフボックスのオーバーレイはプレビュー領域に配置し、コンポジション内には配置しません。そのため、HTML にガイド要素を追加しないでください。 横長と縦長のどちらのフレーミングでも、Premiere のデフォルトと同じ2つのセーフボックスを使用します。プレビューの切り替えでは、各辺の中点に目盛りを付けてボックスを描画します。ソース： packages/studio/src/utils/previewSafeMargins.ts の ACTION_SAFE_PERCENT と TITLE_SAFE_PERCENT。

ボックス	フレームに占める割合	各辺からの内側の余白
アクションセーフ	90%	5%
タイトルセーフ	80%	10%

• セーフマージン：表示される要素はすべてアクションセーフボックス（90%）内に収め、字幕と重要なコンテンツはタイトルセーフボックス（80%）内に収めます。
• 2分割および50/50のレイアウトでは、各半分のコンテンツをタイトルセーフボックス内に収めます。

5. 新しい映像作品：計画、ストーリーボード、制作

hyperframes-launches の映像作品は、この順序で制作されました。各ステップには担当者がいます。その手順に従い、ここでは繰り返し説明しないでください。

Step	Owner
1. Brief	/hyperframes references/intent-interview.md。既存のプロジェクト内では、同じ作品の続編のみを対象にします。新バージョンまたは短縮版で、ワークフローとアスペクト比は同じものです。必須の質問を行い、hyperframes init は省略し、BRIEF.md と STORYBOARD.md は上書きせず、それぞれに日付入りの新しいセクションを追加し、その旨を返信で伝えます。ワークフローまたはアスペクト比が異なる作品は新しいプロジェクトとして開始し、その旨を返信で伝えます。
2. Directions	/hyperframes references/pitch-round.md
3. Storyboard	/hyperframes-creative references/storyboard-recipe.md
4. Build	ブリーフで指定されたワークフロー（/hyperframes § 2）と、そのワークフロー独自のリファレンス
5. Notes	/hyperframes references/review-loop.md

製品ローンチ向けに、ローンチ動画が加える要素です。ワークフローで選ばれた構成が異なる場合は、 その構成を優先します。

• リリース済み製品の実際の映像。 ワークフロー自体が録画をキャプチャする場合（URLからサイトを表示する場合）を除き、ブリーフで画面録画を依頼し、届くまではラベル付きのプレースホルダーをその位置に置いてください。リリース済み製品のUIを決して推測で再現しないでください。背景として表示するサードパーティ製ツール（チャットアプリやエディターなど）は、キャプチャに忠実に再現します。
• ひとつの世界。 同じウィンドウやキャンバスがビートをまたいで続きます。すべてのカットをスクラブして確認してください。残る要素があれば、飛んではいけません。
• カーソルとスクロールするコンテンツ。 カーソルやウィンドウ自体をスクロールして画面外に出るコンテンツは、フレームの途中でフェードするのではなく、ウィンドウまたはフレームの端から出ます。要素やテキストの切り替えには、ワークフローに cut-catalog.md がある場合はその内容に従います。
• **映像が動いている状態で、コマンドまたはアドレスを見せて締めくくり、**ロゴを表示します。
• すべてのバージョンで実行時間を明記します。 目標時間を超えるかどうかは、あなたではなく本人が判断します。

作業の確認

hyperframes check を実行して（lintも実行されます）、指摘された箇所をすべて修正してください。その後、Studioでプロジェクトを開き、タイムラインにベース行、シーンホストごとに1行、字幕行1行、音声行が表示されることを確認します。