生物成長アニメーション

生物の段階画像を、持続的に成長する科学的なアーカイブ映像に仕上げます。再利用されるのは連続変形とインターフェースシステムです。新しい生物の画像、段階名、解剖学的制御点、および注釈線の位置は必ず再設計し、単に海馬のタイトルを変更するだけではいけません。

デフォルト：10秒、3:4縦型900×1200、60fps、黒背景、ナレーションなし、コンセプトデータ。ユーザーから別の尺、ビジュアルリファレンス、または納品形式が指定された場合は、それに従って調整します。内蔵のHUDテンプレートは3:4および同比率の解像度、2～8段階をサポートします。それ以外のアスペクト比では、実際にレイアウトを変更する必要があり、単に画面を引き伸ばすことはできません。

ワークフロー

成長シーケンスの決定。 リクエストに既にある生物とビジュアルの方向性を使用します。各段階には対応可能な姿勢が必要です。単純な体サイズの増加であれば直接連続変形で対応できますが、カエルや蝶など、手足が生えたり失われたりする変態を伴う場合は、まず素材と形態ガイドを読み、トポロジー的に連続な区間ごとに段階を分割します。コンセプト図を実際の成長データと偽ってはいけません。知識解説内の段階や事実は事前に検証します。
素材の作成と確認。 新しい素材は利用可能な内蔵 imagegen を使用し、背景を透明に設定します。完全なプロンプトと背景除去戦略は素材と形態ガイドを参照してください。同一のカメラアングル、向き、光源を採用します。まず実際の出力結果を確認し、実際の寸法を読み取り、グリッド境界を決定します。灰色の背景、霧状の矩形、隣接グリッドの漏れ込みは、アニメーション化する前に処理します。プロンプトで指定した寸法がそのまま実現されているとは想定しないでください。
設定ファイルの作成。 設定の説明を読み、assets/examples/seahorse.json から構造をコピーしますが、新しい生物用に意味論的な制御点を再調整します。タイトル、段階、サイズアンカー、2つの指標セット、注釈、カラーテーマを設定します。アトラス画像のパスは設定ファイルからの相対パスで指定します。すべての制御点には、単一グリッド内の元のピクセル座標を使用します。キーポーズには、頭部/胴体/付属肢の連続的な対応関係が必要です。
プロジェクトの生成。 現在のスキルディレクトリを BIO_SKILL_DIR として、作業ディレクトリで以下を実行します。
```
python3 "$BIO_SKILL_DIR/scripts/create_project.py" --config work/specimen/config.json --validate-only
python3 "$BIO_SKILL_DIR/scripts/create_project.py" --config work/specimen/config.json --out work/specimen/project
```
出力ディレクトリは存在しないか空である必要があります。スクリプトは既存のプロジェクトを上書きしません。このスクリプトはローカルのGSAP、フォント、変形レンダラーをコピーし、設定を埋め込み、HyperFramesプロジェクトを生成します。既存素材のレンダリングに画像APIは呼び出されません。プロジェクトはPython3で生成され、動画の検証/エクスポートにはNode.js 22+、FFmpeg、および利用可能なChrome/WebGLが必要です。HyperFrames CLIは検証済みのバージョンに固定されており、初回実行時に依存関係のダウンロードが必要になる場合があります。
トランジションを確認し、段階の端点だけを見ない。 生成されたプロジェクト内で npm run check -- --snapshots を実行し、最初の可視フレーム、各2姿勢間の中間フレーム、成熟体、および最終ホールドフレームを確認します。特定の時点のスクリーンショットが必要な場合は、npx hyperframes snapshot --at <カンマ区切りの時間> を実行します。最初のスクリーンショットを再確認し、非同期初期化によって最初のフレームがタイムラインにバインドされていない状態になっていないか確認します。グリッドの反転、目の二重像、尾の輪切れ、アトラスの途切れ、タイトルによる遮蔽、注釈線が身体から外れていることなどがないことを確認します。
エクスポートを完了する。 ユーザーが最終成果物を希望する場合、許諾範囲内でエクスポートします。すでに決定した制作要件について再質問することは避けます。
```
npm run render -- --quality delivery --output renders/growth.mp4
ffprobe -v error -select_streams v:0 -show_entries stream=width,height,r_frame_rate,duration,nb_frames -of json renders/growth.mp4
```
エクスポートされた動画の中間フレームを確認します。MP4、設定/プロジェクトソースファイル、および素材プロンプトを納品します。ユーザーがアクセス可能なファイルは現在のワークスペースで合意されたoutputsディレクトリに配置し、中間生成画像、ログ、確認フレームはworkディレクトリに残します。ユーザーから要求がない限り、外部サービスに公開またはアップロードしないでください。

既存のHyperFrames関連スキルがある場合は、そのランタイムとCLIの規則を継承します。ここでのテンプレートは成長アニメーションの具体的な生成を担当し、会話内ですでに確定した設定を再度収集することはありません。

スムーズさを維持するための必須実装

主体は単一の連続した成長進行度を持ちます。目、吻/口、胴体、付属肢、巻き尾などの制御点はすべて、この同一の進行度に従って変化します。0.3秒戻って画像を切り替えることでスムーズな成長を代替することはできません。単にfpsを上げても、画像切り替え感は修正できません。
共有三角形メッシュは隣接するテクスチャを共通の形状に引き伸ばします。Catmull-Rom曲線は制御空間の軌跡を制御し、距離場補間は輪郭を収束させ、透明度が重なった際の二重エッジを低減します。複雑なトポロジー変化を制御点の追加だけで無理に対応してはいけません。
注釈線は変形後の制御点を直接読み取ります。数値は現在の進行度をフォーマットして表示し、小数桁を保持します。初期 stroke-dasharray を固定したまま、後から引き出し線を引き伸ばし続けることはしないでください。
単一の一時停止(paused)GSAPタイムラインがプロパティsetterを駆動します。シークによって抑制されたonUpdateコールバックに依存せず、実際のクロックも使用しません。画像デコードとメッシュ構築が完了した後にタイムラインを登録し、利用可能な __hfForceTimelineRebind() を呼び出します。
内蔵の輪郭補間は、透明画像のアルファに対してしきい値処理を行います。半透明のクラゲや薄い翅の場合、触手や薄いエッジが失われていないか確認し、実際の素材に合わせて morph.alphaThreshold を調整します。物理的な透明マテリアルの保持は保証されません。

クイック検証と呼び出し例

スキルには元の海馬の素材と検証済み設定が同梱されており、回帰テストに使用できます。これを新しい生物の素材として偽ってはいけません。

python3 "$BIO_SKILL_DIR/scripts/create_project.py" --config "$BIO_SKILL_DIR/assets/examples/seahorse.json" --out work/growth-smoke

典型的なリクエスト例：「このスキルを使って、クラゲが小さいところから大きくなる成長アニメーションを作って。10秒、青緑色、60fpsで。」

ジェネレーターをメンテナンスする際は、python3 scripts/test_create_project.py および node scripts/test_renderer.mjs を実行できます。これらは画像APIの呼び出しやレンダリングを行いません。

ユーザーが既存のショート動画を修正したいだけの場合は、その素材とレイアウトを保持し、対応する設定またはランタイムを調整します。新しい画像セット全体を再生成しないでください。内蔵ジェネレーターはプロジェクトの config.json から、同じ階層の新しいディレクトリに再構築することをサポートしています。検証後に新しい結果を採用してください。

生物成長動畫