Communitygithub.com

Manavv007/S.A.R.A.L.-方案-存取-檢索-分析-層-

以任何長度或格式製作自訂HyperFrames影片組合的通用後備流程 — 適用於較長或多場景作品、品牌/精華短片、蒙太奇、標題卡、靜態循環及自由形式組合。僅當無專門流程適用時,才將其作為通用後備方案使用。

S.A.R.A.L.-方案-存取-檢索-分析-層- 是什麼?

此技能定義了「general-video」流程,作為任何HyperFrames影片組合的通用後備方案。當使用者的請求不屬於專業化流程(如產品發布影片、網站轉影片、解說影片等)時,AI代理必須使用此工作流程。該技能強調在開始編碼前,先透過「hyperframes-creative」建立視覺識別系統(包含色彩、字型、版型),並透過嚴格的硬性門檻確保設計品質。 此技能支援多種輸出類型,包括用於品牌短片、蒙太奇、標題卡和靜態循環的單場景或多場景組合。其關鍵原則包括:在動畫之前先以靜態HTML/CSS佈局最終狀態、將每個非平凡作品委派給專業領域技能(如動畫、音訊、核心合約),以及使用統一的音訊引擎處理語音合成、背景音樂和音效。 此技能透過預先定義的順序引導AI代理完成「發現、設計系統、提示擴展、規劃、建構、輸出」的步驟,並提供詳細的清單來驗證最終輸出。它支援HeyGen、ElevenLabs、Lyria等平台進行音訊生成,並強制使用如`hyperframes-media`和`hyperframes-cli`等特定腳本,以確保輸出一致且可供生產使用。

相容平台~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/general-video

在你喜歡的 AI 中提問

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

說明文件

media-use: 在獲取音訊/圖片之前,請呼叫 /media-use 從 HeyGen 目錄中解析 BGM/SFX/圖片。先執行 --adopt 以註冊現有資產。請參閱 /media-use 技能。

general-video — 通用影片工作流程

建構前先確認路線。 這是用於自訂組合編寫的後備方案。若輸入內容明顯符合某個專業化工作流程,請優先使用:行銷產品 → /product-launch-video;一般網站 → /website-to-video;主題解說 → /faceless-explainer;GitHub PR → /pr-to-video;現有素材 → /embedded-captions · /talking-head-recut;短篇無旁白動態圖像 → /motion-graphics;Remotion 移植 → /remotion-to-hyperframes。不在範圍內:即時/渲染時的數據、NLE 風格的已完成影片剪輯、或製作 HyperFrames 無法捕捉的素材。不確定?請先閱讀 /hyperframes。

精確建構所要求的內容。 標題卡就是標題卡——不是標題卡加三個支援場景加背景音樂加字幕。如果額外場景或元素能真正改善作品,請提案;不要默默地添加。對於小修改(修正顏色、調整一個時長、添加一個元素),跳過規劃步驟,直接進入建構。

方法

探索 —— 僅限開放式請求

對於模糊、探索性的請求("為我們的品牌製作些東西","一個酷炫的開場")——在選擇顏色之前先了解意圖:

  • 受眾 —— 誰觀看?開發者 / 高階主管 / 一般消費者?
  • 平台 —— 在哪播放?社交媒體(15秒) / 網站主視覺 / 產品示範 / 內部使用?
  • 優先級 —— 最重要的是什麼?動態品質 / 內容準確性 / 品牌忠實度 / 速度?
  • 變體 —— 一個最佳版本,還是 2-3 個有意義的不同選項(不同的節奏、能量或結構——而不只是顏色更換)?

對於具體請求("添加一個標題卡","修正場景3的時機"),跳過探索。

步驟 1 — 設計系統 → hyperframes-creative

首先建立視覺識別系統。如果專案有設計規範,請閱讀它(優先順序 frame.md → design.md → DESIGN.md;將其視為品牌真相——確切的顏色、字型、限制條件)。

如果沒有規範存在,你必須在選擇任何顏色或字型之前,同時閱讀 hyperframes-creative/references/house-style.md 和 hyperframes-creative/references/video-composition.md。 house-style.md 提供了"解讀提示/生成真實內容"的開場、懶惰預設列表和圖層配方;video-composition.md 提供了影片媒介的密度/比例/前景細節(數據條、註冊標記、等寬字型元數據、"8-10個元素,其中兩個使用者沒要求")——這區分了"已製作"和"已生成"。只讀一個是最常見的失誤——video-composition.md 是代理跳過的那個,而它正是防止扁平、居中、像網頁一樣輸出的關鍵。不要自行發明調色板並跳過這些;進入 hyperframes-creative 是強制性的,不是可選分支。從那裡,也提取一個命名的風格/情緒 → references/visual-styles.md,或互動式選擇器 → references/design-picker.md,視需要而定。規範/風格定義的是品牌,而不是合成規則。

找到角度(模糊簡報,無規範): 在選擇顏色之前,寫一句話——這個名字/詞語/主題喚起了什麼,以及什麼視覺_世界_(隱喻、設定、樂器、主題)表達了它?例如,一個網路安全工具 → 金庫門 / 周界掃描線 / 鎖芯;一個冥想應用程式 → 潮汐、呼吸、緩慢的光綻放。閱讀主題的_意義_,而不僅僅是它的字母;選擇一個具體的角度,而不是字面上的重新設計。這是對於單場景作品(正確地跳過了提示擴展)中提示擴展(步驟 2)的廉價替代品——它是設計概念與通用標誌在漸層上的區別。

步驟 2 — 提示擴展 → hyperframes-creative

針對每個多場景組合執行(單場景作品和瑣碎修改跳過)。根據設計規範和 house style 將請求扎根,形成一個一致的中間表示,下游工作以相同方式讀取。請參閱 hyperframes-creative/references/prompt-expansion.md。

步驟 3 — 規劃

在編寫 HTML 之前,從高層次思考:

  1. 什麼 — 觀看者體驗:敘事弧、關鍵時刻、情感節拍。
  2. 結構 — 有多少個合成、子合成 vs 內聯、哪些軌道承載影片 / 音訊 / 疊加層 / 字幕。關於單體單檔案 vs 模組化子合成的選擇,請參閱 hyperframes-core/references/composition-patterns.md § 兩種架構(經驗法則:≥3 個硬場景切換,或任何重複使用的場景 → 模組化;一個簡短的單場景作品保持一個檔案)。
  3. 節奏 — 在實現之前命名模式(例如 fast-fast-SLOW-SHADER-hold);請參閱 hyperframes-creative/references/beat-direction.md。
  4. 時機 — 哪些剪輯驅動時長、過渡落在哪裡、節奏。
  5. 佈局 — 首先建立最終狀態(見下文)。
  6. 動畫 — 然後透過 hyperframes-animation 添加運動。

先佈局再動畫

將每個元素放置在它最顯眼時刻所在的位置——完全進入、正確放置、尚未退出。先將其編寫為靜態 HTML + CSS。還沒有 GSAP。

為什麼: 如果你將元素放在它們的動畫起始狀態(螢幕外、縮放到 0、透明度 0),然後補間到你_認為_它們會到達的位置,你就是在猜測最終佈局——重疊直到渲染時才可見。先建立最終狀態,你就能在添加運動之前看到並修復佈局問題。

  1. 為每個場景識別主影格 — 最多元素同時可見的時刻。那就是你要建立的佈局。
  2. 為該影格編寫靜態 CSS。內容容器必須用內邊距填充場景,而不是使用絕對偏移:
.scene-content {
  display: flex;
  flex-direction: column;
  justify-content: center;
  width: 100%;
  height: 100%;
  padding: 120px 160px; /* padding positions content; fills any scene size */
  gap: 24px;
  box-sizing: border-box;
}

永遠不要對內容容器使用 position: absolute; top: Npx——當內容高於空間時它會溢出。保留絕對定位給裝飾元素。

⚠ 上面的 width/height: 100% 只有在每個祖先都有解析高度時才有效。 根 <div data-composition-id> 以及它與 .scene-content 之間的任何包裝器都必須設定尺寸(根元素上設定 position: relative; width: 1920px; height: 1080px——請參閱 hyperframes-core → "Root must be sized")。跳過這個,flex 容器會坍縮到大約 0,內容堆積到左上角,第一個字形在 x=0 處被裁切——而 lint/inspect 仍然報告 0 個問題。而且始終在 .scene-content 上保留 padding(≥80px):它是標題安全邊距。永遠不要用單純的 gap 取代它。

  1. 添加入場 — 使用 gsap.from() 從螢幕外/不可見動畫到 CSS 位置(在子合成中偏好使用 gsap.fromTo() 以便起始狀態是明確的;請參閱 hyperframes-core/references/sub-compositions.md)。CSS 位置是基準事實;補間是到達那裡的旅程。
  2. 退出由過渡處理 — 根據 hyperframes-animation/transitions/ 中的場景過渡規則,只有最後一個場景將元素動畫移出;場景之間的過渡本身就是退出。

跨時間的共享空間: 如果元素 A 在元素 B 進入同一區域之前退出,兩者仍然需要各自主影格的正確 CSS 位置——時間軸排序使它們不會共存,而佈局步驟會捕捉到意外重疊。分層光暈/陰影和 z 堆疊深度是_有意的_重疊;該步驟是關於捕捉_無意的_碰撞(兩個標題互相重疊、內容溢出畫框)。

建構 — 委派給領域技能

這映射了技能的全部表面(請參閱 description)到其參考資料——非詳盡列表;當意圖未列出時,請透過 hyperframes-creative(外觀/概念)、hyperframes-animation(運動)、hyperframes-core(合約)、hyperframes-media(音訊/字幕)路由。第一行是附加的——閱讀它以及你的意圖行,而不是只讀其中一個。

正在建構…優先閱讀(按順序)
始終 — 每個非平凡作品,除了下方你的意圖行之外hyperframes-creative/references/house-style.md + references/video-composition.md(也在步驟 1 / HARD-GATE 中門控;"已製作,而非生成的"前景細節)
動態排版 / 文字優先hyperframes-animation/techniques.md(動態類型) + adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md
標題卡 / 下方三分之一 / 疊加層 / PiP / 文字後主題hyperframes-creative/references/composition-patterns.md +(對於居中/設定尺寸的影格) hyperframes-core → "Root must be sized"
標誌 / 品牌標記揭示hyperframes-animation/rules/svg-path-draw.md(繪製) + rules/3d-text-depth-layers.md + rules/scale-swap-transition.md
數據 / 統計 / 數字hyperframes-animation/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-creative/references/data-in-motion.md
產品 / 應用程式 / UI 示範hyperframes-animation/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md
音訊反應 / 音樂驅動hyperframes-creative/references/audio-reactive.md(預先提取頻段;映射到運動)
旁白 / 畫外音 / 音樂 / SFX / 字幕hyperframes-media → 共享音訊引擎 scripts/audio.mjs(一次呼叫 = TTS + BGM + SFX → audio_meta.json);透過 hyperframes-core 進行字幕編寫和資產放置。請參閱下面的音訊。
多場景 / 過渡hyperframes-animation/transitions/overview.md 然後 transitions/catalog.md(看完概述還不夠——GSAP 配方在目錄中)
模組化 / 子合成hyperframes-core/references/composition-patterns.md + references/sub-compositions.md

音訊:一個引擎(TTS · BGM · SFX)

僅當作品需要時才使用(根據"精確建構所要求的內容"——不要為標題卡添加背景音樂)。不要手動製作 TTS 或供應商複製:編寫一個中立的 audio_request.json 並在 hyperframes-media 中呼叫共享引擎。它會自動根據一個開關降級——存在 HeyGen 憑證 → HeyGen TTS + 音樂/SFX 檢索;不存在 → ElevenLabs/Kokoro TTS、Lyria/MusicGen BGM 生成,以及捆綁的 SFX 庫。完整的標誌列表 + 請求/元數據模式:hyperframes-media/scripts/audio.mjs 的標頭註解。

// audio_request.json — 每個旁白片段一行;`id` 是你的(將 audio_meta 連接回來)
{
  "lines": [
    { "id": "s1", "text": "你的開場白。", "sfx": ["whoosh"] },
    { "id": "s2", "text": "下一個節拍。" },
  ],
  "bgm": { "query": "calm cinematic underscore" }, // 省略 "mode" → 自動(如果 HeyGen 則檢索,否則生成);設為 "none" 以禁用
}
# <MEDIA_DIR> = 已安裝的 hyperframes-media 技能目錄(此技能的兄弟目錄)
node <MEDIA_DIR>/scripts/audio.mjs --request ./audio_request.json --hyperframes . --out ./audio_meta.json

然後讀取 audio_meta.json:將每個 voices[].path +(bgm.path,sfx[])掛載為 <audio> 軌道,並使用 voices[].words 進行字幕,全部按照 hyperframes-core(音訊軌道 + 字幕編寫)進行。如果 BGM 採用了生成路徑(bgm_pending: true),請在最終渲染前執行 hyperframes-media/scripts/wait-bgm.mjs。

輸出清單 → hyperframes-cli

  • ...

[已截斷以供翻譯]

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-

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-

Capture a general website/URL and turn it into a HyperFrames video (site tour, showcase, or social clip from the site's own visuals). Uses headless Chrome screenshots + brand assets. Use when intent is general — portfolio/blog/landing-page showcase or social clip from the site. NOT for: product/SaaS launch or promo (→ /product-launch-video, even from a URL); topic explainer with no site (→ /faceless-explainer); GitHub PR (→ /pr-to-video); adding captions to existing video (→ /embedded-captions); short unnarrated page-highlight motion graphic (→ /motion-graphics). Unclear launch-vs-general-site? Ask one question or start at /hyperframes.

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.

相關技能