艺术动画skill：35种艺术风格、9种解说语法，用代码让画动起来。

huashu‑art‑motion – コード駆動の芸術的アニメーション

概要 – コーディングエージェントがさまざまな芸術スタイルで短いフレーム精度のアニメーションクリップを生成できるようにするコード、データ、ツールのコレクションです。このリポジトリには以下が含まれます：

コンポーネント	内容
35 のスタイル「レシピカード」	洞窟壁画からゴッホ、バウハウス、8 ビット、ヴェイパーウェイブなどのスタイルのパラメータセット、モーションモチーフ、トランジション定義。
エンジンとライブラリ	ブラシ、レンダラー、後処理、カメラヘルパー、オーディオ合成テンプレートなどを備えた自己完結型アニメーションエンジン（`scripts/engine/`）。
シーンスクリプト	各スタイルに 1 つの実行可能なシーン（`scripts/engine/scenes/`）。
解説ビデオ文法	ナレーション仕様をタイミング付きクリップにマッピングする 9 つの JSON 駆動の「文法」テンプレート（Kurzgesagt、Vox、ホワイトボード、ストーリータイム、キネティックタイプ、3Blue1Brown、キーノート UI、ファイナンスチャート、プレゼンター）。
ロングスクロールデモ	キャラクターが連続する絵画を歩くスケルトンで、3 つのサンプルワールド（エジプトの壁画 → モネ → 8 ビット）があります。
ユーティリティスクリプト	`breakdown.py`（参照ビデオをカットグリッド + モーションヒートマップに変換）、`qa.py`（自動品質メトリクス）、オーディオ生成ヘルパー、フォントサブセット化など。
ドキュメント	12 のメソッドガイド markdown ファイル、スタイルカード markdown、文法仕様、およびコーディングエージェントが正しいドキュメントを選択する方法を説明する `SKILL.md`。

仕組み（ハイレベル）

スタイルを選択 – 35 のレシピカードから 1 つを選択します。各カードはブラシ設定、カラーパレット、特徴的なトランジション、ショートフィルムの「テンプレート」を定義します。
仕様を書く – 解説ビデオ文法の場合、ナレーション行、タイミング、オプションのアセット（例：キャラクター画像）をリストした JSON を提供します。エンジンは仕様をフレーム精度のタイムラインに変換します。
レンダリング – 提供された Python エントリポイント（scripts/engine/render.py）を選択したシーンまたは文法で実行します。スクリプトは依存関係管理に uv、ビデオエンコーディングに ffmpeg、ヘッドレスキャンバスレンダリングに Playwright Chromium を使用します。
QA – レンダリング後、qa.py は安定性、フレームあたりのコスト、モーションの滑らかさ、テキストオーバーレイの一貫性を評価します。別のエージェントが出力を検証するために実行できます。
合成 – 生成された MP4（またはアルファ付き PNG シーケンス）は、ステッチしたり、ナレーションパイプラインに追加したり、より大きなプロダクションの視覚要素として使用できます。

クイックスタート（クイックステップ）

# 1. クローンして依存関係をインストール
 git clone https://github.com/alchaincyf/huashu-art-motion.git
 cd huashu-art-motion
 uv sync   # uv、ffmpeg、playwright などをインストール
 uv run --with playwright playwright install chromium

# 2. ゴッホスタイルの単一フレームをレンダリング
 uv run --with playwright python scripts/engine/render.py \
     --solo 09_postimp --stills 0.3 --out demo_van_gogh.png

# 3. 完全な解説クリップをレンダリング（ファイナンスチャート文法）
 uv run --with playwright python scripts/engine/render.py \
     --spec scripts/engine/examples/t3_finance_chart.json \
     --out finance_chart.mp4

--solo フラグはシーンを選択します。--spec は文法 JSON を指します。

誰が使うべきか？

コンテンツクリエイター：YouTube の解説ビデオ用にプログラム的でスタイル一貫性のあるアニメーションを求める方。
AI エージェント（例：Claude、GPT‑4o）：「猫がキャンバスを歩くための 5 秒のゴッホトランジションを作成」 のようなタスクを与えられ、適切なレシピとレンダリングスクリプトを呼び出すことができます。
研究者：手続き型アート生成、スタイル転送パイプライン、自動ビデオ QA を探求する方。
教育者：コードが美術史の時代を超えて視覚的なストーリーテリングを駆動する方法を示す方。

制限と範囲

リポジトリはコードとデータのみを提供します。ナレーションオーディオやカスタムキャラクターアセットは自分で用意する必要があります。
レンダリングはヘッドレス Chromium キャンバスに依存します。パフォーマンスはハードウェアに依存します。
9 番目の「プレゼンター」文法は参照実装であり、独自のキャラクターフレームを提供することを想定しています。

ライセンス

コアコードとドキュメント：MIT（自由に変更および再配布可能）。
フォント：さまざまな SIL OFL ライセンス。
ストロークデータ：Arphic Public License。
作者の漫画アバターとデモビデオ画像はデモンストレーションのみを目的としており、MIT ライセンスの対象外です。

TL;DR

huashu-art-motion は、コーディングエージェントの高レベルな説明を 35 の芸術スタイルのアニメーションクリップに変換するスキルパッケージであり、既製のシーンスクリプト、スタイルレシピ、解説ビデオ文法を備えています。これは、生成アート、手続き型アニメーション、AI 駆動のコンテンツパイプラインの交差点にある、真のコード中心のプロジェクトです。

alchaincyf/huashu-art-motion