Communitygithub.com

hongxiang01/video-forge

成片工坊の総合エントリーポイント。画風動画、音楽MV、解説アニメ、3Dミニチュアシーンを一元的に管理。詳細を徹底的にヒアリングし、確認を得てから制作し、独立した審査エージェントによる評価を経て、最終的に~/video-forgeにアーカイブする。

video-forge とは?

成片工坊(video-forge)は、AIエージェント向けに設計された高度に構造化された動画制作スキルです。単一のプロンプトから動画を生成するのではなく、以下の3つの原則に基づいています。(1) 曖昧な要件を排除するまで詳細を徹底的にヒアリング(シーン、人物、感情、構造、音響、禁止事項など)、(2) 画風や設定、絵コンテなど、各工程で必ずユーザーの承認を得てから次の工程に進む、(3) 制作後は独立したサブエージェント(審査員)がユーザー確認済みの評価基準カードに基づいて採点し、その結果を元に反復的に改善する。このスキルは、Claude CodeなどのAIエージェント上で動作し、画風動画、音楽MV、解説アニメ、3Dミニチュアシーンの4つの制作パイプラインを統括します。各パイプラインは詳細なリファレンスファイル(`references/`配下)によって定義され、工程ごとに質問リスト、テンプレート、評価基準、トラブルシューティングガイドが用意されています。最終的な成果物は`~/video-forge/works/`にアーカイブされ、公開後の視聴維持率などのパフォーマンスデータも収集・分析することで、未来の制作にフィードバックします。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hongxiang01/video-forge/tree/HEAD/skill

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

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

ドキュメント

成片工坊(video-forge)

良い作品は一言で生成されるものではありません。このスキルは以下の3つのことを管理します:

  1. 明確にするまで問い詰める:要件が曖昧なら、シーン、人物、感情、細部の隅々まで具体的な画面に落ちるまで問い続けます。
  2. 確認してから、制作する:画風、設定、絵コンテは、すべてユーザーの承認を得てから、時間のかかる制作に入ります。
  3. 他人に審査させる:完成作品は独立した審査員に渡し、ユーザーが確認した「審査基準カード」に基づいて項目ごとに判定させます。自己チェックで審査を代替することはしません。

制作自体は既存のパイプライン(lemo-opuscar、mv-director、Remotion、three.js ミニチュア)に任せ、このスキルはディレクター兼ゲートキーパーの役割を担います。

絶対ルール

  1. 一言で着工させない。質問リスト(references/interview-checklist.md)の必須項目がすべて埋まるまで、制作工程に入りません。ユーザーが「任せる」と言った場合でも、具体的なデフォルト値を需要カードに書き込み、ユーザーに表示します。
  2. 曖昧な言葉は画面に置き換える:「温かい」「高級」「感じがいい」は回答と見なしません。2~4つの具体的な画面オプションを提示し、ユーザーに選ばせます。
  3. 毎回の質問の後に需要カードを貼る(references/card-templates.md)。ユーザーが決定済みと未決定を一目で把握できるようにします。
  4. 工程の順序は飛ばせない:需要カード + 審査基準カード → 画風(サンプル映像)→ スタイルカード/スタイルフレーム → 設定カード → 絵コンテ連絡表 → ラフ → 審査員ループ → アーカイブ。パイプラインが特定の工程をスキップできると宣言している場合(例:ミニチュアには絵コンテがない)は、その旨を明記します。
  5. 絵コンテはデフォルトで確認を取る(lemoはデフォルトで確認を取らないため、ここではデフォルトで確認を取るように変更します)。
  6. 審査員は独立したサブエージェントであり、作品とユーザーが確認した審査基準カードのみを与え、私の結論は渡しません。審査員は全編を視聴し(2秒ごとに1フレーム抽出)、音声の測定のみ行い、良し悪しは評価しません。ユーザーの意見は審査員より優先されます。
  7. 人物は演技をさせない:コードで描かれた表情や手の動きは必ず不自然になります。パイプラインにキャラクターリギング機能がない限り、人物は小さく、遠く、静止、または単純なループ動作に限定します。
  8. ユーザーの発言はそのままカードに記載する:ユーザーが言及した具体的な要件(例:「ライトでつぶさないで」)は、原文のまま需要カードの禁止事項やハード要件に書き込みます。
  9. 大規模タスクは役割ごとに複数のエージェントに分割する(references/division-of-labor.md):まず骨格ファイルを決定し、各役割は番号のみを参照し、算術計算はスクリプトで検証します;思考強度を下げてタイムアウトを回避しようとはしません。
  10. 作品は ~/video-forge にアーカイブする。一時ディレクトリには置きません。一時ディレクトリは再起動で消失します。
  11. ネットワーク:このマシンのプロキシは非常に遅いです。大規模ダウンロードは curl --noproxy '*'、env -u http_proxy -u https_proxy -u HTTP_PROXY -u HTTPS_PROXY を使用してバイパスします;シェル内で grep が壊れている場合は /usr/bin/grep を使用します。

手順

0. 振り分け

まず ~/video-forge/recipes/ を確認します:ユーザーが明示的に指定した方法(「Toon-shadedなミニチュア方式で駅を作って」)があれば、その方法ファイルを読み込み、その方法で未定の項目だけを質問します。

それ以外の場合は、需要に応じてパイプラインを選択します:

需要パイプラインファイル
特定の画風のショートフィルム(30~90秒)、テーマ自由画風動画references/pipeline-style-film.md
曲にMVを作るMVreferences/pipeline-mv.md
何か一つのこと、歴史、データを説明する解説references/pipeline-explainer.md
ドラッグ&回転可能な3Dミニチュアシーンミニチュアreferences/pipeline-diorama.md

ユーザーが何も考えていない場合:references/style-picker.md の初心者ガイドを実行します(まずサンプル映像を見せ、次にコンテンツのアイデアを提案します)。

1. 質問 → 需要カード

まず動画タイプと尺枠を決定し、references/genres/ 内の対応するタイプカードを読み込みます(カード選択表は genres/README.md を参照)。以降の質問、構成、文字数予算、審査基準カードは、すべてこのカードを起点にします。

references/interview-checklist.md に従って、ラウンドごとに質問します。AskUserQuestion を使用し、各ラウンドは最大4問とし、選択肢は具体的な画面にします。各ラウンドの後に需要カードを貼ります。必須項目が揃ったら、ユーザーに需要カードを確認させます。

2. 画風

ユーザーが選択していない場合:references/style-picker.md に従って2~3つを推奨し、サンプル映像リンクを添付します。同時に全66種類のリストも提示します(テキストのみの質問で、AskUserQuestion は使用しません。選択肢が少なすぎるとリストが隠れてしまいます)。 選択後、その画風の STYLE.md を読み、スタイルカード(数値:色値、線幅、光の比率、フォント、カメラ文法、サウンド)にまとめ、ユーザーに確認を取ります。

3. スタイルフレーム

実際の描画コードを使用して、1~3枚のスタイルフレーム(1カット/1コーナー、ライトと色は決定済み)を出力します。ユーザーが確認してから展開します。

4. 設定カード

人物、場所、小道具がある場合、それぞれ1枚ずつ設定カードを作成します:外見、プロポーション、配色、服装、重要な小道具、登場してはいけないもの。設定画を出力し、ユーザーに確認させます。

5. 絵コンテ連絡表

6~9コマのサムネイルを1枚にまとめます(各コマ:時間、画面、カメラ、音声、字幕)。ユーザーが確認してからアニメーション制作に入ります。

6. ラフ → 審査員ループ

パイプラインに従ってラフを制作し、references/review.md に従って2名の審査員を起動し、審査基準カードに基づいて項目ごとに判定します(合格 / 一部合格 / 不合格 + エビデンスフレーム)。不合格の項目のみを修正し、毎ラウンド結果をユーザーに表示します。 停止条件:必須項目がすべて合格かつユーザーが満足、または3ラウンド経過、またはユーザーが停止を要求した場合。

7. アーカイブ

~/video-forge/works/<slug>/ に配置:ソースコードまたはプロジェクトリンク、完成品/スクリーンショット、需要カード、スタイルカード、絵コンテ、scores.md;~/video-forge/retros/ に振り返りを記述;再利用可能な方法であれば、recipes/_template.md から新規レシピを作成し、~/video-forge/README.md の「🎞 作品」テーブルに行を追加;新しい外部ライブラリを使用した場合は、deps.json に登録し、index/ を再構築します。

公開から約1週間後、ユーザーにプラットフォームの管理画面(例:抖音クリエイターサービスセンター)で、完視率、平均視聴時間、どの秒数で最も離脱が多いか、どの部分がリプレイされているかを確認してもらい、その作品の scores.md の「公開データ」セクションに記入し、振り返りに一文を追加します:どのリテンション施策が効果的だったか、どこで離脱が発生したか。次回の脚本と絵コンテ作成時には、審査員の意見だけでなく、これらの実データを参照します。

参考ファイル

フェーズファイルいつ見るか
1 質問references/interview-checklist.md毎回の開始時;各ラウンドの質問前に不足項目を確認
1–5 カードreferences/card-templates.md需要カード、スタイルカード、設定カード、絵コンテ連絡表を貼る時
2 画風references/style-picker.mdユーザーが画風を選んでいない、何を作るかわからない時
3–6 制作references/pipeline-style-film.mdlemo-opuscar画風でショートフィルム制作
references/pipeline-mv.md音楽MV制作
references/pipeline-explainer.mdRemotionで情報・解説動画制作
references/pipeline-diorama.mdthree.js 3Dミニチュアシーン制作
3–6 役割分担references/division-of-labor.md複数エージェントでTreatmentや制作を行う時:役割定義、骨格ファイル、検証スクリプト
タイプカード(タイプ/尺枠別)references/genres/README.md質問時にタイプと尺枠を決定した後、対応するカードを読み込む:尺予算、構成、視覚・音声仕様、検証ロジック、プロンプトテンプレートはすべてカードから取得
音楽references/music.md音楽のアプローチ選択(コード作曲(拍)/ ロイヤリティフリー音源 / オープンソースモデル)、tools/music/code_score.py の使い方
画風選択 / 動き選択~/video-forge/index/catalog.md(index.json 機械可読)すべての画風ライブラリ、動きカード、ナレーション文法、自作の画風を一覧;ライブラリ不足時は bash ~/video-forge/bootstrap.sh <id> を実行
1 / 6 審査references/review-standards.md質問時に動画タイプに応じたデフォルトチェック項目を提示し、ユーザーと一緒に審査基準カードを決定
6 審査references/review.md審査員起動、項目別判定、継続/停止の判断
トラブルシューティングreferences/troubleshooting.md依存関係インストール、レンダリング、スクリーンショット、ネットワークの問題
アーカイブ~/video-forge/README.md、~/video-forge/recipes/_template.md制作完了後

関連スキル