Communitygithub.com

Drama2557/4RealDigital-视频工作室

当没有专门的工作流适用时,使用此技能创作或编辑自定义的 HyperFrames 合成作品,用于长篇或多场景作品、品牌宣传片、蒙太奇、静态循环、静态标题卡、素材混剪以及自由创作。

4RealDigital-视频工作室 是什么?

此技能为 AI 代理(如 Claude Code、Cursor、Codex 等)提供了一个综合性的视频合成工作流,适用于通用视频制作场景,特别是当 `BRIEF.md` 中的 `flow` 字段设置为 `companion` 时。它涵盖了从项目初始化、资产适配、合成方案设计到最终渲染的全过程。该技能强调结构化和确定性操作,要求代理在执行前通过 `npx hyperframes skills update general-video` 确保技能最新,并严格遵守一系列引用文档(如 `media-use`、`hyperframes-core`、`hyperframes-creative` 和 `hyperframes-animation`)。代理需根据项目状态(如是否存在 brief 或故事板)决定行动路径,并在 `companion` 模式下扮演导演角色,提供高质量的天花板方案,而非简单完成指令。技能还包含细致的阶段知识加载要求、多场景调度策略(内联 vs. 数据包分发)以及严格的验证循环,确保最终作品符合设计规范和用户意图。

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

在你喜欢的 AI 中提问

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

文档

通用视频

在依赖此工作流之前,请运行:

npx hyperframes skills update general-video

成功的 no-op 表示技能是最新的。如果更新失败,请报告错误,不要依赖内存中的版本继续。

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-core/references/brief-contract.md 中的关卡:协作模式等待登录或明确的离线选择;自主模式声明状态并通过可用的离线提供商继续。当没有离线提供商能满足所需功能时,报告一个阻塞项。仅本地采用不需要身份验证关卡。
  • Figma: 如果任何输入是 figma.com 的 URL,首先运行 /figma。从其导出的资产、令牌、组件或故事板框架进行构建。不要使用原始的 Figma 连接器调用,因为它们会跳过 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-core/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-core/references/brief-contract.md 的规范术语:

字段含义效果
flow谁驱动automation:选择并执行路线。companion:在对话中共同创作。
storyboard故事板是否为审查界面yes:运行计划和草图审查。no:无需故事板直接构建。
派生的 mode检查点关卡的行为方式遵循简介契约。不要询问用户来命名模式。

不要为这些状态发明同义词。一个持续的“直接构建它”信号由意图层处理,并作为 flow: automation、storyboard: no 到达。

  • 对于 flow: automation,选择路线并在第一次进度更新中用一行说明。
  • 对于特定编辑,进行编辑,不要发明新路线。

协作流程

当 flow: companion 时:

  • 读取 BRIEF.md 并将已接受的 ## Assets 和 ## Customizations 与项目构件进行核对。完成仍然待处理的已接受工作;已完成的工作保持不变;不要将已接受的功能再次作为新功能提供。
  • 以导演而非承包商的身份到来。 选择协作方式的用户选择了参与度和质量;诚实的回应是你能设计的最佳版本,而不是你能辩护的最小版本。第一计划是天花板级方案:故事弧(借用最近的体裁视角——菜单 § 体裁视角)、设计规格、按名称引用的每个场景的动态处理(§ 5 的计划纪律)、转场、音频标识——音乐和声音标记,或刻意的静音——用户材料的放置,以及设计好的开场和结束语。用一句话说明每个图层添加了什么;在提及它们时标注出昂贵的部分(渲染时间、登录、计费)。用户向下调整方案;他们永远不应该逐个批准地组装一个方案。
  • 天花板属于概念,而非工具箱。 每个图层都必须服务于简介的信息——一个会以相同方式装饰任何视频的处理方案只是装饰。工艺上升至天花板;内容永远不会超出所要求的范围(§ 6)。
  • 在检查点之间,../hyperframes/references/capability-menu.md 有两种工作方式。作为触发列表:当用户提到其输入或构建达到其需求时,提供相关的功能。作为每次通过(pass)的升级通道:一个计划、草图或构建检查点可以附带一到两个有针对性的报价,指向用户正在查看的材料(“场景 3 的状态想要计数处理”)。在提供之前阅读它;永远不要倾倒整个目录。
  • 在用户接受一个功能后,立即生成其构件,并在匹配的 BRIEF.md 主体部分中记录该决策。仅当用户明确更改时,才重写一个前置内容字段并记录已确认的偏好。
  • 保持相同的故事板、验证、最终预览和渲染批准关卡。Companion 改变的是谁在掌舵,而不是质量要求什么。

4. 在每个阶段之前加载必需知识

当条件匹配时,以下读取是强制性的:

条件读取内容
任何合成 HTML 或场景布局/hyperframes-core;使用 references/determinism-rules.md 获取其布局契约
任何非平凡的创作或视觉处理/hyperframes-creative → references/house-style.md 和 references/video-composition.md
任何动态、动画或场景转场/hyperframes-animation;遵循其路由到匹配的规则、适配器、蓝图或转场参考
storyboard: yes../hyperframes-core/references/storyboard-format.md 和 ../hyperframes-core/references/review-loop.md
任何媒体资产或操作,包括旁白、BGM、SFX、字幕、调色或变换/media-use;对于框架播放和放置,还需读取 /hyperframes-core → references/variables-and-media.md
多场景组装../hyperframes-core/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 扩展提示。一个多场景计划需要引用每个场景的形状:当有匹配的蓝图 ID 时,从 /hyperframes-animation → blueprints-index.md 获取;如果无匹配,则引用其组合的命名规则(来自 rules-index.md),当两者都不适用时。动态名称来自这些索引,从不发明。故事的真实性决定哪些场景存在;引用用于装饰它们。一个多场景计划也作为调度构件记录:在 STORYBOARD.md 中,每个场景对应一个 ## Frame N 块——status: outline、声明的 src:、蓝图/规则引用和节拍文本——即使在 storyboard: no 时也是如此。该块是调度单元;故事板仅是审查界面。

  2. 在请求时审查计划。 对于 storyboard: yes,在这些块上运行共享的审查循环。对于 storyboard: no,继续执行,不打开故事板。当计划暂停无论如何都会发生时,将子代理委派授权(步骤 4 的调度可能需要,例如在 Codex 中)折叠到该暂停中,而不是稍后再次停止。

  3. 解决依赖项。 在并行工作之前安装注册表块。搁置用户资产,采用现有媒体,仅解决简介所需的内容。当音频的时序驱动时长时,尽早开始音频工作。

  4. 构建场景。 对于短的单场景作品,在添加动态之前,在其最可见的时刻实现场景(当存在时,已确认的线框图是该最终状态,不得重绘),然后根据其引用的蓝图或规则进行动画处理——在编写动态代码之前,阅读完整的配方主体(/hyperframes-animation → blueprints/<id>.md、rules/<id>.md)。

    调度仅在规模化时才物有所值。 编写数据包和预热新的工作上下文会花费实际的时间和令牌:一个最多约 6 个短场景的电影在此上下文中内联构建更快,一个接一个场景(测量结果:5 个短场景 ≈ 9 分钟内联 vs ≈ 21 分钟数据包化)。仅在计划超出此范围时(更多场景,或单个场景较重),才进行分派,然后给予每个工作器 2–3 个场景,而不是一个,并且在 单个波次 中生成 所有工作器(第二波次几乎会使时间窗口加倍)。当分派时:

    node <SKILL_DIR>/scripts/frame-packets.mjs --project "$PROJECT_DIR" --storyboard "$PROJECT_DIR/STORYBOARD.md"

    构建器在 .hyperframes/frame-packets/ 下为每个场景编写一个有限的数据包(场景的确切故事板块 + 蓝图主体 + 每个引用的规则配方,内联)以及 _role.md(`../hyperframes-core/references/frame-worker-

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

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

相关技能