feitangyuan/onetake

onetake – ワンコンティニュアステイクのモーション ビデオ スキル

それは何か

• Claude（または他の LLM）エージェント スキル で、AI に 単一の、カットなしのテイク で短い製品ローンチまたはデモ動画を作成するよう依頼できます。このスキルは、スクリーン レコーディングではなく、説明からアニメーション全体を構築します。

なぜ重要なのか

• ほとんどの AI 生成モーション ビデオは、一連の断片的なクリップ（タイトル カード → フェード → UI ショット → フェード …）であり、スライドショーのように感じられます。onetake はこの問題を逆転させます。ビート間のすべての 境界 は、画面上の何かが生き残り、次のビートに変形する ように設計されています。この「キャリー」は自動的に測定され、曖昧な美的判断ではなく、定量的な連続性スコアが得られます。

主要な技術的アイデア

機能	仕組み（リポジトリの説明による）
UI 再構築	スクリーンショットは、製品 UI の HTML レプリカ に変換され、カメラの平面に配置されるため、仮想カメラは任意のズームで飛び込むことができます – スクリーン レコーディングは不要です。
モーション ライブラリ	約 38 の純関数モーション プリミティブ（スプリング、エントランス、衝突、流体グラウンド、カメラ移動）。それぞれが測定された速度曲線を持つ時間ベースの関数であり、アニメーションは決定的で再現可能です。
モーション ブラー	レンダリングされた各フレームは、開いた 180° シャッターでシーンを複数回サンプリングし、線形光で結果を平均化して、高速移動に対してリアルなブラーを生成します。
オーディオ統合	フォーリーと合成サウンドは、視覚イベントと同じ仮想ルームに配置されます。ヒットが発生すると、音楽は自動的にダッキングされます。
連続性オラクル	probe.py は各フレームのオブジェクトを記録し、境界を見つけ、オブジェクトが「キャリーオーバー」するかどうかをチェックします。映画は キャリー スコア（0-1）を取得します。しきい値を超えるスコアのみが自動チェックに合格します。
決定的レンダリング	同じシード → 任意のタイムスタンプで同一のフレーム。ドラフトは 1080p 30 fps、最終レンダリングは 4K 60 fps。

典型的なワークフロー

1. リファレンス分析 – リファレンス ビデオを数値（静止時間、カット ポイント、イージング曲線）に分解します。
2. コンセプト ブレインストーミング – 1 文のビジュアル コンセプトをいくつか生成します（例：「1 つのドットがすべてになる」）。
3. ビート シート – ビートの長さを定義し（≥ 4× の変化）、各境界で生き残るオブジェクトを明示的に指定します。
4. コンポーズとレンダリング – モーション ライブラリを使用して単一の HTML ファイルを作成し、モーション ブラーでレンダリングし、スクリプトでサウンドを追加します。
5. 検証 – 連続性オラクルを実行します。合格したら、人間が確認できるフィルムを表示します。

インストールと使用法

# Claude エージェントの場合
 git clone https://github.com/feitangyuan/onetake.git ~/.claude/skills/onetake
# スキルを読み取る他のエージェントの場合
 git clone https://github.com/feitangyuan/onetake.git ~/.agents/skills/onetake

クローン後、エージェントに依頼できます：

• 「私のアプリの 15 秒のローンチ ビデオを作って。」
• 「これらのスクリーンショットから機能デモを作成して、スクリーン レコーディングなしで。」
• 「私のモーション ビデオがスライドショーのように感じられる – 修正して。」

依存関係 – Python 3（playwright + Chromium、numpy、scipy、Pillow、matplotlib、リファレンス分析用のオプションの opencv-python）、ffmpeg、Node.js、およびナレーション用の faster-whisper と Kokoro TTS。

ライセンス – PolyForm 非商用 1.0.0（個人、教育、研究目的で無料）。商用利用には有料の「onetake Pro」ライセンスが必要で、生成された各フィルムの完全なソースも提供されます。

---

結論：onetake は、シームレスでワンテイクのモーション ビデオの作成を自動化する専門的な AI エージェント スキルであり、測定可能なオラクルと物理に着想を得たモーション プリミティブのライブラリを通じて連続性を強制します。これは、AI 生成コンテンツ / LLM エージェント ツールの領域に正確に位置付けられます。