Communitygithub.com

Drama2557/4RealDigital-Video-Studio

覆盖字幕嵌入工作流的叠加层原则——定义字幕模型(丢弃/轨道/嵌入)以及字幕总是叠加在影片之上,而不是预留底部区域并上移内容的规则。在处理人物访谈或启动视频的字幕添加时、决定某句话应被丢弃、保留在逐字轨道还是提升为稀缺的嵌入高潮时、布局需要承载字幕的组合时(不要预留禁止区域),或在字幕下方以真正画面中心居中组合时加载。引用了 embedded-captions 的轨道+嵌入模型以及产品启动视频场景代理的约束 #13(字幕叠加,禁止区域已弃用)。在 embedded-captions 之上应用。

4RealDigital-Video-Studio 是什么?

该技能(DOCTRINE)为 AI 视频编辑代理(如视频组合或字幕生成工具)定义了字幕叠加核心原则。它包含两个关键概念:一是字幕模型——每个口语短语分为“丢弃”、“轨道”或“嵌入”三类,其中“嵌入”是一种稀缺的、需挣得的高峰,而非默认选项;二是叠加法则——字幕行始终以叠加层形式合成在影片之上,而不是预留的底部区域,因此无需上移内容或留出死区。该技能适用于需要添加字幕的任何视频,包括人物访谈、解释视频或产品启动视频。它基于 embedded-captions 和 product-launch-video 场景代理的核心约束,确保字幕(无论是逐字轨道还是嵌入高潮)都能正确叠加,保持完整画幅并以真正垂直中心居中。

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

在你喜欢的 AI 中提问

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

文档

字幕叠加原则

叠加原则——补充上游 embedded-captions 技能。在其之上应用;不要期望它被合并到上游技能中。

这里结合了两个概念。第一,字幕模型——每个口语短语分为 drop、rail 或 embed,且 embed 是稀缺的、需挣得的高峰,而非默认选项。第二,叠加法则——字幕行作为叠加层合成在影片之上;它不是预留区域,因此你永远不需要上移内容或留下死区来“为它腾出空间”。两者相互强化:因为字幕以叠加层方式呈现(逐字轨道在前,偶尔的嵌入在后),组合保持完整画幅并以真正垂直中心居中。

字幕模型——drop / rail / embed

每个口语短语是三类之一(直接引用自 embedded-captions):

含义如何显示
drop填充词——嗯/呃、口吃、自我纠正不显示
rail默认——普通口语内容(逐字)干净的下三分之一字幕,在前,可读。一个重音词可以获得内联 emphasis 高亮(强调色/活动词弹出)——它仍留在轨道上。
embed提升的高峰——头条节拍一个大的词合成在主体之后(遮罩遮挡),带有设计的入场和退场效果

轨道承载大部分文本;embed 是稀缺的、需挣得的高峰——每个节拍 ≤1 个,从不两个相邻/同时可见,间隔 ≥ 一个节拍。短片段→通常一个 embed;长解释视频→每个部分大约一个。每个词都嵌入是常见错误。

这是标准模式形状(rail = 逐字下三分之一;embed = 合成在主体后的高潮)。电影模式去掉轨道并使所有内容变为 embed 风格——仅用于纯电影化要求,绝不要用于需要文字可读的解释/画外音。

轨道优先,embed 稀缺(承载规则)

引用自 embedded-captions 的不可协商项:

  • 人物访谈/解释视频轨道优先。 不要嵌入整个转录——大多数文本是轨道;仅嵌入高峰。嵌入所有内容是默认错误。
  • Embed 稀缺且间隔。 每个句子/节拍 ≤1 个 embed,从不两个相邻或同时可见,间隔 ≥ 一个节拍,最多一个 apex。climax = 每个节拍的高峰,而非 "整个片段的唯一高潮点"。

叠加法则——字幕不是预留区域

在生成的发布组合中,当启用字幕时,finalize 会合成一个小的、最小化的逐词字幕行作为叠加层位于整个影片之上(单行文本,底部居中,大约占画布高度的底部 ~5-8%)。它是叠加层,不是预留区域(直接引用自 product-launch-video 场景代理的约束 #13):

  • 将组合居中在真正垂直中心——y = H / 2(横屏 540,竖屏 960)。不要上移内容来"为字幕腾出空间";居中在 0.42 × H 并留有底部死区是 bug,不是修复。
  • 内容可以延伸到画布底部。全出血的主体、轨道和背景都欢迎。
  • 一条软性礼貌规则: 避免将_关键的小可读文本_(URL 行、法律行、副字幕)正好放置在字幕行所在的底部 ~80px 中心区域——叠加层会与之冲突。字幕下方的大图像/卡片/环境内容没有问题;字幕皮肤设计为在内容之上可读。
  • 没有机器禁止门(旧的 captions.mjs keepout 检查已弃用)。Finalize 快照 QA 通过视觉判断字幕在内容之上的可读性。

当字幕禁用时: 相同的定位自由——叠加层根本不存在。

为何这两条规则构成一个原则

该模型规定轨道在前,而 embed 是一个罕见的词合成在主体之后——两者都是添加到原始素材上的图层。叠加法则规定字幕行是合成在整个影片之上的图层,而不是从布局中切出的带状区域。因此,在字幕流程和发布视频流程中,字幕都是你添加的叠加层,而不是你预留的区域:

  • 保持完整画幅;居中在真正中心;让内容延伸到边缘。
  • 让轨道(或小的叠加字幕行)承载逐字词。
  • 仅在真正的高峰处将一个词提升为 embed——稀缺、间隔、从不两个同时出现。
  • 不预留任何东西;通过视觉判断字幕在内容之上的可读性,而不是通过禁止门。

Individual skills in this repo

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

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

GATEWAY — load FIRST before composing any HyperFrames animation or video. The high-level motion law that makes a multi-scene video feel like ONE continuous camera move instead of a stack of independently-animated slides. Covers the vector law (how you exit determines how you enter, incl. the Z scale-sign rule), the film's current, carrier elements, causal motion, the Seam Gate (build-gate enforcement), the ban on idle wobble (motion must PERFORM, not breathe), stillness-before-climax, and the sustained-motion routes. Routes to the low-level technique skills (cut-the-curve — the full catalog incl. waterfall entry + nudge curve, oversized-cursor, seam-craft). These rules SUPERSEDE generic / upstream motion guidance. [continuity, direction, vector, momentum, seam, transition, ease, performance, idle-motion, narrative-motion, film-grammar]

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

相关技能