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ショット。タイミングは計測された発話に基づき、創作ではありません。
- ブリーフィング. 主題、対象者、プラットフォーム、言語、ナレーションの有無。不足している主題については質問してください。動画が依頼された場合にナレーションをするかどうかは質問しないでください。
- HTMLの前にストーリーボード —
references/narration-and-captions.md。キャプションは逐語的な発話であり、その要約ではありません。 - ナレーションと計測.
python scripts/deepseek_voice.py beats beats.json film/assets/voice.wav --voice stella --timeline timeline.json、次にgateでASRによる各フレーズの確認。ルート、音声、制限についてはreferences/narration/deepseek-tts.mdを参照。 timeline.jsonからページを構築。ストーリーボードからではありません。契約:references/cli.md。ストーリーにアイコンライブラリにないオブジェクトが必要な場合、まず印刷パネルとして生成してください —references/generated-assets.md— それらを組み立ててください。写真の代用を手描きしないでください。- チェックしてから確認する.
pulupulu check .、次にpulupulu still . --at 2,12,24 --out .om/stillsでスチルを開く。checkに合格したページでも空白がレンダリングされることがあります。 - レンダリング —
pulupulu render . --format mp4 --fps 30。停止、黒フレーム、長さの不一致については:references/render-traps.md。 - 明示的なストリームマッピングでミックスと多重化 —
scripts/deliver_check.py --video out/film-vN.mp4 --audio assets/mix.wav --out out/final.mp4で多重化と検証を1回の呼び出しで実行。手動レシピとダッキングチェーン:references/workflow.md。 - 配信するファイルを検証(レンダラーの最新出力ではなく):
python scripts/deliver_check.py out/film.mp4 --timeline timeline.json。 - 正直な注意事項とともに配信:何が描画され何がソースされたか、QAノートの内容。
3. ゲート
以下のものだけがブロックします。それ以外のツールが出力するものはすべて読み取り用ノートです。議論で答えるか修正してください。しかし、合格していないものを合格として報告しないでください。
| ゲート | コマンド | 証明すること | 失敗した場合 |
|---|---|---|---|
| preflight | python scripts/doctor.py | マシンがレンダリング可能 | 停止、不足しているものを報告 |
| composition | pulupulu check . | ページ契約、不足ファイルなし | レンダリング前に修正 |
| language | python scripts/lang-audit.py film/index.html --lang en | 他言語のテキストなし、<script>内の文字列リテラルも含む | リテラルを翻訳、再実行 |
| speech | python scripts/deepseek_voice.py gate beats.json --voice stella | すべてのフレーズが自身の単語に書き起こされる | フレーズを書き直す。断片を絶対に出荷しない |
| file | python scripts/deliver_check.py out/film.mp4 --timeline timeline.json(または先に多重化する場合は--video/--audio/--out) | フレームサイズ、フレームレート、オーディオの存在と十分な長さ、True Peak、配信サイズ | 再多重化または再エンコード |
| pops | pulupulu qa out/film.mp4 | no single-frame pops | 1フレームの要素を見つける |
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.py | probe · 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。