Communitygithub.com

產品發布影片 — URL/Brief → 分鏡序列成片

把產品/行銷 URL、貼上腳本或 brief 變成產品發布影片(SaaS 促銷、功能揭幕、應用上線)。分鏡序列架構:時間碼黃金藍圖,讓每一幀在整段時長裡持續演進。

Brief → 分鏡序列成片 是什麼?

Launch Video 配方第 1 步(合成):starter-nextjs-product-launch-video。URL/腳本/brief → 分鏡序列發布成片。

相容平台~Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/1345AbhishekKumar/starter-nextjs/tree/HEAD/.agents/skills/product-launch-video

在你喜歡的 AI 中提問

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

說明文件

media-use: 在獲取音訊/圖像之前,請呼叫 /media-use 從 HeyGen 目錄中解析 BGM/SFX/影像。先執行 --adopt 以註冊現有資產。請參閱 /media-use 技能。

產品發佈到 HyperFrames

使用此技能來捕捉產品、了解其品牌、規劃發佈影片,並在 HyperFrames 中逐幀構建。

在執行步驟 0 之前確認路線。 您是協調者。執行每個步驟,驗證其關卡,然後才繼續下一步。此技能適用於正在進行市場行銷、發佈、推廣或揭露的產品,包括諸如“為我們的網站製作宣傳片”等請求(當其目的是促銷時)。將其他意圖引導至別處:一般的非發佈網站導覽 -> /website-to-video;沒有產品的主題解說 -> /faceless-explainer;GitHub PR -> /pr-to-video;在現有素材上添加字幕 -> /embedded-captions;簡短無旁白的動態圖形 -> /motion-graphics。如果用戶只說“製作一個影片”或路線不確定,請先閱讀 /hyperframes。

您是協調者。在 videos/<project>/ 目錄下工作。按順序執行步驟並在繼續之前通過每個關卡。用戶關卡步驟為步驟 0、步驟 3 和步驟 6。除了步驟 5(您為每個影格分派一個子代理)之外,所有步驟都由您自己執行。不要在這裡放置設計或動畫規則;這些規則存在於影格工作者子代理、此技能的本地 ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/ 以及 hyperframes-creative 中。

工作流程:步驟 0 設定 -> hyperframes.json;步驟 1 捕捉 -> capture/;步驟 2 設計系統 -> frame.md;步驟 3 分鏡腳本/腳本 -> STORYBOARD.md 和 SCRIPT.md;步驟 3.1 音訊 -> audio_meta.json;步驟 4 視覺設計 -> 增強的 STORYBOARD.md;步驟 5 影格 -> compositions/frames/NN-*.html 和 index.html;步驟 6 最終渲染 -> renders/video.mp4。


步驟 0:設定與簡報

目標:鎖定核心影片簡報,並在需要時建立 HyperFrames 專案。

僅在缺少 hyperframes.json 時才初始化。使用 kebab-case 命名 <project>(例如來自品牌或域名,如 acme-promo);切勿使用工作區名稱或時間戳。

npx hyperframes init "videos/<project>" --non-interactive --example=blank — init 會檢查已安裝的技能是否與 GitHub 上的最新版本相符,並在有任何技能過期時更新全域技能集。

在簡報之前顯示登入狀態 — 執行 npx hyperframes auth status 並逐字轉達其輸出(不要改寫或重新解釋)。 它會報告語音/BGM 將使用 HeyGen 還是本地引擎,並且在未登入時,說明如何登入。如果未登入,請停止並等待用戶選擇 — 登入,或說 "go"/"offline" 以繼續使用本地引擎 — 然後再詢問簡報或任何其他問題。 將其視為一個真正的決策點,而不是一個備註;不要將選擇納入簡報問題中,也不要將金鑰寫入每個儲存庫的 .env 中。(在自主模式下,記錄狀態並以離線模式繼續。)請參閱 ../hyperframes-media → Preflight 以獲取規範性指導。

關卡: hyperframes.json 存在,且角度、長度、縱橫比和語言已鎖定;已顯示登入狀態(已登入,或繼續離線作業)。


步驟 1:捕捉資產

目標:收集影片的原始材料、品牌訊號和可用資產。

分類輸入並選擇路徑。明確的 URL -> 捕捉它,並使用該網站進行旁白和資產。貼上的腳本/簡報 -> 逐字儲存為 user_script.txt,詢問一次“逐字使用還是重新組織?”,將答案儲存為 VO_MODE,然後解析捕捉目標:文字中的 URL -> 使用它;僅有品牌名稱 -> WebSearch,用一行確認 URL,然後爬取;沒有 URL/網站 -> 無捕捉路徑。

使用以下命令執行捕捉:npx hyperframes capture "<URL>" -o ./capture

如果存在 GEMINI_API_KEY、GOOGLE_API_KEY 或 OpenRouter 金鑰,則捕捉會自動為資產添加說明,放入 capture/extracted/asset-descriptions.md。這不是一個審查關卡。如果沒有視覺金鑰,則使用 DOM 上下文並繼續。

無捕捉路徑:手動建立 capture/extracted/tokens.json、capture/extracted/visible-text.txt、capture/extracted/asset-descriptions.md 和 capture/assets/。tokens.json 應為 { "title": "", "description": "", "colors": [], "fonts": [] };盡可能從簡報中填寫標題/描述。visible-text.txt 包含完整的簡報或腳本。asset-descriptions.md 應說明未捕捉到任何資產(除非用戶提供了資產備註)。

關卡: capture/extracted/tokens.json、capture/extracted/visible-text.txt、capture/extracted/asset-descriptions.md 和 capture/assets/ 存在;您可以用一個清晰的句子說明品牌。將 asset-descriptions.md 視為主要資產清單。如果實際捕捉後它缺失,請停止並報告捕捉不完整。如果存在 capture/BLOCKED.md,請遵循它。


步驟 2:設計系統

目標:選擇一個已出貨的影格預設;一個腳本會將其轉換為此影片的 frame.md + 字幕外觀。

您做出唯一的判斷 — 選擇哪個預設。閱讀 ../hyperframes-creative/references/design-spec.md,並選擇外觀最符合品牌和簡報的預設。然後執行:

node <SKILL_DIR>/scripts/build-frame.mjs --preset <name> --hyperframes .

腳本確定性地完成其餘工作:複製預設的 FRAME.md → frame.md 並重新混合到 capture/extracted/tokens.json 中的品牌令牌上(品牌顏色按角色映射到預設的顏色鍵上 — 墨水、畫布、強調色 — 保留鍵/結構/組件;預設的顯示字體和正文字體替換為品牌字體),複製預設的字幕外觀到 .hyperframes/caption-skin.html,並自我驗證(映射損壞時退出代碼 1)。一旦退出代碼為 0,就繼續下一步 — 不要手動編輯規格。

tokens.json 沒有品牌顏色/字體(例如無捕捉) -> 腳本保留預設自己的調色板,這是一個完整的可出貨設計。如果簡報中提到了捕捉遺漏的品牌顏色/字體,請在執行前將其添加到 capture/extracted/tokens.json 中(或使用用戶的 design.md 來填充它);之後僅在映射確實需要時才手動調整 frame.md。

關卡: build-frame.mjs 退出代碼為 0 — frame.md 來自一個命名預設,並且(當預設附帶一個時).hyperframes/caption-skin.html 作為字幕外觀來源存在。


步驟 3:分鏡腳本和腳本

目標:將簡報和捕捉到的材料轉換為一個已批准的逐影格故事計畫。

閱讀 references/story-design.md、../hyperframes-animation/blueprints-index.md、../hyperframes-core/references/storyboard-format.md 和 ../hyperframes-core/references/script-format.md。使用它們來撰寫 STORYBOARD.md,並在需要旁白時撰寫 SCRIPT.md。

使用 story-design.md 來獲取故事藍圖、鉤子、說服邏輯、節拍、VO_MODE 和資產選擇。作為一個軟性指南,請查閱 ../hyperframes-animation/blueprints-index.md 中的角色→藍圖選單:對於每個節拍,在適合時標記一個候選藍圖 ID。故事的真實性仍然決定哪些節拍存在 — 永遠不要強迫節拍符合藍圖,也永遠不要僅僅因為有現成的成熟形狀就發明一個節拍。從 capture/extracted/asset-descriptions.md(權威清單)中選擇每個視覺影格的 asset_candidates — 不要瀏覽原始的 capture/assets/。除非該清單缺失或無法使用,否則不要要求用戶選擇資產。使用分鏡腳本和腳本參考中的確切必填欄位。

草擬後,顯示一個逐影格的摘要。在同一則訊息中,向用戶詢問兩件事:(a) 批准或要求更改,以及 (b) 他們是否想要分鏡腳本框架的即時預覽(npx hyperframes preview)— 只有在用戶同意時才打開它。迭代直到獲得批准,並將預覽選擇帶到步驟 6。

關卡: STORYBOARD.md 存在,每個視覺影格都有 asset_candidates,SCRIPT.md 在需要旁白時存在,並且用戶已批准逐影格計畫。


步驟 3.1:音訊

目標:從已批准的腳本生成旁白、單字計時、音樂和音訊元資料。

在步驟 3 批准後開始音訊工作。在背景執行它,然後繼續到步驟 4。

node <SKILL_DIR>/scripts/audio.mjs --script ./SCRIPT.md --storyboard ./STORYBOARD.md --hyperframes . --out ./audio_meta.json &

音訊腳本處理旁白、單字計時、從 HeyGen 音樂庫查找 BGM 以及計時元資料。BGM 情緒來自分鏡腳本的 music: 欄位。這使用 HeyGen 音訊 API 進行檢索,而不是生成,並使用與 TTS 相同的 ~/.heygen 憑證。有關提供者的詳細資訊,請閱讀 ../hyperframes-media/references/tts.md。

如果沒有旁白且沒有 SCRIPT.md,則跳過語音生成。如果分鏡腳本有音樂情緒,BGM 仍可能執行。

關卡: 音訊工作已開始,或專案已標記為無聲。


步驟 4:影格視覺設計

目標:為每個分鏡腳本影格添加視覺方向、佈局意圖和動畫選擇。

就地編輯 STORYBOARD.md。不要建立另一個分鏡腳本。使用 frame.md 作為顏色、字體、佈局感覺和風格的權威來源。

閱讀 references/visual-design.md、../hyperframes-animation/blueprints-index.md、references/motion-language.md 和 ../hyperframes-animation/rules-index.md。使用 visual-design.md 來獲取方法(時間編碼的鏡頭序列、內聯佈局詞彙以及必需的 ## Video direction 區塊)。使用 ../hyperframes-animation/blueprints-index.md 來選擇每個影格的鏡頭形狀。使用 motion-language.md(動畫詞彙 + 動畫原則)和 ../hyperframes-animation/rules-index.md(有效的規則名稱)來處理動畫 — 不要發明動畫名稱。

對於每個視覺影格,根據 visual-design.md 的方法,在 STORYBOARD.md 中撰寫一個時間編碼的鏡頭序列:選擇影格的藍圖(或組合),用此產品的內容實例化它,並根據旁白調整每個場景的揭示節奏,使影格在其整個持續時間內展開,而不是前置載入然後凍結。根據每個場景內聯說明佈局和動畫(詞彙在 visual-design.md 和 motion-language.md 中)。添加一個影片範圍的 ## Video direction 區塊。

不要更改故事、腳本、資產選擇、asset_candidates、transition_in 或捕捉到的原始材料。不要在此步驟中撰寫 HTML。

在視覺設計鎖定後,暫存命名資產:

node <SKILL_DIR>/scripts/stage-assets.mjs --storyboard ./STORYBOARD.md --hyperframes .

關卡: 每個視覺影格都有一個時間編碼的鏡頭序列,其揭示節奏已根據旁白調整(無前置載入);## Video direction 存在;assets/ 包含命名資產。


步驟 5:建立影格

目標:將每個分鏡腳本影格建立為 HTML 合成,並組裝可播放的影片。

如果音訊已啟動,請等待步驟 3.1 的音訊完成。然後同步持續時間並獲取 SFX;如果無聲則跳過兩者。

node <SKILL_DIR>/scripts/audio.mjs sync-durations --audio-meta ./audio_meta.json --storyboard ./STORYBOARD.md

node <SKILL_DIR>/scripts/audio.mjs fetch-sfx --storyboard ./STORYBOARD.md --hyperframes .

持續時間同步是機械性的:真實語音持續時間獲勝;無聲影格保留估計值;永遠不要手動編輯同步後的持續時間。

在分派之前,閱讀 sub-agents/frame-worker.md 和 ../hyperframes-core/references/subagent-dispatch.md。為每個影格分派一個子代理,盡可能並行;否則分批執行工作者。每個工作者只處理一個影格。

每個工作者的上下文必須包含 PROJECT_DIR、frame_id、畫布大小、字幕狀態和啟用字幕時的保留區帶,以及 RULES_DIR 作為此技能 ../hyperframes-animation/rules/ 的絕對路徑。每個工作者讀取 frame.md、其來自 STORYBOARD.md 的 ## Frame N 區塊、每個引用動畫的本地規則配方(../hyperframes-animation/rules/<id>.md)以及影格的藍圖模板(../hyperframes-animation/blueprints/<id>.md)。每個工作者只寫入 compositions/frames/NN-*.html。工作者不得編輯 STORYBOARD.md。

當每個工作者返回時,協調者在 STORYBOARD.md 中將該影格標記為 animated。

在音訊計時存在後,在背景建立字幕並組裝索引:

node <SKILL_DIR>/scripts/captions.mjs build --storyboard ./STORYBOARD.md --audio-meta ./audio_meta.json --hyperframes . --out ./caption_groups.json &

node <SKILL_DIR>/scripts/assemble-index.mjs --storyboard ./STORYBOARD.md --hyperframes .

captions.mjs 使用專案的 .hyperframes/caption-skin.html(在步驟 2 中複製)作為字幕外觀,從 frame.md 注入品牌令牌;當沒有外觀時,它會渲染內建的預設藥丸形狀。captions: skipped (<reason>) 是有效的。明確跳過時繼續不帶字幕。

關卡: 每個影格都標記為 animated,index.html 存在,並且已建立字幕或明確跳過。


步驟 6:最終確定

目標:驗證組裝後的影片,獲得用戶批准,並渲染最終的 MP4。

注入過渡效果,執行檢查,暫停以供審查,然後渲染。

node <SKILL_DIR>/scripts/transitions.mjs inject --storyboard ./STORYBOARD.md --hyperframes .

node <SKILL_DIR>/scripts/transitions.mjs verify --storyboard ./STORYBOARD.md --index ./index.html

npx hyperframes lint

npx hyperframes validate

npx hyperframes inspect

npx hyperframes snapshot --at <frame-midpoints>

snapshot 將捕捉到的影格拼接成一個連絡表(snapshots/contact-sheet.jpg)。快速瀏覽一下;如果沒有明顯問題,請繼續 — 不要在此停留。

如果命令失敗,請輸出 stderr 並停止 — 不要堆疊恢復命令。自行修復:對 compositions/frames/NN-*.html 進行最便宜的安全編輯,然後重新執行失敗的檢查。

檢查通過後,暫停以供用戶審查。影片已組裝完成,可在 Studio 中檢視和編輯。僅在步驟 3 和步驟 6 之間管理一次預覽:如果用戶之前要求,則打開它;如果之前拒絕,則提供它;如果用戶已在 Studio 中審查,則不要再次詢問。

預覽:npx hyperframes preview

渲染...

Individual skills in this repo

This repo contains 13 individual skills — each has its own dedicated page.

1345AbhishekKumar/starter-nextjs

Add captions to a talking-head video. ONE catalog (CATALOG.md) of 32 visual identities behind two engines: column-flow (captions composited INTO the scene — matte occlusion + mix-blend; cream/ink/editorial/keynote/documentary/loud/neon/glitch/chrome/velocity) and themed constitutions (anchor/ordnance/terminal/neonsign/stardust/stomp/scoreboard/transit/vhs/arcade/dossier/laser/thunder/hologram/biolume/aurora/spectrum/papercut/popup/chalkboard/graffiti/brush/inkwater/ransom/lastpage/nightcity — e.g. a glyph-decode climax, a neon sign WRITTEN stroke by stroke, or the quiet `anchor` rail default). Route by identity, never by mode. Trigger on "captions/subtitles", "embed/cinematic captions", "VFX captions", "炸/特效/酷炫字幕", a named identity, or top-tier motion-graphics asks. Embedding every word is wrong for most talking-head content — `anchor` is the verbatim default. Pipeline: transcription → hyperframes remove-background matting → HTML render → ffmpeg overlay. Requires hyperframes and a single-subject clip.

1345AbhishekKumar/starter-nextjs

The fallback workflow for authoring custom HyperFrames video compositions at any length or format — longer or multi-scene pieces, brand / sizzle reels, montages, title cards, static loops, and freeform compositions. Input- and length-agnostic. If a specialized workflow clearly fits the input — a marketed product, a website, a topic explainer, a GitHub PR, existing footage, a short motion graphic, or a Remotion port — prefer it (see /hyperframes); use this only as the general fallback when none fit.

1345AbhishekKumar/starter-nextjs

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). HyperFrames-native: single paused timeline, seek-safe, deterministic.

1345AbhishekKumar/starter-nextjs

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, validate, inspect, layout, snapshot, preview, play, render, publish, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, or remove-background, or when troubleshooting the HyperFrames build/render environment. Entry point for AWS Lambda cloud rendering (`hyperframes lambda deploy / render / progress / destroy / policies`).

1345AbhishekKumar/starter-nextjs

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

1345AbhishekKumar/starter-nextjs

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

1345AbhishekKumar/starter-nextjs

Audio and media assets for HyperFrames compositions, produced by one shared audio engine (`scripts/audio.mjs`) — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), background music + sound effects (HeyGen audio-library retrieval by default, with local Lyria / MusicGen BGM generation and a bundled SFX library as the no-credential fallback), Whisper transcription, background removal, and caption authoring. Use for voiceover / TTS, BGM, SFX / sound effects, transcription, captions / subtitles / lyrics / karaoke / per-word styling, voice + provider selection, and music-mood prompting.

1345AbhishekKumar/starter-nextjs

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, registry discovery, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

1345AbhishekKumar/starter-nextjs

Use when the user wants a short, design-led motion graphic where motion is the message: kinetic typography, stat or number count-up, chart/data-viz hit, logo sting, brand lockup, lower-third, callout, social overlay, animated headline/tweet/news item, motion poster, or quick captured-page highlight. Usually under 10s and up to ~30s, with no narration arc, voice-over, or live-action subject. Can render to MP4 or transparent overlay. Not for longer, multi-scene, narrated, or brand-reel pieces (use general-video), narrated website videos (website-to-video), topic explainers (faceless-explainer), product promos (product-launch-video), PR videos (pr-to-video), or captions on existing footage (embedded-captions). When unsure whether it's a quick motion-first piece or a longer / narrated treatment, see /hyperframes.

1345AbhishekKumar/starter-nextjs

Use when the user has a music track (an audio file, or a video to pull audio from) and wants a beat-synced HyperFrames video, calm to hard-hitting. The music drives everything: one analyzer reads it once, the orchestrator lays out the frames and fills a per-frame plan, and one sub-agent builds each frame. Typography and templates are the floor — a complete video needs zero assets — but any images or videos the user supplies are cut into the frames on the same beat grid (beat-cut / ken-burns). The genre (lyric video, slideshow, kinetic promo) falls out of the per-frame choices; the pipeline never branches on it.

1345AbhishekKumar/starter-nextjs

turn a GitHub pull request (a PR URL like github.com/<owner>/<repo>/pull/<N>, an <owner>/<repo>#<N> ref, or 'this PR' in a checked-out repo) into a code-change explainer video, up to ~3 min (sweet spot 30-90s) — changelog, feature reveal, fix, or refactor walkthrough, rendered from the diff / commits / files. The input is a CODE CHANGE read via the gh CLI; there is no website capture. Use this skill for a GitHub PR. Do not use it for a product launch/promo (use /product-launch-video), a tour of a real website (use /website-to-video), a topic explainer with no PR (use /faceless-explainer), captions on existing footage (use /embedded-captions), or a short unnarrated motion graphic (use /motion-graphics). If the intent is unclear, route through /hyperframes first.

1345AbhishekKumar/starter-nextjs

Port an existing Remotion (React) composition to HyperFrames HTML. Use ONLY when the user explicitly asks to port/convert/migrate/translate a Remotion source. Do NOT use: (a) authoring a new HyperFrames composition; (b) Remotion mentioned in passing; (c) Remotion code shared as reference only; (d) "same video as my Remotion one" without explicit migrate request — treat as fresh build. Doubt → `/general-video`. One-way, Remotion-only: no reverse export (HyperFrames→Remotion or any framework), no non-Remotion source (After Effects, Framer Motion, plain React/CSS) → out of scope, re-create via `/general-video`. Flags unsupported patterns (useState, useEffect, async calculateMetadata, third-party React libs, `@remotion/lambda`) and recommends runtime interop over lossy translation. Unsure whether to port vs. build fresh, or only a passing Remotion mention? → /hyperframes.

1345AbhishekKumar/starter-nextjs

Capture a general website/URL and turn it into a HyperFrames video (site tour, showcase, or social clip from the site's own visuals). Uses headless Chrome screenshots + brand assets. Use when intent is general — portfolio/blog/landing-page showcase or social clip from the site. NOT for: product/SaaS launch or promo (→ /product-launch-video, even from a URL); topic explainer with no site (→ /faceless-explainer); GitHub PR (→ /pr-to-video); adding captions to existing video (→ /embedded-captions); short unnarrated page-highlight motion graphic (→ /motion-graphics). Unclear launch-vs-general-site? Ask one question or start at /hyperframes.

相關技能