Communitygithub.com

samyakiasonline-ctrl/hyperframe

撰寫或編輯自訂的 HyperFrames 合成,適用於無專門工作流程可用的情境,或當 BRIEF.md 設定 flow: companion 時。用於較長或多場景作品、品牌與宣傳短片、蒙太奇、靜態循環、靜態標題卡、素材混剪及自由形式建構。使用 motion-graphics 處理簡短、無旁白且以動畫為主的單元(含動態標題)。在啟用此技能前,請先透過 hyperframes 進行全新創作。

hyperframe 是什麼?

此 AI 代理技能「samyakiasonline-ctrl/hyperframe」專門用於建立與編輯 HyperFrames 影片合成,特別針對需要更複雜、多場景或長時間作品(如品牌影片、宣傳短片、蒙太奇)的情境,或是在「陪伴」(companion) 模式下協作時使用。它會先安裝必要的插件,並確保 `npx hyperframes` CLI 工具為最新版本。接著,它會根據專案狀態(例如特定的編輯要求、是否存在 BRIEF.md 或 hyperframes.json)來引導 AI,並參考 /media-use 和 /figma 等外部技能來處理媒體資產與設計資源。此技能支援「自動化」(automation) 和「陪伴」(companion) 兩種工作流程,並在陪伴模式下扮演「導演」角色,提供高品質的設計方案而非僅完成最低需求。其執行過程強調嚴格的知識載入、結構化的規劃與引用,並使用大量的官方參考文件,如效能規則、創意風格指南和分鏡格式,以確保輸出的一致性與品質。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/samyakiasonline-ctrl/hyperframe/tree/HEAD/.claude/skills/general-video

在你喜歡的 AI 中提問

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

說明文件

插件安裝: 在執行設定或更新命令之前,若此技能位於 HyperFrames 插件內,請遵循 插件執行規則。獨立安裝則保留下方的更新說明。

一般影片

在工作流程開始時執行 npx hyperframes usage --json,除非剛讀取過,然後在草稿階段和渲染前等里程碑再次檢查。閱讀可用的視窗和重置時間。如果使用量未知,請直接說明,不要猜測配額;與使用者一起決定範圍和工作流程選擇。

在依賴此工作流程之前,請執行:

npx hyperframes skills update general-video

成功且無任何操作表示該技能為最新版本。如果更新失敗,請直接顯示失敗訊息,不要根據記憶繼續執行。

1. 套用跨領域來源適配器

  • 媒體: 對於任何音訊、圖片、圖示、標誌、語音、調色、LUT、效果調整、字幕或媒體操作需求,請載入 /media-use 並遵循 ../media-use/references/resolve.md(解析、採用、重用)和 ../media-use/references/setup-providers.md(提供者、驗證)。模糊的素材回饋和命名樣式需在使用 ../media-use/references/media-treatments.md 後再進行編輯;不要使用 CSS/SVG/透明度來即興創作支援的媒體效果。在首次執行需要驗證的提供者操作前,請執行 npx hyperframes auth status 並逐字輸出其結果。如果已登出,請套用 ../hyperframes/references/brief-contract.md 中的閘控:協作模式會等待登入或明確選擇離線;自主模式則會陳述狀態並透過可用的離線提供者繼續執行。當沒有離線提供者能滿足必要功能時,請標記為阻礙。僅在本機採用不需要驗證閘控。
  • Figma: 如果任何輸入是 figma.com 的 URL,請先執行 /figma。使用其匯出的素材、設計權杖、元件或分鏡框架來建構。不要使用原始的 Figma connector 呼叫,因為它們會繞過 SVG 清理、媒體來源追溯和品牌權杖綁定。

這些適配器不會改變由 /hyperframes 選定的工作流程。

2. 從專案狀態開始

套用第一個符合的狀態列;不要評估較低順序的狀態列:

狀態動作
特定編輯執行編輯,保留現有的專案決策,然後重新執行受影響的檢查。不要重新開啟探索階段。
BRIEF.md 存在讀取它。如果 workflow 指定了另一個工作流程且 flow 不是 companion,則移交。不要詢問簡報相關問題。
無簡報,但存在 hyperframes.json 或 STORYBOARD.md從檔案和記錄的偏好設定恢復。僅根據已知事實回填 BRIEF.md。
全新創作執行 /hyperframes 及其意圖層。僅在 workflow: general-video 或 flow: companion 時返回此處。

對於新專案,請從簡報中選擇一個 kebab-case 格式的目錄名稱,並在撰寫簡報前進行初始化:

npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=general-video

然後在專案根目錄中使用 ../hyperframes/references/brief-format.md 編寫 BRIEF.md。在現有專案中,根目錄是包含 hyperframes.json 的目錄。僅記錄由簡報格式指定的、已確認的偏好支援欄位,使用 node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes <PROJECT_ROOT>;從不記錄推斷的預設值。此處 <MEDIA_DIR> 是已安裝的 /media-use 技能目錄,<PROJECT_ROOT> 是包含 hyperframes.json 的目錄。如果意圖層採用了某個配方,請立即使用 node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes <PROJECT_ROOT> --name <name> 套用它,並且不要再次詢問。

3. 解讀執行形狀

僅使用 ../hyperframes/references/brief-contract.md 中的標準術語:

欄位意義效果
flow誰來主導automation:選擇並執行路線。companion:在對話中共同創作。
storyboard規劃、草稿和審查yes:執行規劃和草稿審查(storyboard.html)。no:不經審查直接建構。
衍生的 mode檢查點閘控行為遵循簡報合約。永遠不要要求使用者命名模式。

不要為這些狀態發明同義詞。持續的「直接建構」訊號會由意圖層處理,並以 flow: automation,storyboard: no 的形式到達。

  • 對於 flow: automation,選擇路線並在第一次進度更新中用一行說明。
  • 對於特定編輯,執行編輯而不發明新路線。

要對現有素材進行硬切、修剪、拼接或重新排序,請將同一個影片來源複製到多個剪輯元素中。在每個副本上,使用 data-media-start 加上 data-duration 設定來源範圍,然後使用 data-start 設定創作的位置/順序。每個影片片段保留其聲音:聲音保留在剪輯上(data-has-audio="true"),因此剪輯影片也會剪輯其聲音。/hyperframes-core 擁有此時間編輯權;僅在需要對內部包裝器進行視覺屬性動畫(如縮放、推進、平移、裁切、遮罩或 clip-path)時才使用 /hyperframes-keyframes。從 ../hyperframes-core/references/creator-editing-recipes.md 複製完整的合約。

協作流程

當 flow: companion 時:

  • 讀取 BRIEF.md 並將已接受的 ## Assets 和 ## Customizations 與專案工件進行比對。完成仍待辦的已接受工作;已完成的工作則跳過;不要將已接受過的能力當作新功能再次提供。
  • 以導演而非承包商的身份介入。 選擇協作模式的使用者希望參與和高品質;誠實的回應是你能設計出的最佳版本,而不是你能辯護的最小版本。第一個計畫是天花板級處理:故事弧(借用最接近的類型鏡頭 — 菜單 § 類型鏡頭)、設計規格、每個場景的動作處理(按 § 5 的計畫規範引用名稱)、轉場、音訊識別 — 音樂和聲音標記,或是有意的靜默 — 使用者的素材擺放,以及設計好的開場和結尾。用一句話說明每個層次增加的價值;在提及時標記成本高昂的層次(渲染時間、登入、計費)。使用者只會縮減處理方案;他們不應該透過一個一個的批准來拼湊一個方案。
  • 天花板屬於概念,而非工具箱。 每個層次都必須服務於簡報的訊息 — 一個套在任何影片上都一樣的處理方案只是裝飾。工藝應達到天花板;內容絕不能超出被要求的部分(§ 6)。
  • 在檢查點之間,../hyperframes/references/capability-menu.md 有兩種運作方式。作為觸發列表:當使用者提及某個能力的輸入或建構達到其需求時,提供相關能力。作為每次通過的升級通道:一個規劃、草稿或建構檢查點可能包含一兩個針對使用者正在查看的素材的追蹤提案(「場景 3 的統計數據需要計數處理」)。在提供之前閱讀它;永遠不要傾倒整個目錄。
  • 使用者接受某項能力後,立即產生其工件,並將決策記錄到對應的 BRIEF.md 主體章節中。僅在使用者明確變更時,才重寫 frontmatter 欄位並記錄已確認的偏好。
  • 保持相同的分鏡、驗證、最終預覽和渲染批准閘控。協作模式改變的是誰來掌舵,而不是品質要求的標準。

4. 在每個階段前載入必要知識

當條件符合時,必須進行以下讀取:

條件在行動前讀取
任何合成 HTML 或場景佈局/hyperframes-core;使用 references/determinism-rules.md 了解其佈局合約
任何非平凡的創作或視覺處理/hyperframes-creative → references/house-style.md 和 references/video-composition.md
任何動作、動畫或場景轉場/hyperframes-animation;遵循其路由至匹配的規則、適配器、藍圖或轉場參考
storyboard: yes../hyperframes/references/storyboard-format.md 和 ../hyperframes/references/review-loop.md
任何媒體資產或操作,包含旁白、背景音樂、音效、字幕、調色或轉換/media-use;對於框架播放和放置,也需閱讀 /hyperframes-core → references/variables-and-media.md
多場景組裝../hyperframes/references/production-loop.md
flow: companion,在首次規劃之前/hyperframes-creative → references/story-spine.md 和 references/house-style.md;最接近的類型鏡頭和完整的 ../hyperframes/references/capability-menu.md — 天花板處理方案是根據這些設計的,而非回憶
一個協作能力提案、捕捉、節拍網格、生成式影片、地圖、發布或跨工作流程能力../hyperframes/references/capability-menu.md
存在設計規格,在最終批准之前/hyperframes-creative → references/design-adherence.md

不要用回憶取代這些讀取。僅在實際載入匹配的參考時,漸進式揭露才能節省上下文。

5. 執行合成

使用此依賴順序。僅在其輸入不存在時跳過一個階段。

  1. 規劃。 說明觀眾的觀看弧線、結構、節奏和持續時間驅動因素。簡短的單場景使用一個檔案;三個或更多硬場景切換或任何重用場景使用子合成。閱讀 /hyperframes-creative → references/story-spine.md 了解敘述弧線,references/beat-direction.md 了解節奏,以及 /hyperframes-core → references/composition-patterns.md 了解結構。對於開放式的多場景簡報,透過 /hyperframes-creative → references/prompt-expansion.md 擴展提示。一個多場景的規劃會引用每個場景的形狀:當符合時使用來自 /hyperframes-animation → blueprints-index.md 的藍圖 ID,當沒有符合時則使用它從 rules-index.md 組合而成的命名規則 — 動作名稱來自這些索引,絕不發明。故事的真實性決定哪些場景存在;引用則為它們提供裝飾。在你計劃自己建構任何命名外觀之前,請先搜尋線上官網目錄:對於簡報中提到的每個外觀、效果、處理或轉場 — "CRT scanlines","glitch","film grain","shimmer sweep","confetti burst" — 請執行 npx hyperframes catalog --query "<用白話文描述的外觀>" --json 並在規劃命名如何建構該外觀之前閱讀頂部結果。此搜尋不需要任何安裝:無需專案、無需事先 add、無需帳戶。它會從任何目錄對整個託管註冊表(約 400 個區塊和元件)進行排序,因此也適用於使用者在中途要求的外觀。規劃中命名的區塊將在第 3 階段安裝;只有在搜尋後沒有找到任何合適的結果時,才手動創作一個外觀。多場景規劃也記錄為分發工件:在 STORYBOARD.md 中每個場景對應一個 ## Frame N 區塊 — status: outline,一個宣告的 src:,藍圖/規則引用,一個

…

[為翻譯已截斷]

Individual skills in this repo

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

samyakiasonline-ctrl/hyperframe

Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet `anchor` rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.

samyakiasonline-ctrl/hyperframe

Turn arbitrary text — an article, notes, a topic, a brief — into a faceless explainer video: there is no site or footage to capture, so the visuals are invented per scene (typography, abstract graphics, diagrams, data-viz). Use for topic explainers, concept breakdowns, how-tos, listicles. Not a video built from a website (/product-launch-video — promo or tour). Unclear → /hyperframes.

samyakiasonline-ctrl/hyperframe

Import Figma content into a HyperFrames composition — rendered assets, brand tokens, components, storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI), connector-assisted motion when available, and shaders from a connector or native export. Use when the user pastes a figma.com link or asks to bring a Figma design, frame, logo, brand, or animation into a video/composition.

samyakiasonline-ctrl/hyperframe

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). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

samyakiasonline-ctrl/hyperframe

Use when audio already placed in a HyperFrames composition needs to be mixed: fade-in/fade-out, crossfade, track gain or volume, volume automation, ducking, a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), automation envelopes drawn on a track's volume or any effect parameter, or one submix bus carrying a chain, a fader and an automation clock for several tracks at once (`<hf-audio-group>`). Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.

samyakiasonline-ctrl/hyperframe

Use the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, cloudrun, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, timeline, history, clean, docs, benchmark, telemetry, transcribe, auth, tts, and remove-background. Also use when diagnosing build or render failures. validate, inspect, and layout are deprecated aliases; use check. Covers local, HeyGen-hosted cloud, AWS Lambda, and Google Cloud Run rendering.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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`.

samyakiasonline-ctrl/hyperframe

Use when a HyperFrames composition needs a punch-in, punch-out, zoom, reframe, Ken Burns treatment, camera move, visual match/whip handoff, or other seek-safe 2D/3D keyframes; also for GSAP, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, text trails, 3D depth, or `hyperframes keyframes` diagnostics. Don't use for broad scene strategy, brand design, media sourcing, captions, or general video planning.

samyakiasonline-ctrl/hyperframe

Search, install, and wire registry blocks and components into HyperFrames compositions. Use BEFORE hand-building any named visual — whenever a brief, a user, or a storyboard names a look, effect, treatment, or transition such as CRT scanlines, glitch, chromatic aberration, film grain, a shimmer sweep, a chart, a code or terminal window, a map, or a confetti burst — because roughly 400 hosted items already cover many of them and the search ranks all of them with nothing installed, no project, and no account. Also use when running hyperframes add or hyperframes catalog, installing one item or every block matching a tag, wiring an installed item into index.html, or working with hyperframes.json. Covers discovery, install locations, block sub-composition wiring, component snippet merging, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

samyakiasonline-ctrl/hyperframe

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.

samyakiasonline-ctrl/hyperframe

Use when working with a person on a HyperFrames project in Studio: first, whether their message asks for a change at all (questions, loose ideas and "don't change anything" get an answer and a plan, not an edit); for a new film, the plan, storyboard and build order that the HyperFrames launch films follow; and how the timeline should be laid out so it reads well (one caption track, one element kind per track, every scene a sub-composition) and where captions and key content may sit (safe zones). Don't use for how to perform an individual edit (split, trim, retime, volume, copy, swap): that is `creator-editing-recipes.md` in `/hyperframes-core`.

samyakiasonline-ctrl/hyperframe

Agent Media OS, the single skill for every media need in a HyperFrames project. Resolve BGM, SFX, image, icon, brand logo, voice, color grade, or LUT into a frozen local file or paste-ready block + ledger record (one verb, `resolve`); generate via TTS / music / image models when the catalog misses; produce voiceover, transcription, captions, and background removal through one shared audio engine; operate on media (cut / reframe / transform); and reuse assets across projects. Also use for vague feedback that real footage looks dark, flat, boring, should feel retro/camcorder/print/ASCII, needs privacy, or needs a media reveal.

samyakiasonline-ctrl/hyperframe

A short, design-led motion graphic where motion is the message — kinetic typography, stat count-up, chart/data-viz hit, logo sting / brand lockup, lower-third / callout / social overlay, animated map (highlight regions, connect places, zoom to a location), animated tweet / news-article / headline, webpage / UI animation (scroll, cursor, callouts), or fusing a real image's geometry into a chart. Usually under 10s (up to ~30s), no narration or live-action subject; renders to MP4 or transparent overlay. Longer / narrated / multi-scene → /general-video. Unclear → /hyperframes.

samyakiasonline-ctrl/hyperframe

Turn a music track (an audio file, a video to pull audio from, or a track generated from a mood brief) into a beat-synced video — lyric video, slideshow, or kinetic promo. The music drives all pacing; any user-supplied images/videos are cut onto the same beat grid, and a complete video needs zero assets. Narrated pieces → the input-matched workflow (see /hyperframes). Unclear → /hyperframes.

samyakiasonline-ctrl/hyperframe

Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.

samyakiasonline-ctrl/hyperframe

Turn a GitHub pull request (a PR URL, owner/repo#N, or 'this PR' in a checked-out repo) into a code-change explainer video — changelog, feature reveal, fix, or refactor walkthrough built from the diff, commits, and files: the input is a code change, not a website. Not a product promo (/product-launch-video) or a no-PR topic explainer (/faceless-explainer). Unclear → /hyperframes.

samyakiasonline-ctrl/hyperframe

Port an existing Remotion (React) composition''s source to HyperFrames HTML. Use ONLY on an explicit ask to port/convert/migrate/translate a Remotion source — one-way, Remotion-only. A passing Remotion mention, reference-only code, or "make something like my Remotion video" is a fresh build (/general-video). Unclear → /hyperframes.

samyakiasonline-ctrl/hyperframe

Author a HyperFrames slideshow — a presentation, pitch deck, or interactive deck with discrete slides, fragment reveals, branching, hotspot navigation, and built-in presenter mode with speaker notes; also converts an existing page into a deck. Output is a navigable deck, not a rendered MP4. If the user didn't explicitly ask for a slideshow, confirm before authoring. Unclear → /hyperframes.

samyakiasonline-ctrl/hyperframe

Package an existing talking-head / interview / podcast video with timed, designed GRAPHIC OVERLAY cards — kinetic titles, lower-thirds, data callouts, quotes, side panels, picture-in-picture — synced to the transcript, on a 16:9 / 9:16 / 4:5 canvas of your choice; the clip plays untouched underneath. Trigger on "graphic overlays", "on-screen graphics", "package / dress up my video". Not plain subtitles (/embedded-captions). Unclear → /hyperframes.

相關技能