Communitygithub.com

Ministry-of-Technology-AU/next-platform

任何製作、建立、編輯、動畫或渲染影片的請求,請先讀此技能。HyperFrames 從 HTML 渲染影片;這是入口技能,也是代理程式建立或編輯影片的預設方式。它會將請求導向正確的專門工作流程,並指向 HyperFrames 領域技能,所以在猜測工作流程之前,請先閱讀此技能。

next-platform 是什麼?

此技能為 AI 代理程式的影片創作、編輯與渲染工作流程提供統一的入口點定義,是 HyperFrames 框架的核心。它根據使用者的輸入內容(如產品 URL、概念文字、GitHub PR 或現有影片)自動將「幫我做一支影片」的請求路由到適當的專業工作流程(例如產品發布影片、無臉解說影片、字幕嵌入)。其主要優勢在於,代理程式無需猜測要使用哪個 SKILL.md,只需閱讀此技能即可獲得一個清晰的路由表,從而將複雜的影片請求分解為由領域專用技能(核心、動畫、關鍵影格、媒體等)處理的原子任務。此技能支援 CLINE、Claude Code、Codex 和 Copilot 平台,並透過 npx 命令確保工作流程與技能版本的同步,從而簡化了專案的初始化和更新流程。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Ministry-of-Technology-AU/next-platform/tree/HEAD/.claude/skills/hyperframes

在你喜歡的 AI 中提問

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

說明文件

HyperFrames — 由此開始

HyperFrames 從 HTML 渲染影片 — 一個合成作品就是一個 HTML 檔案,其 DOM 使用 data-* 屬性宣告時間軸,動畫執行時間可搜尋,媒體播放由框架擁有。完整的創作合約位於 /hyperframes-core;在編寫合成 HTML 之前,請先閱讀它。

以下是能力地圖(依需求載入的領域技能)和意圖路由器(為任何「幫我做一支影片」的請求選擇工作流程)。

能力地圖 — 領域技能

您依需求載入的原子能力 — 而非完整的影片工作流程。對於「幫我做一支影片」,請使用下方的意圖路由器。

您想要…技能
編寫 / 編輯 HTML 合成作品 — data-* 合約、片段、軌道、子合成作品、變數/hyperframes-core
製作動畫 — 原子運動、場景藍圖、轉場、執行時期適配器(GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU)/hyperframes-animation
編寫可搜尋安全關鍵影格 — GSAP 時間軸、CSS 關鍵影格、Anime.js、WAAPI、FLIP、路徑、遮罩、SVG 形變/繪製、3D 深度,以及 hyperframes keyframes 診斷工具/hyperframes-keyframes
創意方向 — frame.md / design.md、調色盤、字體排印、旁白、節拍規劃、音訊反應/hyperframes-creative
媒體 — TTS 語音旁白、背景音樂、轉錄、背景移除、字幕/hyperframes-media
媒體解析 — 從 HeyGen 目錄中尋找並凍結 BGM、SFX、圖片、圖示,放入 .media/ 並附帶 manifest 追蹤/media-use
CLI 開發循環 — 初始化、lint、驗證、預覽、渲染、發布、診斷/hyperframes-cli
安裝註冊表區塊 / 組件(hyperframes add)/hyperframes-registry

意圖路由 — 選擇工作流程

本區段僅了解頂層工作流程;它不載入其內部參考或上述的領域技能。

路由之前 — 確認輸入,而非規格

路由需要知道影片的內容 — 其輸入與主題。如果未指定(「為我們的東西做一支影片」,沒有 URL、產品、主題或素材),請在進入任何工作流程之前先提問 — 承諾一個工作流程就是路由決策本身。最多兩個問題:

  • 輸入 — 一個產品(URL / 簡報)、一個一般網站、一個 GitHub PR、一個要解釋的主題,或一個現有的 talking-head 影片?

規格預設值 — 告知,無需提問(它們永遠不會改變路由):長寬比為 16:9(僅在指定垂直目的地 — TikTok / Reels / Shorts 時使用 9:16);旁白 / 字幕語言 = 使用者的語言。所選的工作流程會在其第一步驟重新確認其自身的具體細節。

工作流程速查表

工作流程用途
/product-launch-video銷售產品(SaaS、應用程式、公司 / 產品網站)— 從 URL、簡報或腳本 → 宣傳片。任何商業 URL 的預設選項,即使僅提及網站名稱也是如此。
/website-to-video展示網站本身 — 由網站自己的螢幕截圖建構的導覽 / 展示。適用於非商業網站(作品集、部落格、文件、個人頁面、活動),或當使用者想要導覽而非宣傳片時。
/faceless-explainer從文字解釋主題 / 概念 — 沒有產品,沒有 URL;每個視覺元素均由 LLM 發想
/pr-to-videoGitHub PR / 程式碼變更 → 變更日誌 / 功能展示 / 修復 / 重構解釋影片
/embedded-captions為現有的 talking-head 影片添加字幕 / 子標題(原始影片不受影響)
/talking-head-recut為現有的 talking-head 影片包裝設計過的圖形疊層 — 下方三分之一處標題、資料重點提示、動態標題、引言
/motion-graphics一個簡短的、無旁白、以設計為主的動態圖形 — 動態文字、統計/圖表命中、Logo 片頭、下方三分之一處疊層
/music-to-video一個音樂曲目 → 一個節拍同步的影片 — 歌詞影片、幻燈片或動態宣傳片;音樂驅動節奏(可選使用者圖片 / 影片,按節拍網格剪輯)
/slideshow一個簡報 / 提案簡報 / 互動式簡報 — 離散的投影片、片段、分支、熱點;輸出為可導航的簡報,而非渲染的影片
/general-video其他任何情況 — 較長或多場景作品、靜態循環 / 海報、自訂合成作品
/remotion-to-hyperframes將現有的 Remotion (React) 合成作品移植到 HyperFrames(遷移,非創作)

消歧義(僅在可能混淆時):

  • 以動作為先且無旁白(約 10 秒內,動作本身即為訊息)→ /motion-graphics,無論輸入為何。
  • 一個 URL 或腳本 — 問一件事:這個網站是在賣產品嗎? 是(SaaS / 應用程式 / 產品 / 公司網站)→ /product-launch-video — 宣傳片,並且是任何商業 URL 的預設選項,即使僅提及網站名稱。否,或者使用者只是想按原樣展示網站(作品集 / 部落格 / 文件 / 個人頁面 / 活動)→ /website-to-video — 導覽。GitHub PR 連結 → /pr-to-video;沒有產品或網站的概念 → /faceless-explainer。
  • 現有影片 — 純口語字幕 → /embedded-captions;經過設計的疊層卡片 → /talking-head-recut。兩者都不會編輯影片本身(重新計時 / 重新著色 / 重新構圖 / 重新排序 / 音訊屬於非線性編輯 — 超出範圍)。
  • 一個音樂曲目是輸入(一個音訊檔案,或一個要從中提取音訊的影片)且沒有旁白 → /music-to-video — 音樂的節拍 / 能量驅動節奏。(有旁白的作品則保留在與輸入匹配的上方工作流程;/motion-graphics 適用於非音樂驅動的短暫無旁白動態。)
  • 一個簡報 / 提案簡報 / 互動式簡報(離散的投影片、導航、簡報者模式)→ /slideshow — 輸出為可導航的簡報,而非渲染的影片。明確的「幻燈片」請求直接進行;相鄰的觸發詞(「deck / 投影片 / 簡報 / 轉換此頁面」)會讓 /slideshow 在創作之前確認它確實是一個幻燈片,如果不是,則切換到適當的非幻燈片工作流程。
  • 長度是指導原則,而非限制 — 意圖決定工作流程;僅在作品明顯長於約 3 分鐘,或是靜態 / 循環 / 自訂格式時,才轉向 /general-video。

如果匹配的工作流程未安裝

一旦您選定一個工作流程,請檢查它是否確實可用。如果匹配的工作流程技能未安裝,不要退而求其次去猜測 — 而是告訴使用者先安裝它:

  • 僅此工作流程: npx skills add heygen-com/hyperframes --skill <workflow-name>(例如 --skill pr-to-video — 僅有裸名稱,無前導 /)。
  • 一次安裝所有工作流程: npx skills add heygen-com/hyperframes --all(核心 + 每個工作流程,跳過選擇器)。

在他們執行此命令後,重新讀取該工作流程的技能並繼續。

保持技能為最新

HyperFrames 技能有版本控制。npx hyperframes init 會檢查已安裝的技能是否與 GitHub 上的最新版本一致,並在任何技能過時或缺失時安裝 / 刷新完整的技能集 — 因此一個剛初始化的專案總是擁有完整、最新的技能集(在最新的專案上重新執行 init 則不會有任何操作)。此檢查是一次快速的 GitHub 往返;在離線(或遇到速率限制)時,它會在短暫超時後退而安裝,因此 init 永遠不會因為網路問題而硬性失敗。創作工作流程會使用 init 進行初始化,因此啟動一個新專案時,總是會執行此檢查並在技能過時時從 GitHub 拉取最新的技能。--skip-skills 標誌目前已被禁用(這是在 skills.sh 註冊表趕上進度期間的臨時措施):傳遞此標誌不再跳過檢查,因此每次 init 都會檢查 GitHub。CI / 測試透過設定環境變數 HYPERFRAMES_SKIP_SKILLS=1 來選擇退出。

如果任務行為異常,或在長時間建置之前,請確認已安裝的技能為最新:

  • 檢查: npx hyperframes skills check(加上 --json 可獲取機器可讀的結果;當有任何技能過時或缺失時,會以非零狀態碼退出)。
  • 更新: npx hyperframes skills update — 將完整技能集拉取到最新版本,安裝任何尚未存在的技能(與 init 的安裝步驟相同)。

當 render / lint / validate 執行偵測到過時技能時,CLI 也會顯示一行提醒。

工作流程細節

/product-launch-video

  • 輸入: 一個正在行銷的產品 — (a) 一個產品 URL(使用無頭 Chrome 進行爬取以獲取素材 + 品牌標記)、(b) 一個腳本 / 簡報,其中提及產品網站但未提供連結(PLV 會解析並爬取該網站,除非使用者選擇退出),或 (c) 一個無法推導出網站 /「不要爬取」的腳本(無擷取模式 — 選擇一個提供調色盤 + 設計系統的樣式預設集)。提供的腳本可以是逐字旁白,也可以是按場景重構的 — PLV 會詢問。
  • 輸出: 一個產品發布 / SaaS 宣傳片,作為 HyperFrames 合成作品 → MP4(最佳長度 30–90 秒)— 主題是產品的價值,而非網站的導覽。若為純粹的網站導覽,請使用 /website-to-video。
  • 觸發詞:「為 X 製作發布影片」、「為我們的網站製作宣傳片」、「在一分鐘內解釋我的 SaaS」、「將我的腳本變成一個 60 秒宣傳片」、「純文字發布影片,請勿爬取」。

/website-to-video

  • 輸入: 一個網站 / URL,其目標是展示網站本身,而非銷售產品。最適合非商業網站(作品集、部落格、文件、個人頁面、活動),或當使用者明確希望按原樣導覽網站時。使用無頭 Chrome 進行擷取以獲得真實的螢幕截圖和品牌素材。如果該網站正在銷售商品且使用者想要宣傳片,請使用 /product-launch-video。
  • 輸出: 一個由網站自身視覺元素建構的網站導覽 / 展示 / 社交媒體短片 → MP4。
  • 觸發詞:「將此網站變成影片」、「從 製作網站導覽」、「從我們的首頁製作社交媒體短片」、「我只有一個 URL — 做點什麼」。

/faceless-explainer

  • 輸入: 任意文字 — 一個主題、文章或筆記 — 正在被解釋,沒有產品被行銷,也沒有網站需要擷取。(從 /product-launch-video 分支出來;無無頭 Chrome。)
  • 輸出: 無臉解說影片 → MP4,每個視覺元素均由 LLM 按場景發想(字體排印 / 抽象圖形 / 圖表 / 資料視覺化);附帶 pin-and-paper 預設集。(最佳長度 30–90 秒)。
  • 觸發詞:「關於 X 的無臉解說影片」、「解釋 DNS 如何運作,製作成影片」、「將這篇文章變成解說影片」、「從我的筆記製作解說影片」。

/pr-to-video

  • 輸入: 一個 GitHub pull request — 一個 PR URL、一個 owner/repo#N 引用,或「這個 PR」— 透過 gh CLI 讀取(非待爬取的網站)。
  • 輸出: 程式碼變更解釋影片(變更日誌 / 功能展示 / 修復 / 重構)→ MP4 — diff 高亮、前後對比、檔案樹 + 影響場景。≤(最佳長度 30–90 秒)。
  • 觸發詞:「為此 PR 製作影片」、「將 PR #1187 變成變更日誌影片」、「從 github.com/org/repo/pull/123 製作版本說明影片」。

/embedded-captions

  • 輸入: 一個現有的 talking-head 影片(MP4)用於添加字幕 — 實際的影片檔,非 URL 或簡報。在本機進行轉錄(Whisper,無需 API 金鑰)和遮罩處理(RVM),以便主體可以遮擋字幕。
  • 輸出: 相同的影片不受影響,帶有一個字幕層 — 標準(逐字下方三分之一處軌道 + 一個嵌入在主題後方的高潮)或電影級(每個字幕合成在主題後方)。任何長度。
  • 觸發詞:「為此影片添加字幕 / 子標題」、「在主題後方添加字幕」、「為我的短片添加電影級字幕」。

/talking-head-recut

  • 輸入: 一個現有的 talking-head / 訪談 / 播客影片(MP4)用於包裝螢幕圖形 — 實際的影片檔。在本機進行轉錄(Whisper)。短片將完整地在下方播放,不受影響。
  • 輸出: 相同的影片,帶有計時的圖形疊層卡片 — 動態標題、下方三分之一處標題、資料重點提示、引言、側邊面板、子母畫面 — 與轉錄稿同步。任何長度。
  • 觸發詞:「打包此影片」、「為我的演講添加圖形疊層 / 下方三分之一處標題 / 資料重點提示」、「將此訪談變成一個影片包裝」。

Individual skills in this repo

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

相關技能