Communitygithub.com

shivamsingh-007/Skill-is-All-you-Need

當你需要製作、創建、生成、編輯、動畫化或渲染任何影片、動畫、動態圖形、解說片、標題卡、疊加層或 HyperFrames HTML 組合時使用此技能。請勿用於瀏覽器自動化或與其他框架進行螢幕錄製。

Skill-is-All-you-Need 是什麼?

這是一個針對 HyperFrames 影片創作框架的入口技能,可作為路由器,將「幫我做一支影片」等意圖導向合適的專用工作流程,例如產品發布影片、無旁白解說片、網站轉影片、PR 轉影片、嵌入式字幕、圖形疊加層、動態圖形以及一般影片製作。此技能首先提供一個能力對應圖,將任務區分為核心 HTML 組合創作、動畫、創意指導、媒體預處理、CLI 開發循環和套件安裝——然後包含一個詳細的影片路由決策表,根據輸入類型(產品 URL、網站、GitHub PR、主題、現有影片)、目標長度和輸出類型(例如動態圖形與有旁白的解說片)來決定要執行哪個工作流程。路由邏輯強調確定性與自我包容性:渲染過程中不允許網路呼叫、Date.now() 或 Math.random(),現有影片僅能疊加而非編輯(不支援 NLE 風格的時間軸或色彩調整),而 Remotion 導入是單向的。此技能在 Claude Code、Cursor 和 Codex 等平台上運作,會解析使用者的意圖並提示足夠的資訊,以路由到正確的專門 HyperFrames 子技能,或在請求超出 HyperFrames 架構範圍時優雅地拒絕。

相容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/shivamsingh-007/Skill-is-All-you-Need/tree/HEAD/04-video-production/hyperframes

在你喜歡的 AI 中提問

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

說明文件

HyperFrames — 請先閱讀本文件

開始任何 HyperFrames 任務前請先閱讀此文件 — 特別是當專案中沒有代理程式設定檔 (CLAUDE.md / AGENTS.md / .cursorrules) 時。以下是能力對應表與影片路由器。

能力對應表 — 哪種意圖使用哪種技能

你想要…請前往
製作影片 (從網址、簡報、主題、GitHub PR、現有素材,或是一個需要動畫化的單一元素)下方的 影片路由器 (請參閱 § 影片路由)
創作 / 編輯 HTML 組合 — data-* 合約、片段、音軌、子組合、變數/hyperframes-core
動畫化 — 原子動作規則、場景藍圖、轉場、運行時適配器(GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU)/hyperframes-animation
創意指導 — design.md、色板、字體設計、旁白、節奏規劃、音訊反應式設計/hyperframes-creative
媒體預處理 — TTS 配音、背景音樂、轉寫、去背、字幕/hyperframes-media
CLI 開發循環 — 初始化、檢查、驗證、預覽、渲染、發布、診斷/hyperframes-cli
安裝套件組件 (hyperframes add)/hyperframes-registry

組合創作合約 (每個時間元素需要 data-start / data-duration / data-track-index;時間元素需要 class="clip";GSAP 時間軸需要暫停並註冊在 window.__timelines 上;僅允許確定性邏輯 — 禁止使用 Date.now() / Math.random() / 網路)此處不重複 — 它存在於 /hyperframes-core 中。在撰寫組合 HTML 之前,請務必閱讀該文件。

HyperFrames 無法做到的事 — 請優先檢查此清單

HyperFrames 透過程式碼創作 HTML 組合並將其渲染成 MP4。這個模型有嚴格的邊界。當請求超出其中一項限制時,這不是路由選擇的問題 — 而是超出範圍,因此請婉拒(或指出正確的工具),而不是嘗試執行某個工作流程。以下限制源於其架構,並非來自單一請求:

  • 渲染是確定性且自包含的。 每一個數值、資源和文字片段在創作時就已嵌入;渲染過程不進行任何網路呼叫,也不進行即時 / 渲染時的資料拉取(核心規則:禁止 Date.now() / Math.random() / 網路)。「在渲染時即時更新數字」是不允許的 — 請在創作時一次性擷取資料並嵌入,否則請婉拒。
  • 現有影片只能疊加,不能編輯。 HyperFrames 會在來源片段之上組合影格 — /embedded-captions 添加字幕層,/graphic-overlays 添加設計好的圖形卡片(下方三分之一、數據引用、標題)— 底下的片段會保持不變地播放,但無法後製處理已編碼的影片串流。改變素材本身(其時間、色彩、構圖、順序或音訊)屬於 NLE 風格編輯,超出範圍。
  • Remotion 導入是單向的。 /remotion-to-hyperframes 會將 Remotion 框架的 原始碼轉換為 HyperFrames。沒有逆向轉換(HyperFrames → Remotion,或 → 任何其他框架 — 超出範圍),且非 Remotion 的 React / 網頁動畫原始碼沒有 Remotion 原始碼可轉換 — 請透過 /general-video 重新建立。
  • 無法產生不存在的輸入內容。 無法進行螢幕 / 會話錄製、攝影機捕捉、AI 談話頭像 / 嘴型同步虛擬角色生成。如果素材或資源尚不存在,HyperFrames 無法憑空創造 — 請先要求使用者提供(或使用正確的捕捉工具)。

除此之外的所有內容 — 來自網址、簡報、主題、PR、待標註的素材,或是需要動畫化的單一元素 — 皆在範圍內;請按下方方式路由。


影片路由

此部分僅了解頂層工作流程。它不會載入工作流程內部的階段、領域技能(hyperframes-* — 請參閱上面的能力對應表)或技術參考文件。

決策表

INPUT 類型(意圖)是主要軸線;OUTPUT 長度僅為上限,而非閘門。 對於匹配的輸入,專門的工作流程可以處理最多約 3 分鐘 的內容 — 選擇哪個 工作流程是由意圖(輸入類型,以及對於文字來說的主題)決定,而非長度。長度僅在頂端才有影響:真正較長的內容(3-5 分鐘的教學、5 分鐘以上的深度探討)屬於不同的領域,應路由到 /general-video。在 ≤~3 分鐘的範圍內,第三個軸線將兩個以文字為輸入的工作流程分開 — 主題:是正在行銷的產品,還是正在解釋的主題(請參閱下方步驟 3 中的消歧規則)。

長度 / 輸入產品發布(網址 / 簡報 / 腳本)一般網站 / URLGitHub PR / 程式碼變更主題 / 文章 / 筆記(無產品,無網址)現有影片(談話頭像)†
≤ ~3 分鐘/product-launch-video/website-to-video/pr-to-video/faceless-explainer/embedded-captions · /graphic-overlays †
3-5 分鐘教學/general-video/general-video/general-video/general-video/embedded-captions · /graphic-overlays †
5 分鐘以上深度探討/general-video/general-video/general-video/general-video/embedded-captions · /graphic-overlays †
靜態 / 循環/general-video/general-video/general-video/general-video/general-video

目前的涵蓋範圍:≤ ~3 分鐘 的範圍針對產品發布 / 一般網站 / GitHub-PR / 主題輸入有專門的工作流程(網址會依據_類型_ 再依_意圖_ 拆分 — 請參閱步驟 3),而現有影片欄位在任何長度下都由 /embedded-captions(字幕 / 隱藏式字幕)或 /graphic-overlays(設計好的圖形疊加層)涵蓋,依據意圖拆分(請參閱步驟 2)。所有其他儲存格都是 /general-video — 通用的 HTML 組合創作流程(輸入和長度無關):所有超過 ~3 分鐘 的內容(3-5 分鐘 / 5 分鐘以上行)以及每種靜態 / 循環格式。路由器永遠不會因為可創作的影片而走入死胡同;唯一真正的「一般 / 無」答案是超出 HyperFrames 本身的請求(例如 NLE 風格編輯已完成的影片檔案 — 重新計時、重新著色、重新構圖、重新排序、音訊)。

† 現有素材依據意圖拆分,而非長度。 字幕 / 隱藏式字幕 → /embedded-captions;設計好的圖形疊加層 / 包裝 — 下方三分之一、數據引用、標題卡片、引言 — → /graphic-overlays。兩者都疊加在片段之上,底下的片段會保持不變地播放;兩者都不編輯素材本身。

類型短路(優先於上表)。 一個簡短(約少於 10 秒)、無旁白、以設計為主導的動態圖形 — 動態字體、統計 / 圖表呈現、標誌動畫、下方三分之一 / 疊加層,或是一個動畫推文 / 標題 / 已捕捉頁面重點 — 無論輸入為何,都路由到 /motion-graphics。這是一個 OUTPUT 類型,而非輸入類型,因此當要求很明顯是動態優先且無旁白時(請參閱步驟 2),它會優先於上面的輸入類型表。一個較長或有旁白的處理方式則不屬於此(請依輸入類型路由,或使用 /general-video)。

遷移現有組合(特殊情況)

上表適用於從輸入創作影片。有一個工作流程不在此表中:如果使用者明確要求將現有的 Remotion (React) 組合移植 / 轉換 / 遷移到 HyperFrames → /remotion-to-hyperframes。這是原始碼翻譯,而非從輸入創作,因此沒有 INPUT × LENGTH 儲存格。僅在明確的遷移用詞(「移植我的 Remotion 專案」、「轉換這個 Remotion 組合」、「將其重寫為 HyperFrames」)時路由至此 — 隨口提到 Remotion 並不觸發;預設使用創作表或 /hyperframes-core。

路由程序

  1. 確定 INPUT 類型 + 目標長度。 路由需要知道影片的內容 — 其主題和輸入。如果主題本身未指定(例如「製作一個關於我們產品的影片」沒有網址、命名產品、主題或素材可用),或輸入類型未知,請在進入任何工作流程之前詢問 — 先釐清;不要呼叫工作流程技能然後再問,因為承諾一個工作流程本身就是路由決策。最多問 2 個釐清問題:
    • 「您的輸入是什麼——產品(網址或簡報)、一般網站 / URL、GitHub PR / 程式碼變更、要解釋的主題或文章,還是要添加字幕的現有談話頭像影片?」
    • 「目標長度——大約 3 分鐘或以下,還是更長(3-5 分鐘的教學 / 5 分鐘以上的深度探討)?」
    • 規格預設值——直接說明,不要問(這些不影響路由,所以永遠不要因為它們而阻塞路由):比例 16:9(引擎也支援 9:16 直式 — 僅在使用者指定直式目的地如 TikTok / Reels / Shorts 時才切換);旁白 / 字幕語言 = 使用者的語言。僅在使用者提出異議時才確認;所選擇的工作流程會在其步驟 0 重新確認其自身的規格。
  2. 先依 INPUT 類型(意圖)選擇;長度僅為上限,而非閘門。
    • 簡短、以設計為主導的動態圖形(類型短路,優先於輸入表) — 動畫本身就是訊息:動態字體、統計 / 數字遞增、圖表呈現、標誌動畫、下方三分之一 / 疊加層,或是一個動畫推文 / 標題 / 已捕捉頁面重點;通常少於 ~10 秒,無旁白 / 配音 → /motion-graphics。這是 OUTPUT 類型,而非輸入類型 — 當要求很明顯是一個快速、無旁白、以設計為主導的動畫作品時,無論輸入為何都路由至此。一個較長或有旁白的同主題處理方式則不屬於此(請依輸入類型路由,或使用 /general-video)。
    • 現有談話頭像影片(使用者有一個片段並希望在其上添加內容)→ 依據意圖拆分,任何長度(輸入類型優先於長度):字幕 / 隱藏式字幕(口語文字轉換為可讀文字)→ /embedded-captions;設計好的圖形疊加層 — 下方三分之一、數據引用、有標題的資訊卡、引言、圖形包裝編輯 → /graphic-overlays。(編輯素材_本身_ — 重新計時、重新著色、重新構圖、重新排序、音訊 — 屬於 NLE 風格,超出範圍;請參閱 § HyperFrames 無法做到的事。)
    • GitHub PR / 程式碼變更(一個 github.com/<owner>/<repo>/pull/<N> 連結、一個 owner/repo#N 參照,或「這個 PR」)→ /pr-to-video(最多 ~3 分鐘)。
    • 其他情況(產品網址 / 簡報 / 主題文字):意圖透過步驟 3 選擇工作流程,並且它可以處理最多 ~3 分鐘 的內容 — 一個 15-30 秒的短片和一個 ~100 秒的解說片都依據意圖而非長度路由。僅在目標明顯超過 ~3 分鐘(一個 3-5 分鐘的教學、一個 5 分鐘以上的深度探討)時,才路由到 /general-video(長度無關的後備方案 — 請參閱步驟 4)。切勿將真正較長的內容強行塞入 ≤~3 分鐘的工作流程 — 意圖決定範圍內的選擇,/general-video 涵蓋其餘部分。
  3. 消歧 ≤~3 分鐘的 URL / 文字輸入(意圖拆分)。 兩種拆分:
    • URL 類型 + 意圖 — 網址不再自動贏得 PLV;其_類型_ 再依_意圖_ 決定:一個 GitHub PR 連結(.../pull/<N>、owner/repo#N、「這個 PR」)→ /pr-to-video;否則一個網站網址依意圖拆分 — 行銷 / 發布 / 推廣特定產品或 SaaS → /product-launch-video;一個一般網站 → 影片(網站導覽、作品集 / 部落格 / 登陸頁面展示、來自網站本身視覺效果的社交片段,或只是「將這個網站變成影片」)→ /website-to-video。兩者都使用 headless Chrome 爬取;PR 網址是

相關技能