XiaoDuoYa/AeVideoGen

HxdLabs_ v1.0.1 による AeVideoGen

商用出荷可能な製品フィルムを作成します。製品の動作は真実に、ストーリーは因果関係に、タイポグラフィは可読性に、フォーカスは意図的に、モーションは生き生きと、レビューは正確に、エクスポートは安定して保ちます。

制作契約を遵守する

• HyperFrames は絶対に使用しない。
• 要求された製品バージョンとそのソースを、視覚的かつ動作的な真実として扱う。
• 参考動画は、タイミング、モーショングラマー、カメラ言語、タイポグラフィ、トランジション構造のために使用する。サードパーティの製品アセットをコピーしたり、他の製品をユーザーの製品であるかのように見せかけたりしない。
• ネイティブ UI のプロポーションを維持する。均一にスケーリングし、引き伸ばさない。
• すべてのポインタークリックは、表示されている実際のコントロールを操作可能にし、カメラの焦点は同じターゲットに合わせる。
• サポートされていない機能、主張、ソース状態、コピー、アイコン、レイアウトをでっち上げない。
• ユーザーがブラウザプレビューを明示的に承認するまで、最終ビデオをレンダリングしない。
• 大幅な変更を行う前に、承認されたベースラインをバックアップし、バージョン管理された出力パスを使用する。
• 解像度、フレームレート、再生時間、ソースバージョン、ストーリーの優先順位、音楽の同期を黙ってダウングレードしない。

実装前に完全性ゲートを実行する

まず、ユーザーのプロンプトと提供されたすべてのアーティファクトを調査する。ファイル、ソース、メタデータ、会話内に既に存在する事実について質問しない。

実装前に、ガイド付きキックオフを直ちに返す：

1. 既に受け取った内容を要約する。
2. ブロッキングギャップをリストアップし、それぞれが商用品質にどのように影響するかを説明する。
3. ユーザーが提供できる具体的なアセットや決定を積極的に提案する。
4. 次の1～3つの最も影響の大きい質問をする。
5. マルチステージ制作には Goal モードを推奨し、ペースト可能な Goal 目標、入力、制約、ステージ、完了基準を提供する。

すべてのブロッキングまたは有用な欠落している決定について、2つまたは3つの具体的な選択肢を提供する。推奨する選択肢を最初に配置し、各選択肢の目に見える結果を説明し、適切な場合にはユーザーが「按推薦方案」と返信できるようにする。説明のない自由形式の質問でブロックしてはならない。

ユーザーが明示的に Goal の作成/開始/使用を要求しない限り、Goal を作成しない。推奨事項とペースト可能な Goal ブリーフは、本格的なフィルム制作には必須である。自動的な Goal 作成は禁止する。

assets/web-motion-starter/brief.json から brief.json を作成し、次を実行する：

python3 scripts/validate_brief.py brief.json

ブロッキングフィールドが不明なままの場合は、簡潔な質問をし、ブリーフが完了するまで後続のターンで質問を続ける。一度に1～3つの関連する質問をする。いくつかの要件が言及されたという理由だけで、創造的な実装を開始してはならない。

ユーザーが明示的に最善の判断を使用する、質問をスキップする、または不完全なブリーフで開始するように指示した場合にのみ、記録された前提で進める。そのようなフィールドはすべて assumptions にマークし、影響の大きい事実はソースに基づいて保持する。

ブリーフが新しく、不完全で、矛盾しているか、または実質的に改訂されている場合は常に、references/intake-and-clarification.md を完全に読む。 キックオフ時に references/guided-production.md を完全に読み、制作全体を通じてその進捗レポート形式を使用する。 要件が不足している場合や、ユーザーが何を選ぶべきか尋ねてきた場合は、references/decision-options.md を読む。

ワークフローを実行する

1. 保護と監査

• リポジトリの状態、バージョン、ルート、コンポーネント、ストア、スタイル、寸法、フォント、アイコン、状態遷移、ターゲットヒット領域、プライベートデータを検査する。
• 大規模な編集の前に、回復可能なベースラインを作成する。
• 撮影されたすべての主張と状態を、ソース証拠または明示的なユーザー確認にマッピングする証拠台帳を構築する。
• 監査後、短い進捗レポートを送信する：完了した証拠、残存リスク、および次にレビュー可能なアーティファクト。
• 製品 UI を再構築する前に、references/source-reconstruction.md を完全に読む。

2. 参考資料をコピーせずに分析する

提供されたすべての参考動画について：

1. 再生時間、解像度、フレームレート、オーディオ、ショット構造を読み取る。
2. 数秒おきのサムネイルではなく、アニメーションが見えるほど密にフレームを抽出する。
3. カット、モーフ、ズーム、テキストの出現、クリック、トランジションの周辺に 8～12fps のウィンドウを追加する。
4. オーディオ付きで通常速度で参考動画全体を視聴する。
5. モーション言語台帳を作成する：被写体、カメラパス、イージング、持続時間、ハンドオフ、マスク/シェイプ、タイポグラフィ、ホールド、サウンドキュー。
6. その文法をユーザーの実際の製品とブランドに変換する。

決定的な抽出のために scripts/analyze_reference_video.py を実行する。スタイルの一致や再現を主張する前に、references/reference-video-analysis.md を完全に読む。

3. 因果関係のあるフィルムを書く

このナラティブチェーンを使用する：

ユーザーコンテキスト → フラストレーション → 製品アクション → 目に見える結果 → 記憶される価値

• 各シーンに1つの目的と1つの支配的な視覚的被写体を与える。
• 二次的な機能ではなく、主要な約束を音楽のクライマックス内に配置する。
• 純粋なテキストを意味のある句読点または共有要素として使用し、決して埋め草として使用しない。
• 読むのに十分な長さの大きな質問を表示し、その同じ要素を実際の入力にモーフィング/ドッキングする。
• すべての見出しの改行を計画する。偶発的な折り返しを許可しない。
• アニメーションの前に production.json を作成し、最新の状態に保つ。
• タイミング変更後は scripts/validate_timeline.py production.json --strict を実行する。
• 本実装の前に、提案されたシーンチェーン、クライマックス配置、未解決の創造的決定を報告する。

シーングラフを設計する前に、references/creative-direction.md を完全に読む。方向性を商業的に準備完了と宣言する前に、references/commercial-quality.md を読む。

4. 音楽を分析および編集する

次を実行する：

python3 scripts/analyze_music.py music.mp3 --target-duration 30 --output music-map.json

• すべての候補ウィンドウを聴く。アルゴリズムマーカーは提案である。
• 音楽的に一貫性のあるソース範囲を選択し、そのオフセットを記録する。
• セクションの盛り上がりと主要なビートをマッピングする。すべてのビートをマッピングする必要はない。
• クライマックス盆地を維持する：アプローチ、読み取り可能なペイオフ、解放。
• シーン内部のアクセントがビートにヒットする可能性はあるが、シーンペーシングは読み取り可能に保つ。

5. 実際の製品状態を再構築する

• 許可されている場合、実際のソースコンポーネント、CSS、SVG、アイコン、フォント、コピー、状態ロジックを再利用する。
• ネットワーク状態を、決定論的でスキーマに忠実なローカルフィクスチャに置き換える。
• 最終的なコンポジションをランタイムネットワーク呼び出しから独立したものに保つ。
• 各ネイティブサーフェスの寸法を記録し、均一にスケーリングする。
• 最終レイアウト後、getBoundingClientRect() からクリック中心点を導出する。
• 実際の状態変化を示す。スクリーンショットを拡大してインタラクションと呼んではならない。

6. 焦点と連続性を振り付ける

• 注意の順序：フォーカス、ポインターアプローチ、クリック、フィードバック、結果。
• シーンが意図したフレーミングに到達したら、3つまたは4つの修正的なリセンタリングではなく、1つの連続したカメラ移動を使用する。
• 意味のあるグループ全体を視覚的中心として扱う：チャットの場合、質問と回答を中心に配置する。プラグインの場合、特定のコントロールが宣言された被写体でない限り、プラグインを中心に配置する。
• 視聴者が読む必要がある場合には、断固としてズームする。可読性を犠牲にして空のスペースを保護しない。
• 読み取り可能なホールドを従属的なモーションで生き生きと保つ。フレームを完全に静止させない。
• 時間内に読めない無関係な素材はぼかす/暗くする。
• 共有要素、FLIP、シェイプ継承、マスク、フォーカスプル、スクロール連続性のトランジションを優先する。
• すべての状態を決定論的時間から導出する。window.__AE_VIDEO__.render(t) を公開する。

7. localhost でレビューする

• 再生/一時停止、スクラバー、秒数、フレームインデックス、±1フレームステッピング、時間表示、シーンマーカーを備えた正確なコンポジションを提供する。
• キャプチャモードでは、すべてのレビューコントロールを非表示にする。
• すべてのクリック、ズーム、ライントランジション、共有要素、クライマックス、エンディングの周辺でチェックポイントを検査する。
• オーディオ付きで通常速度でフィルム全体を再生する。
• 実際のヒットターゲット、ネイティブ比率、意図した改行、読み取り時間、視覚的中心、連続モーション、ソースの真実、音楽の同期を検証する。
• 正確なプレビューをユーザーに表示し、明示的な承認を待つ。
• 最後に承認されたプレビュー以降に何が変更されたかを報告し、レビューが必要な正確な時間範囲をユーザーに指示する。

references/qa-gates.md を完全に読み、すべてのブロッキングゲートを通過する。

8. 承認されたバージョンのみをレンダリングする

• プレビュー承認とエクスポート許可を2つの別々の決定として扱う。
• プレビュー承認後、プレーンな言葉で、エクスポートにより localhost アニメーションが共有可能なビデオファイルに変換されることを説明する。ユーザーが今エクスポートを希望するかどうかを尋ねる。
• エクスポート前に、明瞭さ、滑らかさ、レンダリング負荷、時間、ストレージ、互換性に対する結果を伴う明確な品質の選択肢を提供する。ユーザーのデバイスとプラットフォームに1つのオプションを推奨する。
• 解像度、フレームレート、フォーマット/コーデック、オーディオ、プラットフォーム、ファイル名を確認する。ユーザーがエクスポート仕様を明示的に確認するまでエクスポートしない。
• 対応する明示的な決定の後にのみ、approval.status、approval.approvedVersion、approval.exportRequested、approval.exportSpecConfirmed を設定する。
• scripts/validate_brief.py brief.json --final および scripts/validate_timeline.py production.json --final --strict を実行する。
• 新しいフレームディレクトリとファイル名にレンダリングする。古いフレームと新しいフレームを決して混在させない。
• scripts/render_web_video.mjs の安定したコンポジターハンドシェイクを優先する。不安定なフレームでは停止し、破損をエクスポートしない。
• 4K60 が利用可能なハードウェアを超える場合、2560×1440 60fps を強力なデフォルトとして扱うが、ターゲット仕様をユーザーの承認なしに変更しない。
• faststart を使用して H.264/AAC yuv420p をエンコードし、次に ffprobe、フルデコード、連続性チェック、視覚的コンタクトシートレビューを実行する。

これらの失敗をブロックする

• 明示的な許可なしに前提を置いた不完全なブリーフ。
• 仮想クリック、中心点が間違ったズーム、またはサポートされていない機能。
• 1つのアクション内での繰り返される微小リセンタリング。
• 引き伸ばされた/切り取られた製品サーフェス、または任意の内部タイプリサイズ。
• 重要なテキストが小さすぎる、短すぎる、隠れている、または偶発的に折り返されている。
• スペースを埋めるために挿入された意味のない小さなコピー。
• 意味のあるアクションを完了せずに、シーンが完全に静止または速すぎる。
• 無関係な被写体が繰り返し中央に切り替わる。
• 大きなテキストとその宛先フィールドがモーフ中に一致しない。
• 継承されたジオメトリ、モーション、カラー、フォーカス、または意味のないトランジション。
• 間違った価値に割り当てられた音楽のクライマックス。
• モーションを理解するにはサンプリングがまばらすぎる参考動画。
• ソースに基づく製品証拠ではなく、汎用フィーチャーカードからでっち上げられた最終ページ。
• 承認前、または破損した/不完全なフレームでエクスポートされた最終レンダリング。
• 別のプレーンな言葉による品質選択と明示的なエクスポート確認なしに開始されたエクスポート。

バンドルリソースをルーティングする

• references/intake-and-clarification.md：ブリーフの完全性とフォローアップ動作に必要。
• references/guided-production.md：強力なオンボーディング、Goal モードのハンドオフ、進捗コミュニケーションに必要。
• references/decision-options.md：推奨される選択肢、代替案、初心者に優しいトレードオフに必要。
• references/reference-video-analysis.md：参考動画分析またはスタイル再現に必要。
• references/source-reconstruction.md：ウェブサイト、拡張機能、アプリ、または