Communitygithub.com

HyperFrames Studio 工作规范

用于在 Studio 中与团队成员协作 HyperFrames 项目时使用:首先判断消息是否要求更改;对于新影片,遵循计划、分镜和构建顺序;并规定时间线的布局规范(一个字幕轨道、每种元素一个轨道、每个场景一个子合成)以及字幕和关键内容的安全区域。

HyperFrames Studio 工作规范 是什么?

该技能为使用 HyperFrames Studio 的用户提供了一套明确的协作和构建规范。它首先指导 AI 助手判断用户消息的意图——是要求修改、提问、提建议还是创建新影片——从而避免在理解不清时错误地修改文件。对于新影片,技能规定了“计划-分镜-构建”的明确步骤顺序,并引用了 HyperFrames 生态中的相关参考文档。在时间线布局上,技能强制要求所有字幕放在单一轨道、每类元素使用独立轨道、每个场景作为独立子合成文件,以确保时间线可读且易于编辑。此外,技能定义了动作安全框和标题安全框的范围,确保关键内容始终可见。该技能适用于所有 HyperFrames Studio 项目,不适用于单个剪辑操作(如分割、修剪、变速),这些操作应由专门的剪辑配方处理。

兼容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/laviedezidane/hyperframes-skill/tree/HEAD/.agents/skills/hyperframes-studio

在你喜欢的 AI 中提问

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

文档

插件安装: 在执行设置或刷新命令之前,请先遵循 插件执行规则(当此技能位于 HyperFrames 插件内时)。独立安装则保留以下更新说明。

HyperFrames Studio 工作规范 是做什么的?

Studio 会为每个顶级元素绘制一个时间线行。遵循以下规则的项目会呈现为一个简短、可读的时间线;不遵循的项目则会显示为一堆无法编辑的无标签行。以下是构建时应遵循的规范。关于如何修改剪辑,请参阅 /hyperframes-core 的 references/creator-editing-recipes.md,切勿发明同一种编辑的不同形式。

0. 先沟通,再构建

在打开文件之前,先阅读消息。判断对方的要求:

对方你
指定了更改内容,无论多么礼貌(“把标题放大一点”、“能删掉第三场吗?”)执行更改。
对已构建的影片给出感觉性意见(“开头感觉不连贯”、“时长不够长”)找出原因,更改可衡量的内容,说明意见所指以及变动了什么,并按照 /hyperframes-creative 的 references/storyboard-recipe.md § 4 记录。
提出疑问且未指定更改(“为什么标题会跳动?”)回答疑问。不更改任何内容。
说不要更改任何内容、暂停、“只是想想”、“我们谈谈”不更改任何文件,即使你注意到了错误。用语言提出建议。
针对该影片提出想法但没有具体更改(“我希望结局更有气势”)提出更改并将其加入计划(下文)。不更改任何合成文件。
要求创建新影片制定计划(§ 5)。
批准计划(“开始构建”、“执行”)按批准的计划进行构建。

如果消息同时包含疑问和更改要求,则同时进行回答和更改。只有当你无法判断是否要求任何更改时,才进行对话:一个错误的回答浪费一条信息;一个错误的构建则浪费长时间运行和一轮反馈。

对话回复应符合以下要求:

  • 首先用简单的语言、几句话回答。
  • 只提问那些答案会影响影片的问题,同时给出推荐答案及其权衡(“30 秒适合信息流;60 秒为演示留出空间”)。
  • 当需要塑造想法时:对于新影片,按照 /hyperframes 的 references/pitch-round.md 提供方向;对于有关当前影片的想法,针对所指部分提供两到三个选项,并推荐其中一个。
  • 以下一步操作和启动该操作的词语结束(“说‘开始’,我就动手”)。

将计划保留在项目中,而不仅仅在聊天中:下一条消息可能开启一个无法看到当前会话的新会话。按照 /hyperframes-creative 的 references/storyboard-recipe.md § 4 记录回合的方式,将计划添加到 STORYBOARD.md 中;切勿覆盖已锁定的帧。如果对方要求你完全不更改任何内容,则什么也不写:将计划放在回复中并提供保存选项。

1. 每个场景是一个子合成

根合成只包含定时主机、媒体和音频。任何具有嵌套结构(包含子元素的 div、带副标题的标题、图表)的场景都应作为独立文件,使用 data-composition-src 加载,并按照 /hyperframes-core 的 references/sub-compositions.md 进行连线。

留在根合成内部的嵌套标记不会成为单独的行,而是隐藏在一个无法逐部分修剪或移动的不透明行中。

编写时,应假设存在一个结构检查工具,任何违规都会导致报错。

2. 一个字幕轨道

  • 所有字幕位于一个轨道上:一个标记为 data-track-kind="captions" 的子合成主机(一个 data-track-index),按顺序承载所有字幕组。
  • 不允许每个字幕组占用一行,也不允许将字幕与其它类型的元素混放在同一轨道上。
  • 单词时间规则不变:请参阅 /embedded-captions 和 caption_* 语法检查规则。

3. 每种元素一个轨道

按类别分组,使每一行代表一组用户可以选择、静音或拖动的元素。

类别data-track-kind
基础视频 / A-rollvideo(来自标签)
场景、叠加层、图形graphics
字幕captions
音频(旁白、音乐、音效)audio(来自标签)

在子合成主机上设置 data-track-kind。视频和音频类别来自标签,因此 <video> 和 <audio> 无需属性。为每个类别分配独立的 data-track-index;该编号仅用于显示,不会改变渲染图层顺序。请使用 CSS 控制图层叠加。

4. 安全区域

任何标尺或安全框叠加都应在预览面板中,而非合成内部,因此不要在 HTML 中添加引导元素。 两种画幅(宽屏和竖屏)都使用相同的两个安全框,即 Premiere 的默认设置。预览切换会在每边中点绘制一个标记。来源:packages/studio/src/utils/previewSafeMargins.ts 中的 ACTION_SAFE_PERCENT 和 TITLE_SAFE_PERCENT。

安全框占画面比例每边内缩
动作安全框90%5%
标题安全框80%10%
  • 安全边距:所有可见内容保持在动作安全框(90%)内,字幕和关键内容保持标题安全框(80%)内。
  • 双栏和 50/50 布局中,每半部分的内容保持在标题安全框内。

5. 新影片:计划、分镜、构建

hyperframes-launches 中的影片按此顺序制作。每个步骤都有负责人;请遵循该步骤,不要在此重新说明。

步骤负责人
1. 简报/hyperframes 的 references/intent-interview.md。在现有项目内部,只有同一影片的后续工作才保留:新版本或缩减版,采用相同的工作流程和宽高比。询问其必须回答的问题,跳过 hyperframes init,切勿覆盖 BRIEF.md 或 STORYBOARD.md,为每个文件添加一个新的带日期部分,并在回复中说明。具有不同工作流程或宽高比的影片启动新项目,并在回复中说明。
2. 方向/hyperframes 的 references/pitch-round.md
3. 分镜/hyperframes-creative 的 references/storyboard-recipe.md
4. 构建简报所指向的工作流程(/hyperframes § 2)及其自身的参考文献
5. 备注/hyperframes 的 references/review-loop.md

以下是发布影片在发布时的额外要求。如果工作流程选择的弧线另有规定,则以弧线为准。

  • 发布产品的真实镜头。 在简报中要求提供屏幕录制,除非工作流程本身会捕获(例如从 URL 捕获网站),并用带有标签的占位符预留位置,直到素材到达。切勿近似发布产品的 UI。作为上下文显示的第三方工具(如聊天应用、编辑器)应从录屏中忠实重建。
  • 统一的世界。 同一个窗口或画布在节拍之间保持连续。检查每一个剪切点:任何持续出现的元素不得跳跃。
  • 光标和滚动内容。 光标或窗口自身滚动出画面之外的内容,应从窗口或画框边缘离开,而非在画面中间淡出。元素和文本交换应遵循工作流程的 cut-catalog.md(如果存在)。
  • 在命令或地址上结束, 并且品牌标志出现在仍在运动的镜头中。
  • 在每次迭代中注明运行时长。 是否超过目标时长由对方决定,而非你。

检查你的工作

运行 hyperframes check(它会运行语法检查)并修复所有发现的问题。然后在 Studio 中打开项目,检查时间线是否显示一个基础行、每个场景主机一行、一个字幕行以及所有音频行。

Individual skills in this repo

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

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

Agent Media OS for 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. When the host app provides its own music or sound-effect tools, use those for music and sound effects; `resolve --type bgm|sfx` needs the heygen CLI. When `HEYGEN_API_BASE` is set, HeyGen calls go through that host with no CLI sign-in.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

相关技能