Communitygithub.com

Pulupulu Motion

モーショングラフィックを HTML と GSAP のタイムラインとして作り、ヘッドレス Chrome でフレームごとに撮り、ffmpeg でナレーションと音楽を合わせる。

Pulupulu Motion とは?

Node、ffmpeg、pulupulu CLI があることを先に確認し、フラットなベクター、文字、図表、地図を組む。実在の顔、リップシンク、連続する身体動作は受けず、その旨を言う。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Alucard0x1/pulupulu-motion/tree/HEAD

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Pulupulu Motion は何をしますか?

ここでの映画とは、ChromeがフレームごとにレンダリングするHTML上のタイムラインです。ビデオエディタは一切使いません。あなたはページを書き、CLIが固定フレームレートでスクリーンショットを撮り、ffmpegが音声を多重化します。

このファイルはルーターです。以下の問いに答えます。このジョブを実行してよいか、最初に何を実行するか、何が合格しなければならないか、詳細はどのページにあるか。作業中の部分に関連する参照ページだけを読み込んでください。

1. 約束する前に

python scripts/doctor.py                    # 読み取り専用: python, node, ffmpeg, CLI, キー, ディスク
python scripts/doctor.py --project film/    # さらに: ページ契約が存在するか

終了コード1は、このマシンでは映画を制作できないことを意味します。シーンを書いた後に発覚しないでください。コマンドごとにnpxを呼び出さないでください。check、still、renderのたびにネットワークラウンドトリップが発生するのは、このワークフローで最もよくある自己原因の速度低下です。

このツールが適さないケース: ストーリーに不足しているフッテージ、実在の人物の顔や肖像、 articulate された人間や動物の解剖学的構造、連続した物理的動作、リップシンクが必要な場合。このツールはフラットなベクタージオメトリ、タイポグラフィ、チャート、マップ、アイコン、カラーコード化されたオブジェクトをうまくレンダリングしますが、上記のものはうまく処理できません。類似物を生成する代わりに、その旨を伝えてください。アーカイブ素材の描画代用はスタイルの選択ではなく、出典の問題です。

2. ワークフロー(順序通り)

1ビート = 1文 = 1ショット。タイミングは計測された発話に基づき、創作ではありません。

  1. ブリーフィング. 主題、対象者、プラットフォーム、言語、ナレーションの有無。不足している主題については質問してください。動画が依頼された場合にナレーションをするかどうかは質問しないでください。
  2. HTMLの前にストーリーボード — references/narration-and-captions.md。キャプションは逐語的な発話であり、その要約ではありません。
  3. ナレーションと計測. python scripts/deepseek_voice.py beats beats.json film/assets/voice.wav --voice stella --timeline timeline.json、次に gate でASRによる各フレーズの確認。ルート、音声、制限については references/narration/deepseek-tts.md を参照。
  4. timeline.jsonからページを構築。ストーリーボードからではありません。契約: references/cli.md。ストーリーにアイコンライブラリにないオブジェクトが必要な場合、まず印刷パネルとして生成してください — references/generated-assets.md — それらを組み立ててください。写真の代用を手描きしないでください。
  5. チェックしてから確認する. pulupulu check .、次に pulupulu still . --at 2,12,24 --out .om/stills でスチルを開く。check に合格したページでも空白がレンダリングされることがあります。
  6. レンダリング — pulupulu render . --format mp4 --fps 30。停止、黒フレーム、長さの不一致については: references/render-traps.md。
  7. 明示的なストリームマッピングでミックスと多重化 — scripts/deliver_check.py --video out/film-vN.mp4 --audio assets/mix.wav --out out/final.mp4 で多重化と検証を1回の呼び出しで実行。手動レシピとダッキングチェーン: references/workflow.md。
  8. 配信するファイルを検証(レンダラーの最新出力ではなく): python scripts/deliver_check.py out/film.mp4 --timeline timeline.json。
  9. 正直な注意事項とともに配信:何が描画され何がソースされたか、QAノートの内容。

3. ゲート

以下のものだけがブロックします。それ以外のツールが出力するものはすべて読み取り用ノートです。議論で答えるか修正してください。しかし、合格していないものを合格として報告しないでください。

ゲートコマンド証明すること失敗した場合
preflightpython scripts/doctor.pyマシンがレンダリング可能停止、不足しているものを報告
compositionpulupulu check .ページ契約、不足ファイルなしレンダリング前に修正
languagepython scripts/lang-audit.py film/index.html --lang en他言語のテキストなし、<script>内の文字列リテラルも含むリテラルを翻訳、再実行
speechpython scripts/deepseek_voice.py gate beats.json --voice stellaすべてのフレーズが自身の単語に書き起こされるフレーズを書き直す。断片を絶対に出荷しない
filepython scripts/deliver_check.py out/film.mp4 --timeline timeline.json(または先に多重化する場合は--video/--audio/--out)フレームサイズ、フレームレート、オーディオの存在と十分な長さ、True Peak、配信サイズ再多重化または再エンコード
popspulupulu qa out/film.mp4no single-frame pops1フレームの要素を見つける

pulupulu qa は、1秒あたりのモーション、still for ≥ 1 s、flat opening も報告します。これらはペーシングに関する判断であり、96×54のグレースケール比較で測定されるため、低コントラストのゆっくりした動きは静止と読み取られる可能性があります。これらは確認する理由として使い、従うべき判定として使わないでください。

どのゲートも証明しないこと: 映画が良いこと、ASRが正しい数字を聞いたこと(数字と固有名詞をトークンとして確認)、キャプションがプラットフォームのUIに隠されない位置にあること。

4. レンダリングを台無しにするトラップ

詳細と修正は references/render-traps.md にあります。レンダリングを完全に停止させるもの:

  • <div>内に生の<g>/<rect>/<path>を記述すると何もレンダリングされず警告もなし。すべてのシーンフラグメントを独自の<svg viewBox>でラップすること。
  • インラインSVG <text>内のウェブフォントは、そのレイヤーを毎フレーム再ラスタライズします。テキストはHTMLに配置するか、シェイプとして描画してください。
  • feTurbulenceをフレームごとのフィルターとして使用すると(インラインSVGまたはCSS背景)、レンダラーが停止します。ノイズを一度PNGタイルに焼き付けてください。
  • インラインSVGに対する全フレームのGSAP スケールはプレートを再ラスタライズします。translateは問題なく合成され、ビットマップレイヤーはスケール可能です。プッシュが不可能な場合、小さな内部グループをアニメーションさせてください。
  • repeat: -1 はタイムラインを無限にします。87秒の映画が静かに117秒になります。有限のラップ数を計算してください。
  • レンダリング失敗後、残されたヘッドレスChromeのみを強制終了してください。taskkill //IM chrome.exe はユーザーのブラウザを閉じてしまいます。

5. 詳細の所在

作業内容ページ
コマンド、ページ契約、インストールreferences/cli.md
9つのステップ、プロジェクト契約、多重化references/workflow.md
ストーリーボード、キャプション、単一言語ゲートreferences/narration-and-captions.md
パレット、要素予算、個性、リズムreferences/design-taste.md
モーション言語、テクニック、3Dレイヤーreferences/motion-library.md
パンチアップ、プロダクトデモ、トーキングヘッド、文法references/workflows-specialized.md
音楽の世界、作曲家、効果音、ナレーション合成references/audio-and-music.md、references/narration/deepseek-tts.md
空白、停止、長さ違いのレンダリングreferences/render-traps.md
チェックすべき内容とその順序references/verification.md
スタイルレシピ、カメラ言語references/art-motion/INDEX.md
アイコンとベクターの調達、ライセンスreferences/asset-sourcing.md
画像モデルで生成されたアート、印刷のトリミング、マウントreferences/generated-assets.md
フラットベクターのクラフト、スクロールワールドreferences/2d-vector-motion.md
このレンダラーが扱える主題references/topic-fit.md
サブ秒レベルのタイミングとイージングreferences/ui-motion/
このスキルの公開(1コミット、v1.0)references/publishing-skills.md、references/publishing.md

スタイルレシピルート(scripts/art-motion/engine/)は、20MBのベンダーランタイムであり、意図的にこのリポジトリには含まれていません。スキルはエージェントが使わないかもしれないエンジンを毎回フェッチさせるべきではなく、37MBのツリーはレビューできません。これはピン留めされチェックサム検証された状態で、上記のページが参照する正確なパスにインストールされます。

python scripts/install_art_motion.py --check                   # 存在するか?
python scripts/install_art_motion.py                           # コア: lib + demos + scenes、20MB
python scripts/install_art_motion.py --with-reference-films    # + 学習教材、さらに14MB

その他すべて — Pythonゲート、クリップ仕様、ドキュメント — はリポジトリ内にあり、インストールは不要です。フェッチしたツリーをコミットしないでください。.gitignore はすでに対応しています。

6. スクリプト

スクリプト機能
scripts/doctor.py事前チェック、読み取り専用
scripts/deepseek_voice.pyprobe · speak · cost · lay · beats · asr · gate — ナレーションとその計測タイムライン
scripts/deliver_check.py配信ファイルの検証: サイズ、レート、オーディオ、ピーク、タイムラインに対する持続時間
scripts/lang-audit.pyマークアップとスクリプトリテラルに対する単一言語ゲート
scripts/art-motion/icon_audit.pyアイコンファミリー、色数、コンタクトシート
scripts/art-motion/qa.pyレンダリングファイルに対するペーシングとポップのヒューリスティック
scripts/stamp_credit.pyテキストファイルにby Alucard0x1行を追加

7. 人との協働

形容詞ではなくフレームを見せてください。アクトごとに1つのヒーローフレームを示すことで、無駄な作業を1週間防げます。相手が修正を加えた場合は、チャットの返信ではなく、このスキルにその修正を反映させてください。

引き継ぎ:ナレーションのタイミングと韻律 → スキル tts-intonation · 他のライブラリのマージまたは翻訳 → スキル agent-skill-sourcing · 公開前の権利と肖像 → スキル media-content-safety · 参照動画の調達 → スキル streaming-mirror-extraction · 3Dまたはフッテージベースのショット → スキル headless-three-video-render および cinetic · タイプファーストの映画 → スキル kinetic-typography。

関連スキル