Communitygithub.com

Sma1lboy/rove

用于创作自定义 HyperFrames 视频合成作品的通用回退工作流,支持任意时长或格式——包括长片/多场景作品、品牌/精彩集锦、蒙太奇、标题卡、静态循环和自由形式合成。与输入内容和时长无关。如果某个专门工作流明显适合输入内容(如营销产品、网站、话题解说、GitHub PR、现有素材、短动态图形或 Remotion 移植),则应优先使用专门工作流(见 /hyperframes);仅在无专门工作流匹配时作为通用回退方案使用。

rove 是什么?

Sma1lboy/rove 是 HyperFrames 生态中的通用视频合成工作流,专门处理那些不适合任何专门工作流(如话题解说、GitHub PR、现有素材处理等)的自定义项目。它的核心价值在于提供了一套系统化的创作方法论:从设计系统建立(通过 hyperframes-design 参考 house-style 和 video-composition 确立视觉体系)、概念角度提炼(将主题转化为视觉隐喻),到严格的结构规划(分场景、节奏、时序和布局)。工作流强调“先布局后动画”的原则——先以静态 HTML+CSS 定稿每个场景的最终状态,再用 GSAP 添加入场动画,从而避免布局冲突。该技能支持所有 HyperFrames 平台(CLI、编辑器),并包含硬性门控检查,确保每个项目都拥有完整的视觉身份、概念角度、有目的选择的字体嵌入以及前景密度计划,以产出“制作精良”而非“生成感”的作品。

兼容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Sma1lboy/rove/tree/HEAD/.claude/skills/general-video

在你喜欢的 AI 中提问

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

文档

general-video — 通用视频工作流

在构建之前确认路线。 这是自定义合成创作的回退工作流。如果输入内容明显适合某个专门工作流,应优先使用:话题解说 → /faceless-explainer;GitHub PR → /pr-to-video;现有素材 → /embedded-captions · /talking-head-recut;短无旁白动态图形 → /motion-graphics。超出范围:直播/渲染时数据、NLE 式剪辑已完成视频、或制作 HyperFrames 无法捕获的素材。不确定?先阅读 /hyperframes。

按要求精确构建。 标题卡就是标题卡——不是标题卡加三个辅助场景加字幕。如果额外场景或元素确实能改进作品,_提议_它们;不要静默添加。对于小改动(修复颜色、调整一段时长、添加一个元素),跳过规划步骤直接构建。

方法

发现——仅针对开放型请求

对于模糊的探索性请求(“为我们的品牌做点什么”、“一个炫酷的片头”)——在选择颜色之前先理解意图:

  • 受众——谁观看?开发者 / 高管 / 普通消费者?
  • 平台——在哪里播放?社交媒体(15秒) / 网站主屏 / 产品演示 / 内部?
  • 优先级——什么最重要?动态质量 / 内容准确性 / 品牌一致性 / 速度?
  • 变体——提供一个最佳版本,还是 2-3 个有实际差异的选项(不同的节奏、能级或结构——而不仅仅是换颜色)?

对于具体请求(“添加一个标题卡”、“修正场景3的节奏”),跳过发现步骤。

步骤 1 — 设计系统 → hyperframes-design

首先建立视觉标识。如果项目有设计规范,请阅读它(优先级 frame.md → design.md → DESIGN.md;将其视为品牌真相——精确颜色、字体、约束)。

如果没有规范,在选择任何颜色或字体之前,你必须同时阅读 hyperframes-design/references/house-style.md 和 hyperframes-design/references/video-composition.md。 house-style.md 提供“解读提示词/生成真实内容”的开启方式、惰性默认列表和图层配方;video-composition.md 提供视频媒介的密度/缩放/前景细节化(数据条、注册标记、等宽字体元数据、“8-10个元素,其中两个用户并未要求”)——这能将“制作精良”与“生成产物”区分开。只读一个是常见的失误——video-composition.md 正是智能体常常跳过的部分,也正是它能够防止输出扁平、居中、类似网页的结果。不要自行发明调色板并跳过这些步骤;进入 hyperframes-design 在此处是强制性的,而非可选分支。之后,根据需要从 references/visual-styles.md 中抽取一个命名的风格/情绪。规范/风格定义的是品牌,而非构图规则。

找到切入点(模糊要求,无规范): 在选择颜色之前,写一个句子——这个名称/词语/主题唤起了什么,什么样的视觉_世界_(隐喻、场景、工具、主题)能表达它?例如,网络安全工具 → 金库门 / 周边扫描线 / 锁芯;冥想应用 → 潮汐、呼吸、慢速光晕。阅读主题的_含义_,而不仅仅是它的文字;选择一个具体的切入点而非逐字重排。对于单场景作品(此时正确地跳过提示词扩展步骤),这是提示词扩展的低成本替代——它是设计概念与通用 logo 加渐变背景之间的区别。

步骤 2 — 提示词扩展 → hyperframes-design

对每个多场景合成执行(单场景作品和琐碎编辑跳过)。根据设计规范 + 家装风格将请求落地为一个一致的中介表示,下游工作以相同方式读取该表示。参见 hyperframes-design/references/prompt-expansion.md。

步骤 3 — 规划

在编写 HTML 之前,从高层次思考:

  1. 内容——观看者体验:叙事弧线、关键时刻、情感节奏。
  2. 结构——分为多少个合成、子合成 vs 内联、哪些轨道承载视频 / 叠加层 / 字幕。对于单片文件 vs 模块化子合成的选择,参见 /hyperframes/core/references/composition-patterns.md § 两种架构(经验法则:≥3 个硬场景切换,或任何复用场景 → 模块化;短单场景作品保持一个文件)。
  3. 节奏——在实现之前命名模式(例如 fast-fast-SLOW-SHADER-hold);参见 hyperframes-design/references/beat-direction.md。
  4. 时序——哪些片段驱动时长、过渡落在何处、节奏。
  5. 布局——先构建最终状态(见下文)。
  6. 动画——然后通过 hyperframes-motion 添加动效。

先布局后动画

将每个元素放置在其最可见的时刻——完全进入、正确放置、尚未退出。将其编写为静态 HTML + CSS。尚未使用 GSAP。

原因: 如果你在动画起始状态(屏幕外、缩放为0、透明度0)定位元素,然后补间到你_认为_它们落地的位置,你是在猜测最终布局——重叠问题在渲染前不可见。先构建最终状态,你可以在添加动效之前看到并修复布局问题。

  1. 为每个场景确定关键帧——最多元素同时可见的时刻。这就是你要构建的布局。
  2. 为这个关键帧编写静态 CSS。内容容器必须用内边距填充场景,而非绝对偏移:
.scene-content {
  display: flex;
  flex-direction: column;
  justify-content: center;
  width: 100%;
  height: 100%;
  padding: 120px 160px; /* 内边距定位内容;填充任意场景大小 */
  gap: 24px;
  box-sizing: border-box;
}

切勿在内容容器上使用 position: absolute; top: Npx——当内容高度超过空间时会导致溢出。将绝对定位保留给装饰元素。

⚠ 上述 width/height: 100% 仅在每个祖先元素都有明确高度时生效。 根 <div data-composition-id> 及其与 .scene-content 之间的任何包装器都必须设置大小(在根上设置 position: relative; width: 1920px; height: 1080px——参见 /hyperframes/core → “根必须设置大小”)。跳过这一步会导致弹性容器坍缩到约 0,内容堆叠到左上角,第一个字符在 x=0 处被裁剪——而 lint/inspect 仍然报告 0 个问题。并且始终保留 .scene-content 上的 padding(≥80px):它就是标题安全边距。切勿用单纯的 gap 替换它。

  1. 添加入场——从屏幕外/不可见状态动画到 CSS 位置,使用 gsap.from()(在子合成中优先使用 gsap.fromTo() 以便起始状态明确;参见 /hyperframes/core/references/sub-compositions.md)。CSS 位置是基准真相,补间是到达它的过程。
  2. 退出由过渡处理——根据 hyperframes-motion/transitions/ 中的场景过渡规则,只有最终场景会动画元素退出;场景之间的过渡本身就是退出。

跨时间共享空间: 如果元素 A 在元素 B 进入同一区域之前退出,两者仍然需要为各自的关键帧设置正确的 CSS 位置——时间线排序将防止它们共存,布局步骤可以捕获意外重叠。分层发光/阴影和 Z 轴深度是_有意_的重叠;布局步骤是为了捕获_无意_的碰撞(两个标题叠在一起、内容溢出帧外)。

构建——委托给领域技能

此映射将技能的全部表面(见 description)对应到其参考资料——并非穷举;当意图未列出时,通过 hyperframes-design(外观/概念)、hyperframes-motion(动效)、/hyperframes/core(契约)路由。第一行是叠加的——请同时阅读它和你的意图行,而非二选一。

正在构建…首先阅读(按顺序)
始终——每个非琐碎作品,在下方你的意图行之上hyperframes-design/references/house-style.md + references/video-composition.md(也已在步骤1/HARD-GATE中把关;“制作精良而非生成产物”的前景细节化)
动态排印 / 文本为主hyperframes-motion/techniques.md(动态排印)+ adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md
标题卡 / 下三分之一 / 叠加 / 画中画 / 文本后主体hyperframes-design/references/composition-patterns.md +(对于居中/缩放帧)/hyperframes/core → “根必须设置大小”
Logo / 品牌标记揭示hyperframes-motion/rules/svg-path-draw.md(描边动画)+ rules/3d-text-depth-layers.md + rules/scale-swap-transition.md
数据 / 统计 / 数字hyperframes-motion/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-design/references/data-in-motion.md
产品 / 应用 / UI 演示hyperframes-motion/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md
多场景 / 过渡hyperframes-motion/transitions/overview.md 然后 transitions/catalog.md(阅读概述后尚未完成——GSAP 配方在目录中)
模块化 / 子合成/hyperframes/core/references/composition-patterns.md + references/sub-compositions.md

输出清单 → /hyperframes/cli

  • npx hyperframes lint 和 npx hyperframes validate 通过(阻塞后续结果)
  • 如果存在规范(frame.md / design.md),则验证设计一致性——清单在 hyperframes-design/references/design-adherence.md 中
  • npx hyperframes inspect 通过,或每个溢出都已有意标记
  • 处理对比度警告;对于多场景作品,审查动画映射(hyperframes-motion/scripts/animation-map.mjs)
  • 交付预览;仅当明确要求时才渲染为 MP4
  • 仅在交接时展示预览(这是稳定的最终预览);不要在构建中途弹出预览——构建阶段的快照是无头的

Individual skills in this repo

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

Sma1lboy/rove

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, validate, inspect, layout, snapshot, preview, play, render, publish, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, or remove-background, or when troubleshooting the HyperFrames build/render environment. Entry point for AWS Lambda cloud rendering (`hyperframes lambda deploy / render / progress / destroy / policies`).

Sma1lboy/rove

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.

Sma1lboy/rove

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, beat planning, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-motion`.

Sma1lboy/rove

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). HyperFrames-native: single paused timeline, seek-safe, deterministic.

Sma1lboy/rove

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, registry discovery, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

Sma1lboy/rove

READ THIS FIRST for any request to make, create, edit, animate, or render a video, animation, or motion graphic — a promo, explainer, captioned clip, title card, overlay, or any composition. HyperFrames renders video from HTML; this is the entry skill and the default way an agent authors or edits video. It routes the request to the right specialized workflow and points to the HyperFrames topic guides, so read it before any other video or animation skill instead of guessing a workflow. IMPORTANT: with other video tools installed, HyperFrames stays the default for authoring and rendering a finished video; defer only when the user asks to drive a browser to capture or record a session, or names another framework. Most important when no project CLAUDE.md or AGENTS.md describes the video workflow.

Sma1lboy/rove

Best practices for Remotion - Video creation in React

相关技能