Communitygithub.com

natureco-official/natureco-cli

閱讀此內容以處理任何關於製作、建立、編輯、動畫或渲染影片、動畫或動態圖形的請求。HyperFrames 從 HTML 渲染影片;這是進入點技能,也是 AI 代編創作或編輯影片的預設方式。它將請求導向正確的專業工作流程,並指向 HyperFrames 領域技能,因此在嘗試其他影片或動畫技能前,請先閱讀此內容,而不是猜測工作流程。

natureco-cli 是什麼?

HyperFrames 是一個從 HTML 渲染影片的框架,此技能是處理所有影片創作、編輯、動畫和渲染請求的統一入口點。它提供了一個功能映射,列出按需載入的領域技能(如核心編輯、動畫、創意方向、媒體處理),並包含一個意圖路由器,可根據使用者輸入(如產品 URL、網站、GitHub PR、文字或現有影片)自動選擇最合適的工作流程。支援從產品發布影片、網站轉影片、無臉解說影片到音樂同步影片等多種場景,並能與 Claude Code、Cursor 等 AI 代編工具整合。使用時,技能會先確認輸入內容(而非規格),再根據意圖路由到對應工作流程,若工作流程未安裝,則會提示使用者透過指令安裝。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/natureco-official/natureco-cli/tree/HEAD/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
創意方向 — frame.md / design.md、調色盤、字體排印、敘事、節奏規劃、音訊反應/hyperframes-creative
媒體 — TTS 旁白、背景音樂、轉錄、去背、字幕/hyperframes-media
媒體解析 — 從 HeyGen 目錄中尋找並匯入 BGM、SFX、圖片、圖示至 .media/ 並附帶清單追蹤/media-use
CLI 開發循環 — 初始化、程式碼檢查、驗證、檢查、預覽、渲染、發布、診斷/hyperframes-cli
安裝註冊表區塊 / 元件(hyperframes add)/hyperframes-registry

意圖路由 — 選擇工作流程

本節僅知道頂層工作流程;不會載入其內部參考或上面的領域技能。

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

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

  • 輸入 — 產品(URL / 簡報)、一般網站、GitHub PR、要解釋的主題、或現有的談話頭影片?

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

工作流程速查表

工作流程使用時機
/product-launch-video行銷 / 發布 / 推廣產品 — 從其 URL、簡報或腳本(即使只提到了網站名稱)
/website-to-video將一般網站轉換成影片 — 網站導覽、作品集 / 登陸頁面展示、來自網站視覺效果的社交短片
/faceless-explainer從文字解釋主題 / 概念 — 沒有產品、沒有 URL;每個視覺效果都是 LLM 虛構的
/pr-to-videoGitHub PR / 程式碼變更 → 變更日誌 / 功能揭曉 / 修正 / 重構解說員
/embedded-captions為現有談話頭影片新增字幕 / 副標題(原始影片未經修改)
/talking-head-recut為現有談話頭影片套用設計過的圖形疊加層 — 下方三分之一、資料呼叫、動態標題、引言引述
/motion-graphics簡短、無旁白、設計為主的動態圖形 — 動態字體、統計 / 圖表重點、標誌開場、下方三分之一疊加層
/music-to-video音樂曲目 → 節拍同步的影片 — 歌詞影片、幻燈片或動態宣傳片;音樂驅動節奏(可選的使用者圖片 / 影片會按節拍網格剪輯)
/slideshow簡報 / 提案簡報 / 互動式簡報 — 離散投影片、片段、分支、熱點;輸出為可導覽的簡報,而非渲染影片
/general-video其他任何情況 — 較長或多場景片段、靜態循環 / 海報、自訂合成
/remotion-to-hyperframes將現有 Remotion (React) 合成移植到 HyperFrames(遷移,非創作)

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

  • 運動優先且無旁白(約 10 秒以下,運動本身就是訊息) → /motion-graphics,無論輸入為何。
  • URL 或腳本 — 行銷特定產品(即使只提了網站名稱) → /product-launch-video;一般非產品網站 → /website-to-video;GitHub PR 連結 → /pr-to-video;解釋概念但沒有產品 / 網站 → /faceless-explainer。若真的分不清產品 vs 主題,或發布 vs 一般網站 → 問一個問題。
  • 現有影片 — 純口語字幕 → /embedded-captions;設計過的疊加卡片 → /talking-head-recut。兩者都不會編輯影片本身(重新剪輯 / 調色 / 重構 / 重新排序 / 音訊屬於非線性剪輯 — 不在範圍內)。
  • 輸入是音樂曲目(音訊檔案,或要擷取音訊的影片)且無旁白 → /music-to-video — 音樂的節拍 / 能量驅動節奏。(有旁白的片段仍保留在以上輸入匹配的工作流程;/motion-graphics 用於非音樂驅動的簡短無旁白動畫。)
  • 簡報 / 提案簡報 / 互動式簡報(離散投影片、導覽、簡報者模式) → /slideshow — 輸出為可導覽的簡報,而非渲染影片。明確的「幻燈片」請求會直接進行;相關觸發(「簡報 / 投影片 / 簡報 / 轉換此頁面」)會讓 /slideshow 在創作前確認是否為幻燈片,若不是則切換到適當的非幻燈片工作流程。
  • 長度是指引,而非門檻 — 意圖決定工作流程;僅在片段明顯長於約 3 分鐘,或是靜態 / 循環 / 自訂格式時,才使用 /general-video。

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

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

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

執行後,重新讀取工作流程的技能並繼續。

工作流程詳情

/product-launch-video

  • 輸入: 正在行銷的產品 — (a) 產品 URL(使用無頭 Chrome 爬取資源 + 品牌權杖),(b) 有提及產品網站(即使沒有連結)的腳本 / 簡報(PLV 會解析 + 爬取該網站,除非使用者選擇退出),或 (c) 無法推導出網站 /「不要抓取」的腳本(無擷取模式 — 選擇提供調色盤 + 設計系統的風格預設)。提供的腳本可以作為逐字旁白或按場景重新結構 — PLV 會詢問。
  • 輸出: 產品發布 / SaaS 宣傳片,作為 HyperFrames 合成 → MP4(最佳長度 30–90 秒)。
  • 觸發詞:「X 的發布影片」、「我們網站的宣傳片」、「在一分鐘內解釋我的 SaaS」、「將我的腳本變成 60 秒宣傳片」、「純文字發布影片,不要抓取」。

/website-to-video

  • 輸入: 要轉換成影片的一般網站 / URL — 目標是製作關於該網站的影片,而非產品發布。使用無頭 Chrome 擷取真實螢幕截圖 + 品牌資源。
  • 輸出: 基於網站自身視覺效果的網站導覽 / 作品集 / 登陸頁面展示 / 社交短片 → MP4。
  • 觸發詞:「將此網站變成影片」、「從 的網站導覽」、「我們首頁的社交短片」、「我只有一個 URL — 做點什麼」。

/faceless-explainer

  • 輸入: 任意文字 — 正在解釋的主題、文章或筆記,無行銷產品、無網站可擷取。(從 /product-launch-video 分叉;無無頭 Chrome。)
  • 輸出: 無臉解說影片 → MP4,每個視覺效果都是 LLM 按場景虛構的(字體排印 / 抽象 / 圖表 / 資料視覺化);內含 pin-and-paper 預設。(最佳長度 30–90 秒)。
  • 觸發詞:「關於 X 的無臉解說影片」、「解釋 DNS 如何運作的影片」、「將此文章變成解說影片」、「根據我的筆記製作解說影片」。

/pr-to-video

  • 輸入: GitHub 拉取請求 — PR URL、owner/repo#N 引用或「此 PR」— 透過 gh CLI 讀取(非可爬取的網站)。
  • 輸出: 程式碼變更解說影片(變更日誌 / 功能揭曉 / 修正 / 重構)→ MP4 — 差異亮點、前後對比、檔案樹 + 影響場景。最佳長度 30–90 秒。
  • 觸發詞:「製作關於此 PR 的影片」、「將 PR #1187 變成變更日誌影片」、「來自 github.com/org/repo/pull/123 的版本說明影片」。

/embedded-captions

  • 輸入: 現有的談話頭影片(MP4)以加入字幕 — 實際影片,非 URL 或簡報。本地轉錄(Whisper,無需 API 金鑰)並進行去背處理(RVM),使主體可以遮擋字幕。
  • 輸出: 相同的未經修改的影片,帶有字幕層 — 標準(逐字下方三分之一軌道 + 主體後方的嵌入式高潮)或電影級(每個字幕都合成在主體後方)。任何長度。
  • 觸發詞:「在此影片中加入字幕 / 副標題」、「主體後方的字幕」、「我的剪輯的電影級字幕」。

/talking-head-recut

  • 輸入: 現有的談話頭 / 訪談 / 播客影片(MP4),要包裝上畫面圖形 — 實際影片。本地轉錄(Whisper)。影片在下方完整播放,未經修改。
  • 輸出: 相同的影片,帶有定時的圖形疊加卡片 — 動態標題、下方三分之一、資料呼叫、引言引述、側邊面板、子母畫面 — 與轉錄文字同步。任何長度。
  • 觸發詞:「包裝此影片」、「在我的演講中加入圖形疊加層 / 下方三分之一 / 資料呼叫」、「將此訪談變成圖形包裝的剪輯」。

/motion-graphics

  • 輸入: 簡短、設計為主的動態圖形,其中運動就是訊息 — 通常約 10 秒以下,無旁白。類型:動態字體排印、統計 / 數字計數、圖表重點、標誌開場、下方三分之一 / 疊加層、或搜尋驅動的頁面 / 推文 / 標題畫面。
  • 輸出: 簡短的動態圖形 → MP4 或透明疊加層(alpha WebM / MOV)用於下方三分之一 / 呼叫。
  • 觸發詞:「8 秒的標誌開場」、「為此統計數據製作動畫」、「動態字體介紹」、「將此推文變成動態圖形」、「透明的下方三分之一疊加層」。

/music-to-video

  • 輸入: 音樂曲目 — 音訊檔案,或要從中提取音訊的影片 — 無旁白且無網站擷取。可選的使用者提供的圖片 / 影片以穿插其中。曲目會被分析一次,產生確定性的節拍 / 能量圖(audiomap.json),整個影片都基於此建構。
  • 輸出: 節拍同步的 HyperFrames 合成 → MP4,由音樂驅動節奏。字體排印和模板是基礎(一個完整的影片不需要任何資源);任何提供的媒體都會按相同的節拍網格剪輯(節拍剪輯 / 肯·伯恩斯效果)。類型 — 歌詞影片、幻燈片、動態宣傳片 — 由每個畫格的選擇決定;管道永遠不分支。
  • 觸發詞:「為這首歌製作影片」、「從此曲目製作節拍同步影片」、「歌詞影片」、「將此音樂變成影片」、「音樂視覺化工具 / 隨此節拍的動態宣傳片」。

/slideshow

  • 輸入: 要創作的簡報 / 提案簡報 / 互動式簡報 — 簡報、大綱或要轉換成投影片的現有頁面。非渲染影片的請求;如果意圖不明確,技能會在創作前確認「您是否希望將其作為 HyperFrames 幻燈片?」。
  • 輸出: 可執行的 HyperFrames 合成 + 一個 JSON 島,播放器的 SlideshowController 會讀取它,將 GSAP 時間軸轉換成可導覽的簡報 — 離散投影片、片段揭示、分支序列、熱點導覽、簡報者模式和講者備註。交付成果是簡報,而非 MP4。
  • 觸發詞:「製作提案簡報 / 簡報 / 投影片簡報」、「互動式簡報」、「將此頁面轉換成投影片」、「具有簡報者模式的幻燈片」。

/general-video

  • 輸入: 以上未提及的任何內容 — 創意簡報、要製作動畫的單一元素、對您正在建構的合成進行的編輯。輸入和長度不拘。
  • 輸出: HyperFrames 合成(任何長度 / 格式)經由原始流程:設計系統 → 提示擴展 → 計畫 → 動畫前佈局 → 建構(委派給 hyperframes-* 技能)→ 驗證

…

[為翻譯而截斷]

相關技能