Communitygithub.com

notivn/AIEV

專為 HyperFrames 新手設計的端到端影片創作技能。當使用者說「製作影片」、「建立影片」、「新影片」、「從頭開始製作影片」、或帶著概念、劇本或粗略想法前來並希望獲得完成的 MP4 檔案時使用。在一次對話中完成訪談,然後以強制預覽和視覺驗證關卡來建置完整影片。

AIEV 是什麼?

這個技能是一套完整的、引導式的端到端 HyperFrames 影片製作流程,專為首次使用者設計。它會先透過一次結構化的訪談(關卡 1-4)收集所有必要資訊,例如影片意圖、格式、劇本、風格和素材,然後產生一份摘要簡報(BRIEF.md)並等待使用者明確核准,之後才會開始建置。建置階段(關卡 5-8)會自動化腳手架搭建、故事板製作、組合(composition)建置、程式碼檢查(linting)和草稿渲染。一個關鍵的強制性步驟是,在最終渲染前,必須透過提取畫面並使用「讀取」工具進行視覺驗證,以確保設計無誤。此技能支援 HyperFrames CLI 並與相關的 /short-form-video 和 /hyperframes 技能協同運作,以處理特定格式(如 9:16 直式影片)或框架規則。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

製作影片 - 從新手到完成 MP4 的技能

兩個階段,八個順序關卡。每個關卡都會產生一個具體的產物,供下一個關卡使用。不要跳過關卡。

何時使用此技能 - 以及何時轉交

使用此技能時機:

  • 使用者是 HyperFrames 新手,從一個概念、劇本或大綱開始
  • 他們想要的是完整的逐步解說,而不是框架參考資料
  • 他們尚未決定影片格式

轉交時機:

  • 使用者貼上一個 URL 並想要從該網站製作影片 → 調用 /website-to-hyperframes
  • 使用者明確要求製作 9:16 直式、含頭像鏡頭(face-cam)與場景疊加(scene overlays)的談話性影片 → 在此處執行關卡 1–4,然後從關卡 5 開始調用 /short-form-video
  • 使用者詢問的是框架規則,而不是影片 → 調用 /hyperframes

路由注意事項(AI 編輯影片流程): 當此技能從專案簡報啟動時,編輯提示中的 STYLE DESIGN 和 PHONG CÁCH DỰNG(影片風格)區段會覆蓋下面的訪談預設值 - 請勿 重複詢問簡報中已回答的風格問題。

兩個階段

  • 階段 1 - 訪談 (關卡 1–4): 一次對話式的傳遞,旨在觸及程式碼之前 收集所有資訊。包括意圖、格式、劇本、聲音、風格、素材、節奏。將其整合成一份 BRIEF.md 並等待明確核准。
  • 階段 2 - 建置 (關卡 5–8): 腳手架(scaffold)→ 故事板 → 組合(compositions)→ 程式碼檢查(lint)→ Studio 預覽 → 草稿渲染 → 視覺驗證 → MP4 預覽 → 最終渲染。

關卡 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. 平台 / 傳遞限制?(檔案大小 · 截止日期 · 將在何處播放)

關卡門檻: 六個項目全部捕捉。如果答案是 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. 字幕?(關閉 · 炫目 · 正式 · 逐字卡拉OK · 極簡)

關卡門檻: 已捕捉劇本 (或已草擬)、已捕捉音訊計畫、已捕捉字幕計畫。


關卡 3 · 風格收集

在詢問使用者任何問題之前,先盤點現有素材。 檢查 <workspace-root>/assets/ 和任何專案 assets/ 資料夾。不要詢問已經存在的東西。

然後逐步詢問 - 使用者不需要回答所有這些問題:

  1. 風格指南或品牌文件?(貼上/路徑 · 沒有)
  2. 調色盤?(十六進位色碼 · 無 - 使用 MOTION_PHILOSOPHY 預設值)
  3. 字型?(Google Fonts 名稱 · 檔案路徑 · 無 - 使用 Inter + JetBrains Mono 預設值)
  4. Logo 檔案?(路徑 · 無). 如果指名了品牌但未提供檔案:在 assets/brand-logos/ 中尋找,或使用 POST /api/brand-logos {"name":"..."} 擷取 - 只有在收到 404 BRAND_LOGO_NOT_FOUND 後才允許使用文字字標。絕不能自行繪製或生成 Logo。
  5. 參考影片作為風格參考?(URLs/路徑 · 無)
  6. 其他素材?(螢幕截圖 · 產品照片 · B-roll · 音樂 - 列出路徑)
  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/<slug>/
    • 否則 → 詢問使用者
  3. 撰寫 <project-folder>/BRIEF.md:
    • slug · 意圖 · 目標觀眾 · 尺寸 · fps · 時長
    • 劇本(完整或大綱)
    • 語音選擇 · 字幕計畫 · 頭像鏡頭計畫
    • 風格設定檔:調色盤(hex)、字型、logo 路徑、參考影片
    • 節奏
    • 素材清單與路徑
    • 結尾 / CTA 文字
  4. 顯示簡報。等待明確核准。 在得到明確的「好的,開始建置」之前,不要進入關卡 5。

關卡 5 · 腳手架與故事板

首先檢查轉交條件

如果簡報描述的是 9:16 直式、含頭像鏡頭與場景疊加的談話性影片,則立即調用 /short-form-video 並移交簡報。其 4 層腳手架專為該格式設計。

否則繼續:

腳手架

  1. mkdir <project-folder>
  2. 如果存在格式相似的相鄰專案,提議複製其 hyperframes.json + meta.json 作為模板。否則,在資料夾內執行:npx hyperframes init
  3. 編輯 meta.json,填入使用者的 slug、尺寸、fps。
  4. 將提供的素材複製到 <project-folder>/assets/。
  5. 根據關卡 3 建立 <project-folder>/assets/style-profile.md - 作為調色盤/字型/logo 的唯一事實來源。

故事板

使用 references/storyboard-template.md 中的模板生成 <project-folder>/STORYBOARD.md。每個拍子(beat)都會有:

拍子 N - 標題 (開始–結束, 時長) - 一句話概念
視覺元素:[每個元素, 大小, 動畫, 時間]
動態語言:[動態的種類]
使用的緩動函數:[3–4 個不同的 GSAP 緩動函數]
退出:[轉場到下一個拍子]
音訊:[VO 台詞 / SFX / 音樂層]

檔案頂部:一個包含場景 · 開始 · 時長 · 組合(composition)檔案的計時表。

提出一個三幕式結構:

  • 第一幕(鉤子)≈ 時長的 20%
  • 第二幕(主體)≈ 55%
  • 第三幕(收尾 + 含 4–6 秒停留的結尾)≈ 25%

(MOTION_PHILOSOPHY §0 法則 9, §1.)

將使用者意圖對應到目錄區塊: Read: references/catalog-intent-map.md

關卡門檻: 顯示故事板 + 計時表。反覆修改直到使用者核准。


關卡 6 · 建置組合(Compositions)

調用 /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 法則 11
      window.__timelines["scene-name"] = tl;
    })();
  </script>
</div>

完整樣板 + 字幕模式 + 環境背景模式:Read: references/composition-scaffold.md

建置規則

  • 環境背景放在 data-track-index="0",持續整個組合的時長。
  • 動感文字開場: 逐字間隔 0.06–0.10 秒。
  • 字幕作為 index.html 中根組合(root composition)的 body 層級兄弟元素,每個帶有 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,請強烈考慮轉交。)
  • 僅應用使用者提供的內容。 他們的調色盤、他們的字型、他們的 logo。不要注入任何其他東西。如果他們選擇了 MOTION_PHILOSOPHY 預設值,則從 references/style-intake.md 中提取調色盤 + 字型配對。

確定性

沒有 Math.random(),沒有 Date.now(),沒有渲染時的 fetch()。使用種子隨機數生成器(seeded PRNGs)或諧波 sin 雜湊(MOTION_PHILOSOPHY §3.10)。


關卡 7 · 程式碼檢查 → Studio 預覽(預覽關卡 1 - 強制)

  1. npx hyperframes lint - 修復所有錯誤,分類警告。
  2. 在背景執行 npx hyperframes preview。
  3. 等待在 http://localhost:3002 上顯示「Studio 正在執行」。
  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 編輯影片流程中,這不是結束:繼續使用 video-pipeline 技能(QC → 透過渲染佇列組合最終版本 → outputs/<id>-v<N>.mp4 → 更新 meta.json → 縮圖/發布)。在流程外獨立使用時:報告輸出路徑。完成。

完整的出發前與交付前檢查清單:Read: references/build-checklist.md


不可妥協的事項(承重牆 - 不可淡化)

  • 不要跳過預覽關卡 1(Studio)或預覽關卡 2(已渲染的 MP4)。 每次建置兩個關卡,必做。
  • 不要宣稱渲染完成,直到畫面已提取並透過 Read 工具讀取。
  • 不要在專屬的專案資料夾之外的地方建置。 絕不能將 index.html 放在工作區根目錄。
  • 在盤點使用者工作區之前,不要向使用者詢問素材。
  • 不要省略每個子組合時間線末尾的 tl.to({}, { duration: SLOT_DURATION }, 0) 錨點補間。 MOTION_PHILOSOPHY 法則 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 - 在關卡 5 轉交,用於 9:16 談話性頭像鏡頭格式
  • /website-to-hyperframes - 如果起始輸入是 URL,則在關卡 1 轉交

相關技能