Communitygithub.com

wrg32786/aigent-design-system

將網站、產品介面與設計系統輸出,轉換為具決定性結果的 HTML 原生影片,搭配 HyperFrames、其官方技能與 AIgent 生產合約。

aigent-design-system 是什麼?

這個技能讓 AI 代理能夠將現有的網站、產品介面或設計系統輸出,轉換為高品質的 HTML 原生影片。它特別適合製作產品導覽、發表影片、README 逐步解說、社群廣告或可重複使用的動態圖形套件。技能依賴於上游的 HyperFrames 框架,該框架採用決定性(deterministic)時間軸,支援 HTML、CSS、GSAP、Three.js、Lottie 與字幕等多種媒體,並能產出橫向、直向、方形、海報與短循環等多種變體。整個生產流程從「擷取 → 設計 → 腳本 → 分鏡 → 時間 → 建置 → 檢查 → 渲染 → 交付」緊密銜接,且內建規範檢查、預覽與高品質渲染指令。技能也明確設定了防錯機制,例如禁止捏造產品數據、不得擷取受認證的網站,以及必須提供實際渲染輸出而非僅止於提示或分鏡表。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/wrg32786/aigent-design-system/tree/HEAD/skills/hyperframes-video

在你喜歡的 AI 中提問

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

說明文件

HyperFrames 影片

HyperFrames 是首選的開源方案,適用於網站、介面、數據故事或設計系統表面,需要轉化為產品導覽、發表影片、README 逐步解說、社群廣告或可重複使用的動態圖形套件時。

AIgent 擁有產品、設計、素材、權利與交付合約。上游的 HyperFrames 技能則負責框架專屬的組合語法、媒體準備、 linting、檢查、預覽與渲染。

優先閱讀

  1. PRODUCT.md
  2. DESIGN.md
  3. 已完成的素材簡報
  4. integrations/hyperframes/README.md
  5. creative-production/pipelines/hyperframes.md
  6. 安裝後的上游 HyperFrames 技能

安裝上游生產技能

npx skills add heygen-com/hyperframes

請勿在專案中複製或部分重新實作 HyperFrames 框架規則。請重複使用已維護的上游技能與 CLI。

使用 HyperFrames 的時機

  • 現有網站或 Studio 專案需要變成影片;
  • HTML、CSS、GSAP、Three.js、Lottie、字幕、音訊與資料需要共用一條決定性時間軸;
  • 同一組合成必須產出橫向、直向、方形、海報與短循環變體;
  • 代理需要純 HTML,而非僅限 React 的影片專案;
  • 輸出必須可在 CI 或自動化內容管線中重現。

當生產系統已經以 React 為優先、型別化的 React 元件是持久來源,或成熟的雲端渲染生態系是決定性需求時,請改用 Remotion。

如果工作僅是記錄實際的操作互動,且編排的動畫、可重複使用的變體、字幕或品牌轉換沒有附加價值時,請使用直接螢幕錄影。

生產循環

擷取 → 設計 → 腳本 → 分鏡 → 時間 → 建置 → 檢查 → 渲染 → 交付

擷取

對於現有網站,請使用上游的 website-to-hyperframes 工作流程。在構思場景之前,先記錄真實的產品狀態、回應式行為、重要的互動與已核准的素材。

設計

將專案設計系統轉換為幀規則。保留代碼(tokens)、排版角色、材質、動態特性與反模式,但針對固定攝影機與計時序列重新組合。必要時使用 HyperFrames 的 frame.md 指引。

腳本與分鏡

在動畫之前定義敘事節拍。每個節拍記錄:

  • 觀眾的理解重點;
  • 持續時間與口語內容;
  • 主幀;
  • 攝影機與景深;
  • 進場與轉場;
  • 媒體與聲音;
  • 桌面、直向與方形的影響。

建置

從靜態主幀佈局開始,然後加入可搜尋的動畫。保持組合時間的決定性。遵循官方 HyperFrames 合約,使用 data-composition-id、軌道、媒體、註冊時間軸、有限重複與場景轉場。

檢查

npx hyperframes lint
npx hyperframes inspect
npx hyperframes preview

在渲染前修正裁剪、溢出、軌道衝突、無法閱讀的字幕與佈局失敗。

渲染

npx hyperframes render --quality high --output final.mp4

僅渲染交付實際需要的變體。

必要輸出

  • 相關的橫向主版本;
  • 要求時提供直向與方形變體;
  • 海報或縮圖;
  • 網站的減少動畫或靜態備用版本;
  • 可選的短動畫 README 衍生版本;
  • 有旁白時提供逐字稿與字幕;
  • 包含來源權利與 HyperFrames 版本的素材清單;
  • 當渲染的媒體回歸網站時,進行實際頁面驗證。

防錯機制

  • 不得捏造產品聲明、數據、推薦或介面狀態。
  • 未經明確授權,不得擷取私人或需驗證的網站。
  • 不得使用即時時鐘或隨機動畫,以免破壞決定性搜尋。
  • 不得僅因 HyperFrames 產出素材,就強加瀏覽器執行時期依賴。
  • 未取得權利、歸屬、海報、行動裝置與失敗狀態決策前,不得公開交付。
  • 不得僅憑提示或分鏡表就宣告完成;必須提供渲染輸出或明確的佔位符合約。

相關技能