Communitygithub.com

Drama2557/4RealDigital-Video-Studio

GATEWAY — 在编排任何 HyperFrames 动画或视频之前首先加载。这个高级运动法则让多场景视频感觉像是一个连续的摄像机运镜,而不是一堆独立动画幻灯片的堆叠。涵盖向量法则(如何退场决定如何入场,包括Z轴缩放符号规则)、影片流动、载体元素、因果运动、无缝门(构建门强制执行)、禁止空闲抖动(运动必须表演,而非呼吸)、高潮前的静止以及持续运动路线。指向底层技术技能(cut-the-curve — 完整目录包括瀑布入场+微调曲线、超大光标、无缝工艺)。这些规则优先于通用/上游运动指导。[连续性、方向、向量、动量、无缝、过渡、缓动、表演、空闲运动、叙事运动、影片语法]

4RealDigital-Video-Studio 是什么?

Motion Doctrine (Gateway) 是一个用于 HyperFrames 的高级运动法则技能,定义了多场景视频中连续运镜的规则。它旨在防止场景孤立创作导致的视觉动量中断和场景间不自然的摆动。核心规则包括向量法则(退场决定入场)、流动方向(默认左向)、载体元素传递、因果运动链以及无缝门验证。该技能通过载体网格记录(ledger.json)和脚本(seam-stamp.mjs、seam-gate.mjs)强制执行,确保每个场景切换符合运动连续性。它适用于任何基于 HyperFrames 的动画或视频项目,特别是需要流畅叙事运镜的产品发布、解释器或字幕项目。技能还禁止空闲摆动和交叉淡入淡出,推荐持续运动路线(如阶段揭示、带意图的摄像、光标引导操作)来填充场景时间。

兼容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Drama2557/4RealDigital-Video-Studio/tree/HEAD/.agents/skills/motion-doctrine

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

运动法则(网关)

在编排任何动画之前阅读此文档。它决定了在每个接缝处发生什么以及每个场景如何表演;技术技能实现它。这些规则优先于通用/上游运动指导。此规则防止的失败:孤立创作的场景——眼睛的动量在每个剪辑处消亡,并且场景在入口和出口之间原地摆动。

路线图

决策(本技能)实现技能
无缝过渡选择 + 参数 + 代码cut-the-curve §1–5(目录)
文本/元素入场级联cut-the-curve §6(瀑布入场)
场景内组重新定位(无剪辑)cut-the-curve §7(微调曲线)
光标引导动作/场景启动/变形点火oversized-cursor
无缝渲染机制/白色闪光防护seam-craft
产品发布/解释器/字幕工作在上级技能之上叠加 text-beat-economics、brand-faithful、captions-overlay

创作顺序:向量台账(ledger.json)→ 从台账标注主接缝(scripts/seam-stamp.mjs --ledger ledger.json --write index.html)→ 每阶段的持续运动路线 → 载体和原因 → 构建构图 → 验证(scripts/seam-gate.mjs)。 仅手动创作 Tier-A 变形/匹配剪辑;标注接缝通过构建通过验证。


第一部分 — 接缝法则

向量法则

场景 A 如何退场决定了场景 B 如何入场:相同轴、相同方向、匹配速度、两侧均在运动中剪辑。

  1. 轴 — x 保持 x,y 保持 y,Z 保持 Z。绝不要在剪辑时切换轴。
  2. 方向 — 绝不要镜像。对于 Z,方向 = 缩放变化的正负号:变大 = 推(摄像机向前),变小 = 拉(摄像机向后)。后退退场后跟从小变大的入场是一种镜像向量——最常见的违反,因为从小变大是默认的元素入场方式。
  3. 速度 — 入场初始速度 ≈ 退场最终速度,通过镜像缓动实现(退场 power4.in + 入场 power4.out,相同距离和持续时间;入场方的速度达到概念路径的 ≥50%)。机制详见 cut-the-curve。
  4. 相位 — 剪辑落在两侧的运动中。在剪辑前静止下来,或在剪辑后从静止开始,都是死板拍子。

流动

每部影片选择一个主导方向(默认:向左)。每个普通接缝使用它。其他向量是保留的——使用其中一个意味着某种含义:

向量含义
流动(向左)"下一个节拍" — 中性的前进进展
向上提升 — 结论或揭示高于之前的内容
Z 向前(缩放穿越)推入同一想法的更深层次
Z 向后(反向缩放)到达 — 更重大的事物降临
缩放爆发(爆炸退出)离开一个世界 — 表面从摄像机前掠过
  • 绝不要在连续接缝中运行相反方向——来回切换读作错误。
  • 方向改变需要可见原因(点击/弹跳/碰撞)或章节边界。

向量台账

在创作任何主时间线之前编写它——作为项目根目录下的 ledger.json(模式:references/seam-gate.md)。每个接缝一行:剪辑时间、退场和入场向量(轴+有符号方向;Z 行携带缩放符号)、选择器、技术。退场和入场必须匹配;如果某行不匹配,修复计划,而非缓动。验证器在运行时采样之前静态检查行一致性。

载体

眼睛跟随对象,而非抽象概念。最强的接缝在剪辑处传递一个具体的载体,并匹配位置和速度:光标中途路径、缩合/对接入下一个布局的容器、飞入其确切位置的标记、瀑布剪辑的单词组。没有自然载体时,场景主角承载它(部分移动 + 早期淡出,入场中途飞行)。绝不要使用交叉淡入淡出——它根本没有载体。

因果运动

将动作链接起来,使每个移动明显由上一个启动:点击 → 压缩 → 松开发射 → 飞行 → 撞击 → 回弹 → 揭示。

  • 效果在导致帧上开始——相同时间线位置,绝不要“稍后”。
  • 反应与隐含质量成比例:大元素反弹更慢,小元素快速弹回。
  • 力是改变方向的许可证;无原因的翻转是来回切换。

无缝门(构建门 — 运行验证器,退出代码为 0 或接缝未完成)

node <SKILL_DIR>/scripts/seam-stamp.mjs --ledger ledger.json --write index.html  # 生成
node <SKILL_DIR>/scripts/seam-gate.mjs verify --ledger ledger.json --project .  # 验证

该脚本(用法 + 台账模式:references/seam-gate.md)在数值上强制执行每个接缝:台账行一致性、退场在剪辑时仍在运动、入场中途飞行(绝不要从静止开始)、测量方向 = 台账方向、入场/退场速度匹配(警告)、零重叠(每帧仅一侧可见 — 剪辑不是溶解)、Z 符号规则(d(scale)/dt 两侧符号相同;扫描入场场景自身的入场是否存在符号冲突)、以及包含祖先缩放的载体矩形连续性。在编写台账时使用 seam-gate.mjs probe --t <cut> 找到每个接缝的真实载体选择器。

脚本无法检查的规则——仍然由你负责:

  1. 编辑重新打开接缝。 对场景的前/后约 1 秒的任何更改(包括为新的配音重新计时)都会使该边界的审计失效——重新运行验证器。
  2. 音频是时钟。 根据配音的实际单词时间戳重新计时场景;绝不要为了适应槽位而匆忙朗读。配音重新生成会重新打开其接缝。
  3. 剪辑门控陷阱(零重叠失败的常见原因):data-start 在其入场补间之前的剪辑在其初始不透明度下取消隐藏——设置初始 autoAlpha: 0 并且 data-start = 剪辑时间,绝不要更早。

第二部分 — 表演(场景持续表演)

无空闲抖动

空闲正弦循环(呼吸、浮动、漂移、发光脉冲)被禁止作为持续运动——它们读作“视频在等待”。一个入场后还剩几秒钟的场景是规划错误:添加故事,而不是抖动。入场和退场之间的每个阶段由以下路线之一拥有(在计划中命名路线):

路线是什么
分阶段揭示保留内容;在叙述节拍上兑现它——画面不断获得信息(≥2 个内容组的默认方式)
带意图的摄像映射的缩放+平移路径:建立广角 → 移动 → 到达主体
序列化 UI 生命产品随时间变化:进度推进、高亮步骤、计数滴答
动画序列元素表演一个节拍:卡片归档到堆栈、项目被拖动、结果组装
光标引导动作超大光标引导眼睛到触发器;其点击点燃下一个节拍(oversized-cursor)

测试:在任意时间暂停——必须有意义的事情在空中飞行(揭示着陆、摄像机移动、UI 正在做叙述所说的内容)。

高潮前的静止

在主要动作和其结果之间安排一个 0.3–0.75 秒的暂停——戏剧性的逗号。直接从动作跳到结果的场景会失去它。

计时意图

  • 单次入场 ≤ 约 800 毫秒;更长的铺垫 = 多元素交错,而非一个慢元素。
  • 退场 ≈ 入场的 75%。异常:cut-the-curve 反转此规则(入场约 127% 的退场)。
  • 总交错 ≤ 500 毫秒;对于 8 个以上元素,收紧每个项目的延迟或交错前几个。
  • 禁止的缓动:bounce.out / elastic.out。入场超调 back.out(1.4–1.7) 可以。
  • 相似元素共享一个缓动+持续时间意图——绝不要为每个元素设置唯一的对。

过渡词汇表

每部影片仅使用 2–3 种场景间过渡并重复使用;默认边界是在流动方向上的 cut-the-curve。手写共享元素变形(intent: morph)不计入预算。


反模式

不要改为
孤立创作每个场景的入场先编写向量台账
场景间交叉淡入淡出在流动方向上使用 cut-the-curve
退场完成,然后场景改变两侧均在运动中剪辑
剪辑后入场从静止开始进入 ≥50% 的概念路径
反向缩放退场 → 从小变大入场(或推 → 超大回缩)匹配缩放速度符号(无缝门 7)
入场场景自身的弹出介绍在 Z 接缝交接下保持其开场构图,或匹配符号
空闲抖动/呼吸/浮动以填充时间分配持续运动路线;或添加故事
无原因的方向翻转使用一个力,或保持流动
保留向量用作多样性默认为流动;将它们用于含义
反应在其原因后几帧同帧点火
动作直接跳到结果安排高潮前静止(0.3–0.75 秒)

Individual skills in this repo

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

Drama2557/4RealDigital-Video-Studio

Overlay doctrine for the embedded-captions workflow — the caption MODEL (drop / rail / embed) and the rule that captions are an OVERLAY composited on top of the film, never a reserved bottom band you shift content up to avoid. Load when adding captions/subtitles to a talking-head or launch video, when deciding whether a phrase should be dropped, ride the verbatim rail, or be promoted to a scarce embedded climax, when laying out a composition that will carry captions (do NOT reserve a keep-out band), or when centering a composition on the true frame center under captions. Quotes the rail+embed model from embedded-captions and constraint #13 (captions overlay, keep-out band retired) from the product-launch-video scene agent. Applies ON TOP of embedded-captions.

Drama2557/4RealDigital-Video-Studio

Turn a weekly changelog .md into a finished branded changelog video (square 1080, ~45-60s, Annie VO, animated brand background, mock-UI visualizations, lowkey captions). Use when the user provides a changelog/digest markdown and wants the weekly video, or says "changelog video". Self-contained — fonts, background, lexicon, and scripts ship in this skill.

Drama2557/4RealDigital-Video-Studio

The technique catalog: five velocity-matched SEAMS (zoom-through, INVERSE zoom-through, cut-the-curve, waterfall cut, rack-focus blur-cut) plus the two in-scene techniques — waterfall ENTRY (staggered arrival cascades for title cards / segment openers) and the nudge curve (slow-fast-slow three-phase group slides). Covers partial-travel (~12% of frame) velocity matching via mirrored power4 eases, the Z scale-sign rule, size-scaled blur (10px text / 18-20px full-frame), word-by-word staggered cuts, cascade pacing by element weight, and the 10/65/25 slide ratio. Read before authoring any transition, text-beat handoff, kinetic text entry, or group reposition. [depth, zoom, inverse-zoom, scale-sign, mirrored-zoom, rack-focus, pacing, velocity, cut-the-curve, waterfall, stagger, cascade, kinetic-text, title-card, segment-opener, nudge, slide, easing, group-motion, z-depth, motion-graphics, cinematic, transition, blur, directional-continuity]

Drama2557/4RealDigital-Video-Studio

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.

Drama2557/4RealDigital-Video-Studio

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.

Drama2557/4RealDigital-Video-Studio

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.

Drama2557/4RealDigital-Video-Studio

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

Drama2557/4RealDigital-Video-Studio

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

Drama2557/4RealDigital-Video-Studio

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. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition HTML.

Drama2557/4RealDigital-Video-Studio

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

Drama2557/4RealDigital-Video-Studio

Install, discover, and wire registry blocks and components into HyperFrames compositions. 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).

Drama2557/4RealDigital-Video-Studio

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.

Drama2557/4RealDigital-Video-Studio

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.

Drama2557/4RealDigital-Video-Studio

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.

Drama2557/4RealDigital-Video-Studio

House-style oversized macOS cursor technique for HyperFrames launch videos. Load whenever a scene involves cursors or a pointer-led action, when kicking off a UI scene, when igniting a morph/transition/typing run with a click, or when a scene reads as static, dead, or stale and needs a cheap high-yield source of motion to carry the viewer's eye and segment them out of the stale state. Covers cursor size/look (incl. brand-motif cursors), the off-screen entry law, tip-targeting and the click tap, click-ignites-the-next-beat, and exit / cross-scene handoff.

Drama2557/4RealDigital-Video-Studio

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.

Drama2557/4RealDigital-Video-Studio

Render-correctness doctrine for scene-to-scene seams in HyperFrames launch videos — the prerequisites that make transitions composite correctly on the master timeline. Load when assembling the master timeline / index.html, when a white flash appears at a cut or crossfade seam (especially on dark films), when reasoning about why a transition opacity dip shows through, or when verifying the render-side mechanics of how overlapping scene wrappers blend. Covers the opaque stage-ground (#root background) white-flash guard and how the injector overlaps wrappers, holds final frames, ping-pongs tracks, and stamps lint-clean template code onto the master timeline. Does NOT contain the per-transition catalog — see the transition registry for individual transition entries.

Drama2557/4RealDigital-Video-Studio

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.

Drama2557/4RealDigital-Video-Studio

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.

Drama2557/4RealDigital-Video-Studio

Agent skill / project related to launch or product demo video: Drama2557/4RealDigital-Video-Studio

相关技能