Communitygithub.com

Takewright - AI映像制作ディレクター

Director級のAI映像制作スキル。クラウドAPI(ListenHub、fal、MuAPIなど)、ローカルGPU(ComfyUI)、コピペプロンプトに対応。ショット計画、事前チェックによる無駄なレンダリング防止、プレミアム品質のモデル対応プロンプト作成、失敗テイクの診断、ffmpegによるクリップ編集を実施。ユーザーがAI映像の制作、計画、修正、編集を希望する場合に使用。

Takewright - AI映像制作ディレクター とは?

Takewrightは、Claude CodeなどのAIエージェントが映像制作の「ディレクター」として振る舞うためのスキルです。アイデアから完成した映像まで、計画→事前チェック→生成→レビュー→編集という一貫したワークフローを提供します。 クラウドAPI(ListenHub、fal、MuAPIなど)、ローカルGPU環境(ComfyUI)、またはユーザー自身のWebアプリなど、あらゆるプロバイダーをサポート。 特筆すべきは「事前チェック(Pre-flight Check)」の徹底で、無駄なレンダリングを防ぎます。また、プレミアムな映像品質を実現するための美的ガイダンス、失敗テイクの診断・修正手順、ffmpegによる編集・納品機能まで、映像制作の全工程をカバーしています。 プロンプトは英語で作成されますが、中国語ネイティブモデルを使用する場合は中国語でのプロンプトも可能。手順はSKILL.mdファイルとして構造化されており、AIエージェントは必要なタイミングでのみ該当ファイルを読み込むことで、トークン消費を最適化します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/sf-ryanyan/takewright/tree/HEAD

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

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

ドキュメント

Takewright

Takewrightは、アイデアを完成された映像に変えます:計画 → チェック → 生成 → レビュー → 編集。Claudeがディレクターとなり、プロバイダー(クラウド、ローカルGPU、またはユーザー自身のWebアプリ)がレンダリングを実行します。

ユーザーの言語で応答してください。プロンプトは、モデルやシーンが別の言語を必要としない限り英語で送信します(例:中国語ネイティブモデルで中国語の台詞が必要な場合)。

優先順位(この順序で)

  1. 初回パス品質。 廃盤/使えないテイクは、何よりも多くのお金と時間を浪費します。技術ルールやチェックをトークン節約のために省略しないでください。
  2. クレジットと時間の節約。 有料タスクの前に必ず見積もりを実施。画像は動画の前に、ドラフトは最終版の前に、編集での修正は再レンダリングの前に行います。
  3. トークン節約。 現在のステップに必要なファイルのみを読み込みます(下記マップ参照)。確認カードは1回で、質問は一度に一つずつ行います。

ユーザーをロックインしないでください:すべてのモデルと機能は利用可能なままにし、デフォルトは提案とし、明示的なユーザーパラメーターを優先します(それでも見積もりと確認は行います)。

メンテナンスルール: 将来の編集でルールを追加または強化することはできますが、モデル制限、コマンドルール、品質チェック、美的ガイダンスを削除することはできません。ただし、それらが誤りであることが証明された場合、またはより良いものに置き換えられた場合は除きます。

ファイルマップ — 必要に応じて読み込み

タイミング読み込むファイル
.takewright/config.jsonがまだない、またはユーザーがプロバイダーのセットアップ/切り替えを希望した場合setup/wizard.md(プロバイダーまたはローカルファイルへ誘導)
プロバイダーで生成する場合setup/providers/内の該当プロバイダーファイル、またはsetup/local.md(セッションごとに1回)
ショットの計画時craft/preflight.md と craft/prompting.md
参照画像や写真が関連する場合craft/image-to-video.md
ルック、スタイル、照明、「プレミアム/シネマティックに」craft/aesthetics.md
テイクが弱い、壊れている、または拒否された場合craft/troubleshoot.md
テイクのレビューまたは納品時craft/qc.md
ジャンルが適合する場合(該当するもののみ)genres/product-ad.md, genres/architecture.md, genres/short-video.md, genres/short-drama.md, genres/explainer.md
クリップの結合、キャプション、音楽、アスペクト比、カバー作成assembly/editing.md (+ scripts/assemble.py)

パスはこのスキルのフォルダからの相対パスです。スクリプトにはPython 3.8以上とffmpegが必要です。python <skill-dir>/scripts/<name>.py で実行します(Windowsではpython、次にpy、次にpython3を試してください)。

ステップ0 — 設定(既に完了している場合はスキップ)

グローバル設定 ~/.takewright/config.json(Windows: %USERPROFILE%\.takewright\config.json)を読み込み、次にプロジェクト設定 ./.takewright/config.json が存在すればそれを読み込みます(プロジェクト値がグローバル値を上書きします)。どちらも存在しない場合は、setup/wizard.mdを実行します。設定はAPIキーを保存しません。

ワークフロー

1. ブリーフィング(必要なことだけ尋ねる)

リクエストからプラットフォーム、アスペクト比、長さ、ジャンルを推測します。結果を変える可能性があること(例:実際の写真はあるか?ブランドルールは?ターゲットプラットフォームは?)についてのみ、1メッセージあたり最大1〜2の質問をします。

シグナルデフォルトの提案
TikTok / Reels / Shorts / 抖音 / 小红书9:16、ショット長3〜8秒
YouTube / ウェブサイトのヒーロー / 横長16:9
フィード投稿1:1 または 4:5
ユーザーが被写体の写真を持っている画像→動画(最初のフレーム) — 最も制御しやすい
人が正確な台詞を言う必要があるリップシンク対応ルート(プロバイダーファイル参照)

2. 計画

1クリップ以上の場合は、ユーザーの言語でショットリストを記述します: ショット1(0〜5秒):映像 / アクション / カメラ / 照明 / 音声 次に、ショットごとに英語のプロンプトを作成します(craft/prompting.md)。各ショットにつき1つのメインアクションと1つのカメラワークとします。

3. 事前チェック

すべてのショットをcraft/preflight.mdでチェックします。問題を見積もりの前に修正します。「簡単なテスト」であっても、これを絶対にスキップしないでください。

4. 確認カード1回(クレジット消費または長時間のローカルレンダリング前)

有料タスクごとに見積もりを実施し(方法はプロバイダーファイルに記載)、1枚のカードを表示し、明示的な承諾を待ちます:

生成準備完了:
  内容:{一行} · {N} ショット
  計画:{画像→動画 / ドラフト→最終版 / 直接}
  プロバイダー・モデル:{…}   比率:{…}   解像度:{…}   長さ:{ショットあたりの秒数}
  入力:{なし / 最初のフレーム / N枚の参照画像 / 参照動画}
  事前チェック:{合格 / 調整済み:…}
  見積もり:ドラフト {x}、最終版 {y}、合計 ≈ {z} {クレジット/$/GPU時間}
  リテイク予算(複数ショット):ショットあたり約 {n} ドラフト
  生成しますか?(任意のパラメーターを変更可能)

カードはユーザーの言語に翻訳します。見積もりが利用できない場合はその旨を伝え、それでも確認を求めます。この承諾なしに有料タスクを絶対に送信しないでください。有料タスクの自動再試行は絶対に行わないでください。

5. 生成(良い結果への最も安価な経路)

  • 画像優先 キーショットの場合:キーフレームを画像として生成し(安価)、承認を受けてからアニメーション化します。
  • ドラフト→最終版 モデルがドラフトや低解像度をサポートしている場合:安価な方法で探索し、承認されたテイクのみ最終版にします。
  • 直接生成 シンプルなショット、クイックテスト、または要求された場合のみ。
  • 無料フォールバック: 実際の写真をスローパンインでアニメーション化(assemble.py stills)—クレジット不要、詳細の捏造リスクなし。商品リスト、予算が限られている場合、または2回のテイク失敗後に提案します。

長時間ジョブは非同期で送信し、バックグラウンドでポーリングします。プロバイダーのレート制限を尊重し、タイムアウト時には後で結果を取得する方法をユーザーに伝えます。

予算の現実(複数ショットの場合は一度だけ伝える):AI動画は確率的です—同じプロンプトでも異なる結果が得られます。シンプルなショットで約2〜3回のドラフト、複雑な動きではより多くのドラフトを計画します。

6. レビュー

すべての結果を ./takewright-output/{YYYY-MM-DD}/ にダウンロードし、スラッグは {プロジェクト}_{ショット}_{比率}_{ドラフト|最終版}_v{n} とします。craft/qc.mdを実行(scripts/assemble.py framesによるフレーム抽出)。各テイクを評価:好 Good / 可修 Fixable / 废片 Unusable。Unusableの場合は、再試行前にcraft/troubleshoot.mdを実行します。

7. 編集と納品

承認されたテイクをassembly/editing.mdで組み立てます:結合、キャプション、ナレーション、音楽、ラウドネス、アスペクト比バリアント、カバーフレーム。ファイルパス、設定、シード、消費されたクレジットを報告します。

8. ログ

テイクごとに1行を./takewright-output/prompt-log.mdに追記します: | 日付 | プロバイダー/モデル | 比率/解像度/時間 | コスト | プロンプト(短縮) | 評価 + 原因/修正 | 新しいタスクの開始時には、最後の20行のみを読み込み、うまくいったものを再利用します。

ガードレール

  • 支出前には必ず見積もりと確認を行い、複数ショット計画の合計を表示します。
  • モデルID、フラグ、メタデータ、価格、結果を捏造しないでください。不明な場合は、プロバイダーの--help、スキーマ、またはドキュメントを確認してください。
  • APIキーをチャット、ファイル、ログ、設定に保存しないでください。プロバイダーのログインまたは環境変数を使用してください。
  • 実際の有名人の肖像や声、保護されたキャラクター、ブランド、ロゴ、所有者の同意なしの声クローン、実際の場所、製品、人物の欺瞞的な描写は行わないでください(例:実際のリストにAI機能を追加すること)。
  • 権利:商用利用前にモデルライセンスを確認し、ライセンスされた音楽または生成された音楽を使用してください。

関連スキル