Ian Xiaohei SVG Motion
Ian の記事内における小黑(Xiaohei)スタイルの挿絵原則を、制御可能な HTML + SVG + GSAP timeline による動的表現に変換します。目標は画像生成をそのまま再現することではなく、記事内の一つの認知動作を、マンガの舞台装置として再構築することです。これにより、動画収録、字幕とのタイミング合わせ、後からの文章や要素の修正が容易になります。
基本ルール
PNG 画像を自動ベクター化して、得られたパスの集合をアニメーションさせてはいけません。ラスター画像は構図の参照としてのみ使用してください。シーンは意味のある SVG グループとして再構築します。
アイデア -> ショット計画 -> SVG レイヤー計画 -> HTML/SVG テンプレート -> GSAP タイムライン -> 静止画 + 動きのレビュー
ワークフロー
- 記事、スクリプト、スクリーンショット、ストーリーボードシーンから、一つの認知的なアンカー(核となる概念)を抽出します。
- 物理的なメタファー(比喩)を一つ選択します:整理する、運ぶ、橋渡しする、漏れる、捕まえる、折りたたむ、重さを測る、開く、経路を変える、落ちる。
- 小黑(Xiaohei)が中心的な動作を実行するようにします。もし小黑を削除しても意味が変わらない場合は、再設計してください。
- 16:9 の白いキャンバス上に、メインシーン一つ、35%以上の余白、最大3~5個の短い手書き風注釈を配置してデザインします。
- 動くオブジェクトごとに、意味のある SVG グループを作成します。
- GSAP タイムラインでアニメーションを付けます。
x、y、rotation、scale、opacity、および SVG のストローク描画を使用します。レイアウト全体が動くようなアニメーションは避けてください。 - 再生可能な HTML ページと、静的レビュー用のスクリーンショットの両方を保存します。
- 口述動画用のプロジェクトの場合、最終レンダリング前にタイムラインのセグメントを字幕やキュー(合図)のタイミングに合わせます。
必要なときに参照
- 新しいシーンをデザインする前、または結果が Ian Xiaohei スタイルとして適切か判断する前に、
references/style-rules.mdを読んでください。 - SVG 構造を書いたり編集したりする前に、
references/svg-layering.mdを読んでください。 - GSAP アニメーションを書く前に、
references/motion-rules.mdを読んでください。
出力規定
デフォルトの出力フォルダ:
output/<スラッグ>-xiaohei-svg-motion/
必須ファイル:
index.html
README.md
preview.png
vendor/gsap.min.js
オプションファイル:
source.png # ユーザーが提供した参照画像
cue-map.md # 話し言葉のスクリプトや字幕に合わせる場合
再利用可能アセット
AI モデルとインターフェースのアイコンは次の場所にあります:
assets/icons/
assets/icons/index.json を信頼できる情報源として使用します。元の SVG ファイルはサブフォルダに保存し、生成時にその完全な SVG コンテンツをシーン SVG にインライン展開することで、グラデーション、ストローク、ブランドカラーが保持されるようにします。
アイコンルール:
index.jsonに既に該当するモデル、プロバイダー、または意味的なアイコンが存在する場合は、そのアイコンを使用します。ChatGPT、Claude、Flash lightning(フラッシュ稲妻)、Step、DeepSeek、Qwen、バグ、テーブル、チャート、データベース、ウェブのアイコンを、汎用的なボックス、星、火花、抽象的なマークに置き換えないでください。- ユーザーが新しい SVG アイコンを提供した場合は、生の SVG を
assets/icons/<カテゴリ名>/に保存し、index.jsonにエントリを追加してから、シーン計画内で ID によって参照します。 - 比較シーンの場合、アイコンの選択は意味の一部です。モデルアイコンはサイズと配置を視覚的に統一し、視聴者が小黑がオブジェクトを動かし始める前に登場人物を識別できるようにします。
テンプレート
リクエストが、動くオブジェクト、矢印、注釈、または小黑のアクションを含む手書き風マンガシーンに似ている場合は、assets/templates/xiaohei-comic-motion/ をスターターテンプレートとして使用します。
リクエストが、複数のバリエーション、再利用可能なシリーズ、または口述説明シーンのためのより広範なリファレンスセットを求める場合は、assets/templates/xiaohei-series-reference/ を使用します。
テンプレートをプロジェクトの出力フォルダにコピーし、その後以下の項目を編集します:
- SVG グループ名。
- 手書き風ラベル。
- オブジェクトの位置。
- タイムラインのラベルと継続時間。
- シーン固有のメタファーに関する README のメモ。
品質ゲート
最終レスポンスの前に:
- ローカルサーバーで HTML を開く。
- コンソールでエラーを確認する。
?static=1を付けて静的スクリーンショットをキャプチャする。- シーンに複数のビートがある場合は、再生中のあるフレーム(できれば中盤)を少なくとも一つキャプチャする。可能であれば、
?frame=midを使用して決定的なレビューフレームを取得する。 - テキスト、矢印、小黑、小道具、ベルト、ピット(穴)、カード、最終的なインパクトポイントが重なっていないことを目視で確認する。
- アニメーションに目に見える進行があることを確認する:最初にコンテキスト、次にアクション、その後に問題/結果、最後にまとめ。
- 注釈は、それが説明するオブジェクト/アクションの後にのみ表示されることを確認する。
- オブジェクトの動きですでに方向が示されている場合は、装飾的または半透明のガイド矢印を削除する。
- 小黑がアクションの一部であることを確認する。
- ユーザーが明示的に PNG のみのカメラ移動を要求した場合を除き、ページが単なる
<img>タグ内の PNG 画像ではないことを確認する。