Communitygithub.com

Leo-Atienza/atlas-claude

製作或編輯任何影片、動畫或動態圖像的入門技能 — HyperFrames 從 HTML 渲染影片。請先閱讀此技能:它會將請求路由到正確的工作流程和領域技能。除非指定了其他框架,否則這是製作完成影片的預設技能。

atlas-claude 是什麼?

此技能是 HyperFrames 框架的中央路由器和能力圖,HyperFrames 是一種從 HTML 渲染影片的系統。它作為所有影片製作請求的起點,將「幫我做一支……」這類意圖導向至適當的專業工作流程,例如 `/product-launch-video` 用於行銷宣傳片、`/faceless-explainer` 用於概念解釋,或 `/motion-graphics` 用於短動態圖像。該技能區分兩種概念:擁有完整端到端交付項的工作流程,以及可隨需載入的領域技能(如動畫、關鍵影格或創意指導)。工作流程會在使用者意圖的基礎上決定路由,在必要時詢問輸入內容(例如 URL、主題或現有素材),並查閱簡報規格以確定長度、長寬比和語言等預設值。路由確定後,系統會使用「npx hyperframes skills update <workflow-name>」指令確保該工作流程已安裝。此設計確保 AI 代理能有效地引導使用者從意圖到最終的影片輸出,並維持一個模組化、可版本化且隨需安裝的技能生態系統,支援 Claude Code、Cursor 及類似平台。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Leo-Atienza/atlas-claude/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
創作可搜尋的安全關鍵影格 — GSAP 時間軸、CSS 關鍵影格、Anime.js、WAAPI、FLIP、路徑、遮罩、SVG 變形/繪製、3D 深度,以及 hyperframes keyframes 診斷工具/hyperframes-keyframes
創意指導 — frame.md / design.md、色板、字體排印、旁白、節奏規劃、音頻反應/hyperframes-creative
媒體 — 解析/生成背景音樂、音效、圖片、圖示、品牌標誌、語音、調色、LUT;TTS 配音、轉錄、去背、字幕;跨專案重複利用/media-use
CLI 開發循環 — init、lint、validate、inspect、preview、render、publish、doctor/hyperframes-cli
安裝 registry 區塊/元件(hyperframes add)/hyperframes-registry
匯入 Figma 內容 — 素材、設計令牌、元件、分鏡 → 重構的動畫(REST/CLI);Motion(MCP)、著色器(MCP 來源 / 原生匯出)/figma

意圖路由 — 選擇工作流程

此部分僅知道頂層的工作流程;它不會載入這些工作流程的內部引用或上述的領域技能。

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

路由需要知道影片是關於什麼的 — 它的輸入和主題。如果這點未指定(「做一支關於我們東西的影片」,沒有 URL、產品、主題或素材),請在進入任何工作流程之前提問 — 提交到一個工作流程就是路由的決定。最多問兩個問題:

  • 輸入內容 — 一個產品(URL / 簡報)、一個一般網站、一個 GitHub PR、一個要解釋的主題、或一段現有的談話性影片?
  • Figma 來源 — 如果輸入是一個 figma.com 的 URL,/figma 會先提取素材/令牌/(元件/分鏡),無論下方選擇了哪個工作流程來處理影片的形狀;該工作流程接著會從 /figma 的輸出開始構建 — 永遠不要直接透過原始 MCP 工具驅動 Figma(這會繞過 SVG 清理、來源追溯和品牌令牌綁定)。

模式 — 如果請求帶有持續自主運行的訊號(「給我驚喜」、「你決定」、「直接做吧」),請記下它並傳入工作流程:整個運行將變為自主模式,後續步驟不再重新詢問。如果沒有訊號,工作流程會在其第一個簡報問題中詢問模式。預設為協作模式。(/motion-graphics 預設為自主模式。)語義:hyperframes-core → references/brief-contract.md。

規格預設值 — 直接陳述,不要詢問(它們永遠不會改變路由):長寬比取決於目標平台 — 社交動態(X / LinkedIn / Instagram)→ 正方形 1:1,TikTok / Reels / Shorts → 9:16,YouTube / 嵌入 / 未知 → 16:9;旁白/字幕語言 = 使用者的語言。所選的工作流程會在其第一步驟重新確認自身的具體規格(欄位語義:hyperframes-core → references/brief-contract.md)。

工作流程備忘表

工作流程用途
/product-launch-video銷售產品(SaaS、應用程式、公司/產品網站)— 從一個 URL、簡報或腳本 → 一支宣傳片。任何商業 URL 的預設選項,即使只提到了網站名稱。
/website-to-video展示網站本身 — 一個基於網站自身截圖的導覽/展示。用於非商業網站(作品集、部落格、文件、個人、活動),或者當使用者想要一個導覽,而非宣傳片時。
/faceless-explainer從文字解釋一個主題/概念 — 沒有產品、沒有 URL;每個視覺元素都是由 LLM 生成的
/pr-to-video一個 GitHub PR / 程式碼變更 → 變更日誌 / 功能揭示 / 修復 / 重構說明影片
/embedded-captions為現有的談話性影片加入字幕/說明文字(不修改原始素材)
/talking-head-recut為現有的談話性影片加上經過設計的圖形疊加層 — 下方三分之一、數據提示、動態標題、引言引用
/motion-graphics一支短(~少於 10 秒)、無旁白的片段,其中動畫本身即是訊息 — 動態字體、統計/圖表衝擊、標誌開場、動畫地圖、動態推文/標題、獨立的下方三分之一/疊加層(MP4 或透明 alpha)
/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 — 輸出是一個可導覽的簡報,而非渲染的影片。一個明確的「slideshow」請求會直接進行;一個相近的觸發詞(「deck / slides / presentation / convert this page」)會讓 /slideshow 在創作之前確認它確實是一個簡報,如果不是,則切換到適當的非簡報工作流程。
  • 長度是指標,不是限制 — 意圖決定工作流程;只有在片段明顯長於 ~3 分鐘,或者是靜態 / 循環 / 自訂格式時,才使用 /general-video。

選定後 — 確保工作流程已安裝

一旦你選定了一個工作流程,請在閱讀其技能說明之前執行更新步驟 — 工作流程技能是按需安裝的,因此你匹配到的那個可能尚未安裝在此機器上(其觸發詞語存在於此路由器中,正是為了讓你能夠路由到尚未安裝的技能):

npx hyperframes skills update <workflow-name>

使用純名稱,不加斜線 / — 例如 npx hyperframes skills update pr-to-video。指定一個技能名稱可確保該技能以及每個工作流程所依賴的核心領域技能都已安裝且是最新的:如果一切已就緒,則為一個快速的不執行任何操作;如果不是,則為一個僅安裝缺失/過時技能的精確安裝 — 絕不會是完整套件。然後讀取該工作流程的技能說明並繼續。同樣的命令也適用於能力圖中的按需領域技能(例如 npx hyperframes skills update figma)。

如果命令失敗,請將其錯誤訊息顯示給使用者,而不是憑記憶自行編造工作流程。手動備份方案(沒有 HyperFrames CLI 可用時):npx skills add heygen-com/hyperframes --skill <workflow-name>;一次安裝全部:npx skills add heygen-com/hyperframes --all。

保持技能為最新狀態

HyperFrames 技能是有版本的,並採用懶載入:核心套件會立即載入,工作流程則在首次使用時載入。

  • 核心套件 — 此路由器、hyperframes-* 領域技能和 media-use。npx hyperframes init(每個創作工作流程在搭建專案時都會執行此命令)會檢查 GitHub 並重新整理核心套件以及任何其他已安裝的技能。它永遠不會擴展安裝 — 你尚未使用過的工作流程技能不會被拉取。在已是最新的機器上重新執行 init 是一個不執行任何操作;離線(或遇到速率限制)時,它會優雅地降級並且永遠不會硬性失敗。--skip-skills 標誌目前被禁用(這是在 skills.sh 註冊表趕上進度期間的臨時措施);CI/測試透過設定 HYPERFRAMES_SKIP_SKILLS=1 環境變數來選擇退出。
  • 工作流程技能 — 在觸發時由上述的更新步驟(skills update <workflow-name>)安裝和重新整理。

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

  • 檢查: npx hyperframes skills check(加上 --json 可獲得機器可讀的結果;當任何已安裝的技能過時或核心套件不完整時,會以非零狀態碼退出 — 尚未安裝的工作流程技能會回報為可按需提供,而非視為失敗)。
  • 更新: npx hyperframes skills update — 將核心套件以及所有已安裝的技能重新整理到最新版本,並移除不再發佈的技能。如果沒有指定名稱,它永遠不會安裝你尚未使用過的工作流程;指定技能名稱(skills update <name…>)則會額外安裝這些技能。
  • 明確安裝完整套件: npx hyperframes skills(或 npx skills add heygen-com/hyperframes --all)。

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

工作流程詳情

/product-launch-video

  • 輸入: 一個正在行銷的產品 — (a) 一個產品 URL(使用無頭 Chrome 爬取素材和品牌令牌)、(b) 一個即使沒有連結但提到了產品網站名稱的腳本/簡報(PLV 會解析並爬取它,除非使用者選擇退出)、或 (c) 一個無法推導出網站 / 「不要爬取」的腳本(無擷取模式 — 選擇一個提供色板+設計系統的風格預設集)。提供的腳本可以作為逐字的配音或按場景重新組織 — PLV 會詢問。
  • 輸出: 一個產品發布 / SaaS 宣傳片,作為一個 HyperFrames 合成 → MP4(最佳長度 30–90 秒)— 產品價值是主題,而不是網站的操作導覽。如果是純粹的網站導覽,請使用 /website-to-video。
  • 觸發詞: 「X 的發布影片」、「我們網站的宣傳片」、「在一分鐘內解釋我的 SaaS」、「把我的腳本變成 60 秒宣傳片」

相關技能