Communitygithub.com

notivn/AIEV

初心者向けのエンドツーエンド動画制作スキル(HyperFrames対応)。「動画を作って」「新しい動画」「一から動画を」といったリクエストや、HyperFrames未経験者がコンセプト・スクリプト・アイデアから完成MP4までを希望するときに使用します。1回のインタビューで要件を収集し、プレビューと目視確認ゲートを必須として動画を構築します。

AIEV とは?

このスキルは、HyperFramesプラットフォーム上で初心者でも簡単に動画を制作できるように設計されています。2つのフェーズ(インタビューとビルド)と8つのゲートで構成され、各ゲートで具体的な成果物を生成し、次のゲートに受け渡します。最初のフェーズでは、目的、フォーマット、スクリプト、スタイル、アセットなどを1回の会話で収集し、BRIEF.mdにまとめて明示的な承認を待ちます。次のフェーズでは、プロジェクトのスキャフォールディング、ストーリーボード作成、コンポジションの構築、リント、スタジオプレビュー、ドラフトレンダリング、目視確認、MP4プレビュー、最終レンダリングを行います。このスキルは、HyperFrames CLIと連携し、/short-form-videoや/hyperframesなどの関連スキルへの引き継ぎもサポートしています。非妥協ルールとして、プレビューゲートのスキップ禁止、レンダリング完了の虚偽報告禁止、プロジェクトフォルダ外でのビルド禁止、ユーザーのワークスペースの事前確認なしでのアセット要求禁止などが定められています。

対応~Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/notivn/AIEV/tree/HEAD/.claude/skills/make-a-video

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

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

ドキュメント

動画制作 - 初心者から完成MP4までのスキル

2つのフェーズ、8つのシーケンシャルゲート。各ゲートは、次のゲートが消費する具体的な成果物を生成します。ゲートをスキップしないでください。

このスキルを使用するタイミング - そして引き継ぐタイミング

このスキルを使用するタイミング:

  • ユーザーがHyperFramesを初めて使用し、コンセプト、スクリプト、またはアウトラインから始める場合
  • エンドツーエンドのウォークスルーを希望し、フレームワークのリファレンス資料を必要としない場合
  • まだフォーマットを決めていない場合

引き継ぐタイミング:

  • ユーザーがURLを貼り付けてそのサイトからの動画を希望する場合 → /website-to-hyperframesを呼び出す
  • ユーザーが明示的に9:16縦型の顔出しトーク+シーンオーバーレイを希望する場合 → ここでゲート1~4を実行し、ゲート5以降は/short-form-videoを呼び出す
  • ユーザーが動画ではなくフレームワークのルールを尋ねてきた場合 → /hyperframesを呼び出す

ルーティングノート(AI Edit Videoパイプライン): このスキルがプロジェクトブリーフから実行される場合、編集プロンプトの STYLE DESIGNおよびPHONG CÁCH DỰNG(ビデオスタイル)セクションは、以下のインタビューのデフォルトをオーバーライドします。ブリーフが既に答えているスタイルに関する質問を再度尋ねないでください。

2つのフェーズ

  • フェーズ1 - インタビュー(ゲート1~4): コードに触れる前にすべてを収集するための1回の会話。意図、フォーマット、スクリプト、音声、スタイル、アセット、ペーシング。BRIEF.mdに統合し、明示的な承認を待ちます。
  • フェーズ2 - ビルド(ゲート5~8): スキャフォールド → ストーリーボード → コンポジション → リント → スタジオプレビュー → ドラフトレンダリング → 目視確認 → MP4プレビュー → 最終レンダリング。

ゲート1 · 意図とフォーマット

一度に1つの質問をAskUserQuestionで行い、可能な限り選択式にします。

  1. この動画の目的は? (プロモーション · ソーシャル広告 · ローンチティーザー · 製品デモ · チュートリアル · 説明動画 · イントロ/アウトロカード · その他)
  2. ターゲット視聴者は? (自由記述)
  3. 目標時間? (10~20秒ショート · 20~45秒プロモ · 45~90秒説明 · 1.5~3分レッスン · カスタム)
  4. アスペクト比? (16:9 1920×1080 · 9:16 1080×1920 · 1:1 1080×1080)
  5. フレームレート? (30デフォルト · 60 UIがくっきり · 24 映画的)
  6. プラットフォーム/配信の制約? (ファイルサイズ · 締め切り · 再生場所)

ゲート: 6つすべてを取得。答えが9:16+顔出しの場合、ゲート5で/short-form-videoに引き継ぐ計画を立てます。

完全な質問バンク: Read: references/interview-questions.md


ゲート2 · スクリプトと音声

  1. スクリプトのソース? (ペースト · アウトラインから私が草稿作成 · 録音 · TTS · ナレーションなし)
  2. TTSの場合: 音声の好み。npx hyperframes tts --helpから選択肢を提示。ペースも取得。hyperframes tts(Kokoro)は英語のみ - ベトナム語ナレーションはシステムの/api/tts(Gemini TTSまたはVieNeu)を経由します。
  3. 顔出しの場合: 録画パス · 全画面またはコーナー配置 · 文字起こしが必要か? (npx hyperframes transcribe <file> --model small.en --json - 英語のみ、ベトナム語の場合はnoti-tiktok-vnスキルに従いfaster-whisperを使用)
  4. キャプション? (オフ · ハイプ · コーポレート · 歌詞風単語単位 · ミニマル)

ゲート: スクリプト(または草稿)取得、音声計画取得、キャプション計画取得。


ゲート3 · スタイル収集

ユーザーに何か尋ねる前に、既存のアセットを一覧表示します。 <workspace-root>/assets/とプロジェクトのassets/フォルダを確認。既にあるものを尋ねないでください。

その後、段階的に質問します。以下のすべてに答える必要はありません。

  1. スタイルガイドやブランド資料? (ペースト/パス · なし)
  2. カラーパレット? (16進コード · なし - MOTION_PHILOSOPHYのデフォルトを使用)
  3. フォント? (Google Fonts名 · ファイルパス · なし - デフォルトのInter + JetBrains Monoを使用)
  4. ロゴファイル? (パス · なし)。ブランド名が指定されていてもファイルがない場合: assets/brand-logos/を確認するか、POST /api/brand-logos {"name":"..."}で取得 - テキストのワードマークは404 BRAND_LOGO_NOT_FOUNDの場合にのみ許可されます。ロゴを描画したり生成したりしないでください。
  5. 雰囲気の参考動画? (URL/パス · なし)
  6. その他のアセット? (スクリーンショット · 製品写真 · Bロール · 音楽 - パスをリスト)
  7. MOTION_PHILOSOPHYの美学(黒いキャンバス · クロームタイプ · パースペクティブグリッド · ホイップトランジション)または別の雰囲気?
  8. ペーシング? (キネティック1~2秒 · バランス2~3秒 · リラックス3~5秒)
  9. 音楽? (なし · アンビエントパッド0.15 · ミュージックベッド0.4 · フル0.8 - ファイルがある場合はパス)
  10. アウトロ/コールトゥアクションテキスト?

決してブランドを押し付けないでください。 ユーザーがスタイルの提供を明示的に拒否した場合にのみ、MOTION_PHILOSOPHYのデフォルトにフォールバックします。

完全なスタイルフロー+MOTION_PHILOSOPHYデフォルト: Read: references/style-intake.md


ゲート4 · ブリーフ統合(ビルド前のハードゲート)

  1. ワークスペースルートに**MOTION_PHILOSOPHY.md**が存在する場合はそれを読む - 存在すれば必須。ない場合は、references/style-intake.mdのデフォルトで進め、ブリーフにその不在を記載します。
  2. プロジェクトの場所を尋ねる(明らかでない場合):
    • video-projects/が存在する場合 → video-projects/<スラッグ>/を使用
    • それ以外の場合 → ユーザーに尋ねる
  3. <プロジェクトフォルダ>/BRIEF.mdを書く:
    • スラッグ · 意図 · 視聴者 · 寸法 · fps · 時間
    • スクリプト(全文またはアウトライン)
    • 音声選択 · キャプション計画 · 顔出し計画
    • スタイルプロファイル: パレット(16進数)、フォント、ロゴパス、参考動画
    • ペーシング
    • アセット一覧(パス付き)
    • アウトロ/CTAテキスト
  4. ブリーフを表示。明示的な承認を待つ。 「はい、作ってください」という明確な返事がない限り、ゲート5に進まないでください。

ゲート5 · スキャフォールドとストーリーボード

最初に引き継ぎチェック

ブリーフが9:16縦型の顔出しトーク+シーンオーバーレイを説明している場合、今すぐ/short-form-videoを呼び出し、ブリーフを引き渡します。その4層スキャフォールドはそのフォーマット専用に作られています。

それ以外の場合は続行:

スキャフォールド

  1. mkdir <プロジェクトフォルダ>
  2. 同様のフォーマットの兄弟プロジェクトが存在する場合、そのhyperframes.jsonとmeta.jsonをテンプレートとしてコピーする提案をする。それ以外の場合は、フォルダ内から: npx hyperframes init
  3. meta.jsonをユーザーのスラッグ、寸法、fpsで編集。
  4. 提供されたアセットを<プロジェクトフォルダ>/assets/にコピー。
  5. ゲート3から<プロジェクトフォルダ>/assets/style-profile.mdを作成 - パレット/フォント/ロゴの単一情報源。

ストーリーボード

references/storyboard-template.mdのテンプレートを使用して<プロジェクトフォルダ>/STORYBOARD.mdを生成。すべてのビートは以下を取得:

ビート N - タイトル(開始-終了、時間) - 一文でのコンセプト
ビジュアル要素: [各要素、サイズ、アニメーション、タイミング]
モーション言語: [モーションの種類]
使用イージング: [3~4つの異なるGSAPイージング]
終了: [次のビートへのトランジション]
オーディオ: [VOライン / SFX / 音楽レイヤー]

ファイルの先頭: シーン · 開始 · 時間 · コンポジションファイルのタイミングテーブル。

3幕構成を提案:

  • 第1幕(フック)≈ 時間の20%
  • 第2幕(本編)≈ 55%
  • 第3幕(落ち+4~6秒ホールド付きアウトロ)≈ 25%

(MOTION_PHILOSOPHY §0 Law 9、§1)

ユーザーの意図をカタログブロックにマッピング: Read: references/catalog-intent-map.md

ゲート: ストーリーボード+タイミングテーブルを表示。ユーザーが承認するまで繰り返します。


ゲート6 · コンポジションの構築

フレームワークルールについては/hyperframesを呼び出します。このスキルはスキャフォールドと規律を所有し、/hyperframesはルールを適用します。

すべてのサブコンポジションをスキャフォールド

<div data-composition-id="scene-name" data-start="..." data-duration="...">
  <style>[data-composition-id="scene-name"] { /* スコープ */ }</style>
  <!-- DOM -->
  <script>
    (function(){
      const SLOT_DURATION = ...;
      const tl = gsap.timeline({ paused: true });
      // ... トゥイーン ...
      tl.to({}, { duration: SLOT_DURATION }, 0);   // アンカー - MOTION_PHILOSOPHY Law 11
      window.__timelines["scene-name"] = tl;
    })();
  </script>
</div>

完全なボイラープレート+キャプションパターン+アンビエントbgパターン: Read: references/composition-scaffold.md

構築ルール

  • アンビエント背景はdata-track-index="0"に、コンポジション全体の時間に対して。
  • キネティックタイプオープナー: 単語ごとに0.06~0.10秒の間隔。
  • キャプションはindex.htmlのルートコンポジションのボディレベルの兄弟要素として、それぞれdata-track-index ≥ 20を持つ。決してシーンタイムラインの中に入れない(MOTION_PHILOSOPHY §3.13)。
  • カタログブロックはnpx hyperframes add <name>でインストール。すぐにブロックのCSSを[data-composition-id="..."]にスコープする - カタログブロックにはhtml, body { ... }ルールが同梱されており、サブコンポジションとしてロードされると親ドキュメントに漏れ出ます。
  • 縦型+顔出し: ネイティブの1920×1080の顔をトランスフォーム(translate+scale)でラップし、下半分または全画面モードにします。(ここで/short-form-videoの代わりに来た場合、引き継ぎを強く検討してください。)
  • ユーザーが提供したもののみを適用。 ユーザーのパレット、フォント、ロゴ。それ以外は注入しない。ユーザーがMOTION_PHILOSOPHYのデフォルトを選択した場合、references/style-intake.mdからパレット+フォントペアを取得します。

決定性

Math.random()、Date.now()、レンダリング時のfetch()は使用禁止。シード付きPRNGまたはハーモニックサインのハッシュを使用します(MOTION_PHILOSOPHY §3.10)。


ゲート7 · リント → スタジオプレビュー(プレビューゲート1 - 必須)

  1. npx hyperframes lint - すべてのエラーを修正、警告をトリアージ。
  2. npx hyperframes previewをバックグラウンドで実行。
  3. http://localhost:3002で「Studio running」を待機。
  4. URLをユーザーに渡すさらに個々のコンポジションURL(http://localhost:3002/?comp=<id>)も。プロジェクトにWebGLシェーダーブロックがある場合は、個々のURLを最初に提示 - ソフトウェアWebGLフォールバックはマスターコンポジションを停滞させる可能性があります。
  5. 「良さそうだ、ドラフトをレンダリングして」という明示的な返事を待つ 前に進む前に。沈黙は承認ではありません。

ホットリロードはオン - 編集はライブで反映されます。


ゲート8 · ドラフトレンダリング → 目視確認 → MP4プレビュー → 最終

ドラフトレンダリング

npx hyperframes render --quality draft --output renders/<slug>-draft.mp4

目視確認(配信前に必須)

リント合格 ≠ デザイン動作。フレームを抽出して表示します。

  1. mkdir -p renders/frames
  2. すべてのビートの決定的瞬間とすべてのトランジションに対して:
    ffmpeg -y -ss <t> -i renders/<slug>-draft.mp4 -frames:v 1 -q:v 2 renders/frames/t<t>.png
    
  3. すべてのPNGに対してReadツールを呼び出します。 Readツールは画像をコンテキストに読み込みます - ファイル名をリストするだけではダメです。
  4. フレームごとに確認: 顔のトリミングなし、シーンごとに正しい顔モード、テキストが読みやすくパレットに準拠、オーバーフローなし、トランジションが意図した単語に合っている、空白フレームなし。
  5. 問題がある場合: 修正 → 再レンダリング → 再確認。壊れたドラフトを決して出荷しないでください。

MP4プレビュー(プレビューゲート2 - 必須)

npx serve renders -p 8080 -n

Pythonのhttp.serverは使用しないでください - HTTP Rangeリクエストをサポートしていないため、スクラブが機能しません。

ユーザーにhttp://localhost:8080/<slug>-draft.mp4を渡します。再生とオーディオ同期に関する明示的な承認を待ちます。

最終レンダリング

npx hyperframes render --quality standard --output renders/<slug>-final.mp4

AI Edit Videoパイプラインではこれで終わりではありません: video-pipelineスキルを続行します(QC → レンダーキューを介して最終アセンブル → outputs/<id>-v<N>.mp4 → meta.jsonの更新 → サムネイル/公開)。パイプライン外でのスタンドアロン使用: 出力パスを報告。完了。

完全なプリフライト+配信前チェックリスト: Read: references/build-checklist.md


非妥協ルール(重要 - 緩めないでください)

  • プレビューゲート1(Studio)またはプレビューゲート2(レンダリング済みMP4)をスキップしないでください。 ビルドごとに常に2つのゲート。
  • フレームが抽出され、Readツールを介してReadされるまで、レンダリングが完了したと主張しないでください。
  • 専用のプロジェクトフォルダ内以外ではビルドしないでください。 index.htmlをワークスペースルートに決して置かないでください。
  • ユーザーのワークスペースを一覧表示する前に、アセットを要求しないでください。
  • 各サブコンポジションタイムラインの最後にあるtl.to({}, { duration: SLOT_DURATION }, 0)アンカートゥイーンをスキップしないでください。 MOTION_PHILOSOPHY Law 11。
  • レンダリングロジック内でMath.random() / Date.now()を使用しないでください。 シード付きハッシュのみ。
  • <video>タグにclass="clip"を追加しないでください。 壊れます。
  • ユーザーにブランドを押し付けないでください。 まず尋ね、ユーザーが明示的に拒否した場合にのみMOTION_PHILOSOPHYのデフォルトにフォールバックします。

リファレンス

  • references/interview-questions.md - ゲートごとの完全な質問バンク
  • references/style-intake.md - スタイルインタビュー+MOTION_PHILOSOPHYデフォルト
  • references/catalog-intent-map.md - 「ユーザーがXと言った → Yをインストール」
  • references/storyboard-template.md - ビートごとのテンプレート+実例
  • references/composition-scaffold.md - スコープ付きスタイル+IIFE GSAPボイラープレート
  • references/build-checklist.md - プリフライト+配信前ゲート

外部(ワークスペースレベル):

  • MOTION_PHILOSOPHY.md - このスキルが存在を前提とする唯一の外部リファレンス。美的ベースライン。ファイルがない場合のフォールバックはreferences/style-intake.mdにあります。

関連スキル

  • /hyperframes - フレームワークルール、ゲート6で呼び出し
  • /hyperframes-cli - init · lint · preview · render · transcribe · tts
  • /hyperframes-registry - カタログブロックのインストール
  • /gsap - GSAPアニメーションリファレンス
  • /short-form-video - 9:16縦型トークフォーマットの場合、ゲート5で引き継ぎ
  • /website-to-hyperframes - 入力がURLの場合、ゲート1で引き継ぎ

関連スキル