Communitygithub.com

一般影片 (General Video)

使用 Hyperframes 框架處理從簡單編輯到多場景敘事的影片製作工作流程,提供結構化的開發路徑與專業級的結果。

一般影片 (General Video) 是什麼?

「一般影片」技能是為 Hyperframes 框架設計的一套嚴謹且全面的影片製作工作流程,旨在統一處理從簡單編輯到複雜多場景敘事的各種專案。該技能強制要求開發者在特定階段載入正確的知識庫(如 `/hyperframes-core`、`/hyperframes-creative` 和 `/media-use`),以避免幻覺並確保產出品質。它支援兩種工作模式:`automation`(自動化,由 AI 完全驅動)和 `companion`(協作模式,AI 作為「導演」提供頂級創意方案)。工作流程包含四個嚴格定義的階段:「套用跨領域轉接器」、「從專案狀態啟動」、「解讀執行形狀」和「執行組合」,並內建了草稿審查、資產管理和偏好記錄機制。此技能特別強調利用結構化的檔案(如 `BRIEF.md` 和 `STORYBOARD.md`)來管理專案意圖,並透過引用特定的配方和藍圖(來自 `/hyperframes-animation`)來實現動畫和過場效果,從而將創意過程與技術實現緊密結合。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/jasonfast123/hyperframes-skills/tree/main/skills/general-video

在你喜歡的 AI 中提問

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

說明文件

一般影片 (General Video) 是做什麼的?

在依賴此工作流程之前,請執行:

npx hyperframes skills update general-video

成功的空操作表示技能已是最新。若更新失敗,請直接顯示錯誤訊息,不要根據記憶繼續執行。

1. 套用跨領域的資料來源轉接器 (Apply cross-cutting source adapters)

  • 媒體 (Media): 對於任何音訊、圖片、圖示、標誌、語音、調色、LUT、特效/風格、字幕或媒體操作需求,載入 /media-use,並遵循 ../media-use/references/resolve.md(解析、採用、重用)和 ../media-use/references/setup-providers.md(提供者、驗證)中的指示。對於模糊的素材回饋和具名樣式,請在編輯前使用 ../media-use/references/media-treatments.md;請勿即興使用 CSS/SVG/透明度的方式來模擬支援的媒體效果。在執行第一個需要驗證的提供者操作之前,請先執行 npx hyperframes auth status 並逐字輸出其結果。如果顯示未登入,則套用 ../hyperframes-core/references/brief-contract.md 中的閘門規則:協作模式等待登入或明確的離線選擇;自動化模式則陳述狀態並繼續透過可用的離線提供者進行。當沒有任何離線提供者能夠滿足所需功能時,應顯示阻擋訊息。僅使用本地資源的採用不需要驗證閘門。
  • Figma: 如果任何輸入是 figma.com 的 URL,請先執行 /figma。根據其導出的素材、令牌、元件或分鏡畫面來建構。請勿直接呼叫 Figma 連接器,因為它們會繞過 SVG 清理、媒體來源追溯和品牌令牌繫結。

這些轉接器不會改變 /hyperframes 所選定的工作流程。

2. 從專案狀態開始 (Start from project state)

套用第一個符合的狀態列;不要評估較低優先級的狀態列:

狀態 (State)行動 (Action)
特定編輯 (Specific edit)進行編輯,保留現有的專案決策,然後重新執行受影響的檢查。不要重新開啟探索階段。
BRIEF.md 存在讀取它。如果 workflow 指向另一個工作流程且 flow 不是 companion,則移交控制權。不要詢問簡報問題。
無簡報,但 hyperframes.json 或 STORYBOARD.md 存在從檔案和記錄的偏好設定中恢復。僅根據已知事實回溯填寫 BRIEF.md。
全新建立 (Fresh creation)執行 /hyperframes 及其意圖層。僅在 workflow: general-video 或 flow: companion 時返回此處。

對於新專案,從簡報中選擇一個符合 kebab-case 命名規則的目錄名稱,並在撰寫簡報前建立專案結構:

npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=general-video

然後在專案根目錄使用 ../hyperframes-core/references/brief-format.md 撰寫 BRIEF.md。在現有專案中,根目錄是包含 hyperframes.json 的目錄。僅記錄由簡報格式指定的、已確認且支援偏好設定的欄位,使用 node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes <PROJECT_ROOT>;切勿記錄推斷的預設值。此處 <MEDIA_DIR> 是已安裝的 /media-use 技能目錄,<PROJECT_ROOT> 是包含 hyperframes.json 的目錄。如果意圖層採用了某個配方,請立即使用 node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes <PROJECT_ROOT> --name <name> 套用它,並且不要再詢問。

3. 解讀執行形狀 (Interpret the run shape)

僅使用 ../hyperframes-core/references/brief-contract.md 中的規範術語:

欄位 (Field)含義 (Meaning)效果 (Effect)
flow由誰驅動 (Who drives)automation: 選擇並執行路徑。companion: 在對話中共同創作。
storyboard分鏡版是否為審查介面 (Whether the board is a review surface)yes: 執行計畫與草稿審查。no: 不透過分鏡版直接建構。
派生 mode檢查點閘門的行為 (How checkpoint gates behave)遵循簡報合約。切勿要求使用者命名模式。

請不要為這些狀態發明同義詞。持續的「只管建構」訊號由意圖層處理,並以 flow: automation, storyboard: no 的形式傳入。

  • 對於 flow: automation,選擇路徑並在第一次進度更新中一行陳述。
  • 對於特定編輯,直接進行編輯,不要發明新路徑。

對於現有素材的硬切、修剪、拼接或重新排序,請將同一影片來源複製為多個片段元素。在每個副本上,使用 data-media-start 加上 data-duration 設定來源範圍,然後使用 data-start 設定編排位置/順序。單獨編排的音訊遵循相同的片段範圍和時序,並套用在對應的 <audio> 元素上。/hyperframes-core 負責此類時間編輯;僅在需要視覺屬性動畫(例如在內部包裝器上進行縮放、推鏡、平移、裁切、遮罩或 clip-path)時才使用 /hyperframes-keyframes。 從 ../hyperframes-core/references/creator-editing-recipes.md 複製完整的合約。

協作流程 (Companion flow)

當 flow: companion 時:

  • 讀取 BRIEF.md,並將已接受的 ## Assets 和 ## Customizations 與專案當前產出進行比對。完成已接受但仍待處理的工作;跳過已完成的工作;不要將已接受的功能再次當作新提議提出。
  • 以導演的身份到來,而非承包商。 選擇協作模式的用戶選擇了參與度和品質;誠實的回應是你所能設計的最佳版本,而非最易於辯護的最小版本。第一個計畫應該是天花板方案:故事弧線(借用最近的類型鏡頭——選單 § 類型鏡頭)、設計規格、每個場景引用其名稱的動作處理(§ 5 的計畫規範)、轉場、音訊識別——音樂和聲音標記,或刻意的沉默——放置用戶的素材,以及設計好的開場和結尾。用一句話說明每個層級增加什麼;標註昂貴的部分(渲染時間、登入、計費)。用戶是修剪方案,而不是逐項批准地拼湊方案。
  • 天花板屬於概念,而非工具箱。 每個層級都必須服務簡報的訊息——一個可以以相同方式裝扮任何影片的方案只是裝飾。工藝應達到天花板;內容絕不能超出所要求的範圍(§ 6)。
  • 在檢查點之間,../hyperframes/references/capability-menu.md 有兩種作用方式。作為觸發列表:當用戶提及某個功能的輸入,或建構過程達到其需求時,提供相關的功能。作為每次迭代的升級通道:一個計畫、草稿或建構檢查點可能附帶一兩個追蹤到的提議,指向用戶正在觀看的材料(「場景 3 的統計資料想要計數處理」)。在提供之前先閱讀它;切勿傾倒整個目錄。
  • 用戶接受某個功能後,立即產出成果,並將決策記錄到匹配的 BRIEF.md 正文部分。僅當用戶明確變更時,才重寫 frontmatter 欄位並記錄已確認的偏好設定。
  • 保持相同的分鏡版、驗證、最終預覽和渲染核准閘門。協作模式改變的是誰掌舵,而不是品質需要什麼。

4. 在每個階段前載入必需的知識 (Load required knowledge before each stage)

當條件匹配時,這些讀取是強制性的:

條件 (Condition)在行動前讀取 (Read before acting)
任何組合 HTML 或場景佈局/hyperframes-core;使用 references/determinism-rules.md 了解其佈局合約
任何非平凡的創作或視覺處理/hyperframes-creative → references/house-style.md 和 references/video-composition.md
任何動作、動畫或場景轉場/hyperframes-animation;遵循其路由到匹配的規則、轉接器、藍圖或轉場參考
storyboard: yes../hyperframes-core/references/storyboard-format.md 和 ../hyperframes-core/references/review-loop.md
任何媒體素材或操作,包括旁白、背景音樂、音效、字幕、調色或轉換/media-use;對於框架播放和放置,也需閱讀 /hyperframes-core → references/variables-and-media.md
多場景組合../hyperframes-core/references/production-loop.md
flow: companion,在第一次計畫之前/hyperframes-creative → references/story-spine.md 和 references/house-style.md;最近的類型鏡頭和完整的 ../hyperframes/references/capability-menu.md —— 天花板方案是據此設計的,而非回憶
一個協作功能提議、捕捉、節拍網格、生成式影片、地圖、發佈或跨工作流程功能../hyperframes/references/capability-menu.md
存在設計規格,在最終核准之前/hyperframes-creative → references/design-adherence.md

不要用回憶取代這些讀取操作。漸進式揭露僅在實際載入匹配的參考時才能節省上下文空間。

5. 執行組合 (Execute the composition)

使用以下依賴順序。僅當某階段的輸入不存在時才跳過它。

  1. 計畫 (Plan). 陳述觀眾的觀看弧線、結構、節奏和持續時間驅動因素。對於簡短的單一場景,使用一個檔案;對於三個或更多硬場景切換或任何重複使用的場景,使用子組合。閱讀 /hyperframes-creative → references/story-spine.md 了解敘事弧線,references/beat-direction.md 了解節奏,以及 /hyperframes-core → references/composition-patterns.md 了解結構。對於開放式的多場景簡報,透過 /hyperframes-creative → references/prompt-expansion.md 擴展提示。多場景計畫會引用每個場景的形狀:當適用時,引用 /hyperframes-animation → blueprints-index.md 中的藍圖 ID,或當不適用時,引用其從 rules-index.md 組合而成的具名規則——動作名稱必須來自這些索引,絕不能發明。故事的真相決定了哪些場景存在;引用只是為它們「穿上衣服」。多場景計畫也會被記錄為調度產出:在 STORYBOARD.md 中為每個場景建立一個 ## Frame N 區塊——status: outline,一個聲明的 src:,藍圖/規則引用,以及節拍文字——即使當 storyboard: no 時也是如此。該區塊是調度單位;分鏡版僅是審查介面。

  2. 應要求審查計畫 (Review the plan when requested). 對於 storyboard: yes,透過這些區塊執行共享的審查循環。對於 storyboard: no,繼續執行而不開啟分鏡版。如果無論如何發生了計畫暫停,將子代理委派授權(步驟 4 的調度需要)合併到該暫停中,而不是稍後再次停止。

  3. 解析依賴項 (Resolve dependencies). 在並行工作前安裝註冊表區塊。暫存用戶素材,採用現有媒體,僅解析簡報要求的內容。當音訊時序驅動持續時間時,及早啟動音訊。

  4. 建構場景 (Build scenes). 對於簡短的單一場景作品,在加入動畫之前,先在其實現最顯眼的時刻實現場景(當存在已確認的線框時,該線框就是最終狀態,不得重繪),然後根據引用的藍圖或規則進行動畫——在撰寫動畫之前閱讀完整的配方主體(/hyperframes-animation → blueprints/<id>.md, rules/<id>.md)。

    僅在大規模場景下,調度才物有所值。 編寫數據包和預熱新的工作上下文需要花費實際的分鐘數和令牌數:一部最多約 6 個短場景的電影,在此上下文中,一個接一個地內聯建構會更快(實測:5 個短場景 ≈ 9...

...(原文已截斷)

Individual skills in this repo

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

embedded-captions

>

faceless-explainer

Turn arbitrary text — an article, notes, a topic, a brief — into a faceless explainer video: there is no site or footage to capture, so the visuals are invented per scene (typography, abstract graphics, diagrams, data-viz). Use for topic explainers, concept breakdowns, how-tos, listicles. Not a video built from a website (/product-launch-video — promo or tour). Unclear → /hyperframes.

figma

Import Figma content into a HyperFrames composition — rendered assets, brand tokens, components, storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI), connector-assisted motion when available, and shaders from a connector or native export. Use when the user pastes a figma.com link or asks to bring a Figma design, frame, logo, brand, or animation into a video/composition.

hyperframes

>

hyperframes-animation

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). Also covers auditing an existing composition

hyperframes-audio

>

hyperframes-cli

>

hyperframes-core

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class=

hyperframes-creative

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`.

hyperframes-keyframes

>

hyperframes-registry

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

jasonfast123/hyperframes-skills

Import Figma content into a HyperFrames composition — rendered assets, brand tokens, components, storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI), connector-assisted motion when available, and shaders from a connector or native export. Use when the user pastes a figma.com link or asks to bring a Figma design, frame, logo, brand, or animation into a video/composition.

media-use

Agent Media OS, the single skill for every media need in a HyperFrames project. Resolve BGM, SFX, image, icon, brand logo, voice, color grade, or LUT into a frozen local file or paste-ready block + ledger record (one verb, `resolve`); generate via TTS / music / image models when the catalog misses; produce voiceover, transcription, captions, and background removal through one shared audio engine; operate on media (cut / reframe / transform); and reuse assets across projects. Also use for vague feedback that real footage looks dark, flat, boring, should feel retro/camcorder/print/ASCII, needs privacy, or needs a media reveal.

motion-graphics

>

music-to-video

Turn a music track (an audio file, a video to pull audio from, or a track generated from a mood brief) into a beat-synced video — lyric video, slideshow, or kinetic promo. The music drives all pacing; any user-supplied images/videos are cut onto the same beat grid, and a complete video needs zero assets. Narrated pieces → the input-matched workflow (see /hyperframes). Unclear → /hyperframes.

pr-to-video

Turn a GitHub pull request (a PR URL, owner/repo#N, or

remotion-to-hyperframes

Port an existing Remotion (React) composition

slideshow

>

talking-head-recut

Package an existing talking-head / interview / podcast video with timed, designed GRAPHIC OVERLAY cards — kinetic titles, lower-thirds, data callouts, quotes, side panels, picture-in-picture — synced to the transcript, on a 16:9 / 9:16 / 4:5 canvas of your choice; the clip plays untouched underneath. Trigger on

相關技能