Communitygithub.com

リビングペインティング

額縁に入った絵画にカメラが近づき、描かれた情景が動き出し、必要に応じてカメラが後退する動画を作成します。リビングペインティングシリーズおよび後続のPaintingsシリーズ動画に使用します。一般的な動画や単独の画像編集には使用しないでください。

リビングペインティング とは?

このスキルは、絵画をテーマにしたアニメーション動画のビジュアルデザインと合成のためのものです。インストール済みの `comfy-film` コントローラを使用して、生成、レビュー、リカバリ、最終納品を行います。このコントローラは Codex、DeepSeek Harness、Claude Code の各エージェントで共通であり、すべて同じ `film.py` スクリプトを駆動します。環境によってツールの違い(例:Codex のブラウザパネルの代わりに `progress.py` のバックグラウンドジョブを使用するなど)がありますが、基本的なワークフローは統一されています。プロジェクトは `$Paintings/<英語名>` の下に管理され、開始時には `film status` で状態を確認し、新規作成時には `workflow.md` を参照することが推奨されます。カメラの動きとアートワークのアニメーションは独立して制御され、特に「絵画に入る」ような動きではなく、固定された視点からの小さな動きを描写する短いプロンプトを使用します。また、 join 部分での輝度段差を避けるために測定とディゾルブ処理を行い、最終成果物は H.264/AAC 形式で提供します。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/avalner/comfy-film-kit/tree/HEAD/skills/living-paintings

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

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

ドキュメント

リビングペインティング は何をしますか?

このスキルは、絵画動画のビジュアルデザインと合成に使用します。インストール済みの comfy-film コントローラを使用して、生成、レビュー、リカバリ、最終納品を行います。これはすべてのエージェントで同じコントローラです — Codex (~/.codex/skills/comfy-film/SKILL.md)、DeepSeek Harness (~/.dsh/skills/comfy-film-dsh/SKILL.md)、Claude Code (~/.claude/skills/comfy-film-dsh/SKILL.md) — すべて同じ $Tools/comfy-film/scripts/film.py を駆動します。周辺ツールだけが異なります。必要に応じて関連するリファレンスを読んでください。このコントローラを再作成しないでください。本格的な H3 プロンプトには h3-prompt-writing を使用します。

ハーネスの違い (Codex → DeepSeek Harness / Claude Code)

Codex の習慣代わりに行うこと
進捗ページ用の Codex ブラウザパネルprogress.py --serve をバックグラウンドジョブとして起動し、.pipeline/progress-server.json から確認済みの URL を投稿する
accept/change/reject 用のメニューツール2 単語のラベルで ask_user_question を使用。リンクと番号はその上のメッセージに含める
チャット内でレンダリングされる画像画像/ドキュメントには山括弧で囲んだパスリンク、クリップごとに http://127.0.0.1:8199/watch/... (サーバー: comfy-film-dsh/scripts/serve-media.py)
サブエージェントに委任されるドラフト作成親エージェントでドラフトを作成。DSH にはこれらのフィルムに対するドラフト作成委任はない
最終処理comfy-film-dsh/scripts/finalize_delivery.py --input ... --no-upscale

公開、レビュー、モンタージュのルールは変更されません。これらは comfy-film スキルにあります。

開始または再開

  • プロジェクトは $Paintings/<英語名> の下に保管します。元のアートワーク、ルームリファレンス、プロンプト、生成されたテイク、モンタージュクリップ、最終書き出しはすべてそのプロジェクト内に保存します。クリップボード/テンポラリファイルや別のプロジェクトの出力フォルダへの依存は避けてください。
  • 再開時には film status --project PROJECT を実行し、現在の brief.md を読んでください。技術的な状態は film.json にあります。承認はファイルの存在から推測しないでください。
  • 新しい絵画の場合は、キーフレームの設計や動画生成の前に workflow.md を読んでください。そこにはテスト済みのレシピと Living Cafe Painting での具体的な失敗例が含まれています。
  • ユーザーから提供されたフォーマット、タイミング、サウンド、カメラの選択を再利用します。以前のフィルムの 5 秒アプローチ + 10 秒アニメーション + 5 秒リトリートはあくまで一例であり、すべての絵画に自動的に適用するものではありません。

部屋の動きとアートワークのアニメーションを分離する

  1. 額縁に入った絵画が正面を向いており、意図したアプローチのために十分な周囲スペースがあるルームリファレンスをデザインします。元の高解像度アートワークは別のソースとして保持します。
  2. ユーザーがアプローチ中にアートワークを静止させたい場合、その元のアートワークをフレームに合成し、決定論的に均一な平面クロップ/スケールをアニメーション化します。H3 に部屋から街への移動を発明させることはしないでください。テスト済みプロジェクトでは内部遠近法が変更されました。ルーム画像内の小さな埋め込まれた絵画を拡大しないでください。ぼやけます。
  3. アプローチの最終フレームがアートワークの内部に完全に収まるようにレンダリングします。最もタイトなクロップに対して元のアートワークに十分なピクセルがあることを確認します。高解像度のルームキャンバスは合成精度に役立ちますが、アートワークの詳細を追加するものではありません。最終出力サンプリングまで元のソースのピクセルを保持します。
  4. リビングシーンは実際に承認されたアプローチのエンドポイントから開始します。これは意図的に静止ポーズからの新しいアクションです。動くガイドとしてルーム/アプローチを持ち越すのではなく、その静止画で I2VA を使用します。comfy-film のデフォルトのガイドは、すでに動いているアクションを続ける場合に適切であり、このトランジションには適していません。
  5. 固定された街/風景の視点と、描かれたシーン内の小さな動きを説明する短い肯定プロンプトを使用します。絵画に出入りすることを説明しないでください。workflow.md にある成功したプロンプトパターンを参照してください。
  6. 静止アートワークリトリートの場合、承認されたリビングシーンの実際に選択された最終フレームをフリーズし、高解像度ルーム/アートワーク合成に登録し、逆の平面クロップ/スケールをアニメーション化します。結合部で元のアートワークの以前のキャラクターポーズにリセットしないでください。エッジの位置合わせの継ぎ目を検査し、適切な場合にのみ控えめなフェザリングを使用します。

カメラの動きと描写された動きは独立して制御可能に保ちます。ユーザーが遠近法の変更を望む場合は、生成的なカメラ移動を使用しても構いません。フラットアートワーク方式は静止アートワークのコンセプトに適用されます。

リビングテイクへの結合部分は、目がジャンプを捉える箇所です

H3 はその conditioning スチルをコピーしません。最初のフレームを再レンダリングしますが、これはより平坦で、輝度が数段暗く、空が描き直されて出力されます。鮮明な合成アプローチフレームと比較すると、スケールとオフセットが完全に一致していても、カット部分で輝度ステップとして読み取られます。Living Tulip Balloons では、カットはフィルム全体で最大の単一フレーム輝度ステップ (-2.04) を引き起こしましたが、結合部分は 0 シフト、1.000 スケールと測定されました。

推測せずに測定します。組み立てられたカットを一度デコードし、フレームごとの平均輝度を出力します。結合部分がフィルム内で最大のステップであってはなりません。そうである場合は、テイクの最初の 12 フレームを、アプローチの実際の最終フレームから開始してテイク自身のフレームに収束する決定論的なディゾルブ (重み k/12) で置き換えます。タイミングの変更はなく、発明もなく、テイクの最初に表示されるフレームはカメラが停止したまさにその画像です。レシピと数値は workflow.md を参照してください。

レビューと仕上げ

  • comfy-film のフレーム、クリップ、最終レビューゲートに従います。承認されたソースの決定論的フィッティングとエンドポイント抽出は、そのソースの承認を継承します。新しい生成ルームやアートワークの描き直しには、独自のレビューが必要です。
  • アニメーション候補を表示する前に、その全タイムラインを検査し、前景の手、開くパネル/ウィンドウ、不要なカメラ移動、レイアウトのずれ、キャラクターアーティファクト、詳細の損失がないことを確認します。デコードの成功だけでは視覚的な承認にはなりません。失敗した場合はそれを開示し、comfy-film の許可されたリトライルールに従います。
  • 結合には実際のトリミングされたエンドポイントを使用します。H3 は時間を丸めます。選択した計画に合わせるために必要な超過フレームのみを削除します。承認されたソースクリップとバージョンを保持します。
  • 音楽が提供された場合、可能な限りビデオは変更せず、新しい最終バージョンを保存します。最初のフィルムのミックスを盲目的に再利用するのではなく、提供されたトラックに合わせて音楽/アンビエンスのバランスとフェードを設定します。
  • 最終的なアップスケールはオプションです。明示的に要求されない限り finalize_delivery.py --no-upscale を使用します。H.264 yuv420p/AAC を faststart で生成し、デコードを確認します。クリック可能なローカル MP4 リンクを提供します。インラインビデオだけでは、テストされたチャットではユーザーに見えませんでした。
  • 選択されたジオメトリ、ソースバージョン、プロンプト、承認されたテイク、トリム、ミックス、最終レビューステータスを brief.md に保存します。将来の決定を変更する場合にのみ、新しい再利用可能なレッスンをここに記録します。1回限りの座標はプロジェクトに保持します。

既存の例

$Paintings/Living Cafe Painting がテスト済みの例です。その brief.md には決定事項と破棄されたバリアントが保存されています。clips/ には承認されたセグメントが含まれています。.pipeline/drafts/prompts/part2-v4.txt は成功したリビングシーンのプロンプトです。最終 v2 にはユーザーの音楽が含まれており、まだ最終フィルムの明示的な承認を待っています。これらの事実は将来のフィルムを承認したり、公開を許可したりするものではありません。

関連スキル