Communitygithub.com

Manavv007/S.A.R.A.L.-網站存取-擷取-分析-層

擷取一般網站/URL,並將其轉換為 HyperFrames 影片(網站導覽、展示或來自網站自身視覺效果的社交短片)。使用無頭 Chrome 螢幕截圖 + 品牌素材。

S.A.R.A.L.-網站存取-擷取-分析-層 是什麼?

此技能會從給定的 URL 擷取網站,並使用 HyperFrames 平台將其轉換為專業影片。它主要用於一般用途的網站展示,例如作品集、部落格或登陸頁面的導覽,或製作社交媒體短片。工作流程包含七個步驟,從品牌理解、設計與腳本撰寫,到語音合成、畫面建置與最終驗證。技能支援協作模式(會暫停詢問使用者偏好)與自主模式(自動決定部分偏好),但品質驗證關卡(如素材審核、逐拍 HTML 檢查)在任何模式下都不可跳過。此技能明確區分於產品發表影片、無網站的解說影片、GitHub PR 轉影片等任務。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-/tree/HEAD/.agents/skills/website-to-video

在你喜歡的 AI 中提問

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

說明文件

media-use:在獲取音訊/圖片前,請先呼叫 /media-use 從 HeyGen 目錄中取得背景音樂/音效/圖片。先執行 --adopt 註冊現有素材。詳見 /media-use 技能。

網站轉 HyperFrames

擷取一個網站,然後從中製作專業影片。

在第 0 步之前確認路線。 此技能是製作 來自/關於一般網站的 影片。如果使用者實際上是在 行銷/推廣/發佈產品(即使是從這個 URL,甚至是“為我們的網站做宣傳”)→ /product-launch-video。不涉及網站的特定主題解說員 → /faceless-explainer;GitHub PR → /pr-to-video;重新剪輯/調色/排序現有影片檔案 → 超出範圍。如果是模糊的“製作影片”,或不確定是發佈產品還是一般網站?請先閱讀 /hyperframes(完整路由表 + § HyperFrames 無法做的事)。

使用者會這樣說:

  • “將這個網站變成一個 15 秒的 Instagram 社交短片”
  • “從 https://... 製作一個 30 秒的網站導覽/展示”
  • “擷取我們的首頁,並用其自身的視覺效果製作影片”

工作流程有 7 個步驟。每個步驟會產出一個工件,作為下一步的條件。預設為協作模式——標記為 💬 的關卡會暫停並詢問使用者。如果使用者表示要採用自主模式(“幫我決定”、“給我驚喜”),則會跳過 💬 使用者偏好關卡;請參閱 step-2-brief.md 了解如何傳播。

自主模式不等於 “跳過所有關卡”。 自動模式涵蓋使用者偏好問題(TTS 提供者、聲音、色彩強調、節拍數量、音樂是/否、字幕是/否——代理程式代表使用者決定)。它不涵蓋品質驗證關卡。以下關卡在自動模式下仍然不可跳過:

  • 素材審計(步驟 3)——檢視素材表並為每個素材證明使用/跳過理由
  • 逐拍 HTML 閱讀(步驟 5)——每個節拍的結構化證據區塊
  • DoD 檢查表(步驟 6)——包括動畫映射、每次警告的 WCAG 驗證、音訊/動畫播放
  • 誠實揭露部分(步驟 6)——“我未驗證的內容”必須出現在最終摘要中

如果你發現自己在思考“自動模式說要偏向行動,所以我跳過 X”——而 X 是驗證關卡,不是偏好問題——那麼這個推理是錯誤的。偏向行動適用於決定 要建置什麼,而不是決定 是否要驗證。


步驟 0:擷取與理解品牌

閱讀: references/step-0-capture.md

擷取網站,然後閱讀擷取的資料以理解品牌和產品——它的功能、目標對象、語氣、氛圍。擷取的素材是稍後使用的品牌工具包,而不是構成影片的基礎元件。

在簡報前顯示登入狀態——執行 npx hyperframes auth status 並逐字轉述其輸出(不要改寫或重寫)。 它會回報語音/BGM 將使用 HeyGen 還是本地引擎,以及當未登入時如何登入。如果未登入,請停止並等待使用者選擇——登入,或說“go”/“offline”以繼續使用本地引擎——然後再詢問簡報或其他事項。 將其視為一個真正的決策點,而非一個附帶說明;不要將選擇塞入簡報問題中,也不要將金鑰寫入每個儲存庫的 .env 文件中。(在自主模式下,記錄狀態並繼續離線。)請參閱 ../hyperframes-media → Preflight 取得權威指南。

關卡: 已列印網站摘要——策略優先(產品功能、目標對象、品牌語氣)在素材/顏色/字型清單之前;已顯示登入狀態(已登入,或繼續離線)。


步驟 1:品牌識別

閱讀: references/step-1-design.md

撰寫 DESIGN.md——一份涵蓋視覺識別的品牌備忘錄:顏色、排版、元件樣式、佈局原則。使用 design-styles.json 取得精確的計算值。

速度選項: 對於快節奏影片(廣告牌式逐拍),DESIGN.md 可以是一份 50 行的摘要,包含顏色 + 字型 + 注意事項——而不是 300 行的文件。步驟 5 中的子代理提示會直接貼上品牌值,因此 DESIGN.md 的深度僅對複雜構圖才有意義。

關卡: DESIGN.md 已存在(任何長度),且至少包含:色板、字型選擇和注意事項。


步驟 2:策略與訊息

閱讀: references/step-2-brief.md, references/capabilities.md(掃描目錄——僅在需要時深入閱讀各節)

在討論視覺效果或素材之前,先與使用者確認影片必須傳達的內容。解析使用者的提示——他們可能已經提供了影片類型和風格。僅詢問缺失的部分:這部影片必須要說的一件事情、敘事弧線和目標觀眾。

關卡: 影片類型、持續時間、格式,以及關鍵的——訊息和敘事弧線已鎖定。沒有這些,步驟 3 無法撰寫以概念為先的分鏡腳本。


步驟 3:分鏡腳本與劇本 💬

閱讀: references/step-3-storyboard.md

以概念為先撰寫分鏡腳本:訊息 → 敘事弧線 → 服務於弧線的節拍 → 每個節拍的技術 → 最後的品牌重點檢查。然後撰寫匹配的旁白腳本。將兩者以逐拍摘要的方式呈現給使用者。反覆迭代直到他們批准。

關卡: STORYBOARD.md + SCRIPT.md 已存在 且 使用者已批准該計劃。


步驟 4:VO、時間與字幕 💬

閱讀: references/step-4-vo.md

如果步驟 2 表示不需要旁白——詢問背景音樂,然後跳到步驟 5。否則:詢問使用者要使用哪個 TTS 提供者(HeyGen TTS、ElevenLabs 或 Kokoro),生成音訊,轉錄,將時間戳對應到節拍。然後詢問字幕。

關卡: 要么 (a) 未要求旁白且分鏡腳本有手動節拍時間,或者 (b) narration.wav + transcript.json 已存在且節拍時間已用實際時長更新。


步驟 5:建立構圖

閱讀: hyperframes 技能(載入它——每個規則都很重要) 閱讀: references/step-5-build.md

按照步驟 3 分鏡腳本中選擇的架構和節奏建立 index.html 和構圖。子代理在回報前,會對每個節拍執行 hyperframes lint 和 hyperframes snapshot。

關卡: 每個 compositions/beat-N.html 都已被主代理根據 DESIGN.md 和 STORYBOARD.md 從頭到尾閱讀過。每個節拍的檢查表位於 step-5-build.md。


步驟 6:驗證與交付

閱讀: references/step-6-validate.md

進行 lint、驗證、根據影片長度按比例拍攝快照(公式:max(節拍數 × 3, ceil(持續時間_秒 / 2))),並審查每個快照。在交付前修正問題。交付 localhost Studio 專案 URL——僅在使用者明確要求時才渲染為 MP4。僅在移交時展示該 Studio URL——它是最終的穩定預覽;建置階段的快照是無頭的,因此不要在構建過程中彈出預覽。

交付你引以為傲的成果。 在移交之前,問問自己:我會在社交媒體上發布這個並掛上我的名字嗎?如果不會,修正問題。

關卡: npx hyperframes lint 和 npx hyperframes validate 通過且無錯誤,且最終回覆中包含活躍的 Studio 專案 URL。


快速參考

影片類型

各影片類型的典型限制——作為起點,非公式。節拍數應來自內容和旁白,而不是來自目標範圍。

類型典型時長時長驅動因素旁白
社交廣告 (IG/TikTok)10–15 秒平台限制可選
產品示範30–60 秒腳本長度完整旁白
功能公告15–30 秒功能複雜度完整旁白
品牌展示片20–45 秒音樂曲目可選,以音樂為主
發佈預告片10–20 秒鉤子能量最少

此表中故意不列出節拍數——它應來自分鏡腳本,而非來自“社交廣告 = 3-4 個節拍”。一個複雜產品的社交廣告可能需要 5 個節奏良好的節拍。一個只有一個強烈視覺主題的品牌展示片可能需要 3 個節拍。

格式

  • 橫向:1920x1080(預設)
  • 直向:1080x1920(Instagram 限時動態、TikTok)
  • 方形:1080x1080(Instagram 動態消息)

參考檔案

檔案何時閱讀
step-0-capture.md步驟 0 — 擷取、理解品牌與產品,撰寫以策略為先的網站摘要
step-1-design.md步驟 1 — 撰寫 DESIGN.md 品牌備忘錄(5 個章節,250-350 行;廣告牌風格的社交廣告使用 50 行快速路徑)
step-2-brief.md步驟 2 — 與使用者確認訊息、敘事弧線、目標觀眾
capabilities.md步驟 2 和 5 — HyperFrames 能力的完整清單(24 個章節)。在簡報期間掃描目錄,在構建期間深入閱讀特定章節
step-3-storyboard.md步驟 3 — 分鏡腳本 + 腳本(合併),附帶使用者審查關卡
step-4-vo.md步驟 4 — TTS 提供者選擇、生成、時間
step-5-build.md步驟 5 — 建置 index.html + 構圖
step-6-validate.md步驟 6 — lint、驗證、快照(按比例縮放至影片長度)、預覽
techniques.md步驟 3 和 5 — 13 種原始動畫技術與程式碼模式(調整使用,不要複製貼上)
html-in-canvas-patterns.md步驟 5 — 完整的 HTML-in-Canvas 效果程式碼模式(位於 hyperframes 技能中)

Individual skills in this repo

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

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

The fallback workflow for authoring custom HyperFrames video compositions at any length or format — longer or multi-scene pieces, brand / sizzle reels, montages, title cards, static loops, and freeform compositions. Input- and length-agnostic. If a specialized workflow clearly fits the input — a marketed product, a website, a topic explainer, a GitHub PR, existing footage, a short motion graphic, or a Remotion port — prefer it (see /hyperframes); use this only as the general fallback when none fit.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). HyperFrames-native: single paused timeline, seek-safe, deterministic.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, validate, inspect, layout, snapshot, preview, play, render, publish, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, or remove-background, or when troubleshooting the HyperFrames build/render environment. Entry point for AWS Lambda cloud rendering (`hyperframes lambda deploy / render / progress / destroy / policies`).

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

Audio and media assets for HyperFrames compositions, produced by one shared audio engine (`scripts/audio.mjs`) — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), background music + sound effects (HeyGen audio-library retrieval by default, with local Lyria / MusicGen BGM generation and a bundled SFX library as the no-credential fallback), Whisper transcription, background removal, and caption authoring. Use for voiceover / TTS, BGM, SFX / sound effects, transcription, captions / subtitles / lyrics / karaoke / per-word styling, voice + provider selection, and music-mood prompting.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

S.A.R.A.L. is an advanced AI-powered platform designed to bridge the "information gap" between rural Indian citizens and government welfare. While thousands of schemes exist, the complex language of official PDFs often makes them inaccessible to the common man.

相關技能