Communitygithub.com

通用视频制作

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

通用视频制作 是什么?

此技能为 HyperFrames 框架下的通用视频制作提供了一个全面的、结构化的指南。它旨在处理没有专门工作流的各类作品,包括长篇幅和多场景项目。该技能详细描述了从项目初始化、素材适配、状态识别到合成执行的完整流程,并特别强调了`companion`(协作)工作流模式,在此模式下 AI 应以“导演”而非“承包商”的身份深度参与创作,提供“天花板级”的方案。技能通过强制性的知识加载清单、依赖顺序和严格的检查点(如故事板审核、最终预览和渲染批准)来确保输出质量。它支持在 Claude Code、Cursor 等 AI 编程助手中使用,通过执行 CLI 命令和读取引用文件来保证操作的规范性和可追溯性。

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

在你喜欢的 AI 中提问

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

文档

通用视频

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

npx hyperframes skills update general-video

成功的无操作表示技能已最新。如果更新失败,请报告错误,不要凭记忆继续。

1. 应用跨项目源适配器

  • 媒体: 对于任何音频、图像、图标、Logo、语音、调色、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/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 时返回此处。

对于新项目,从简报中选择一个短横线命名法的目录名称,并在编写简报前进行脚手架搭建:

npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=general-video

然后在项目根目录使用 ../hyperframes/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/references/brief-contract.md 的规范术语:

字段含义效果
flow驱动者automation:选择并执行路线。companion:在对话中共同创作。
storyboard在构建前规划、草图设计和审查yes:运行规划和草图审查(storyboard.html)。no:直接构建。
衍生的 mode检查点门控的行为方式遵循简报契约。切勿要求用户命名一个模式。

不要为这些状态发明同义词。持续的“只管构建”信号由意图层处理,并以 flow: automation、storyboard: no 的形式到达。

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

对于现有素材的硬切、修剪、拼接或重新排序,将同一视频源复制到多个剪辑元素中。在每个副本上,使用 data-media-start 加 data-duration 设置源范围,然后使用 data-start 设置创作者的放置/顺序。单独创作的音频在匹配的 <audio> 元素上遵循相同的剪辑范围和时序。/hyperframes-core 掌管此类时间编辑;仅在对内部包装器进行视觉属性动画(如缩放、推拉、摇摄、裁剪、遮罩或 clip-path)时使用 /hyperframes-keyframes。从 ../hyperframes-core/references/creator-editing-recipes.md 复制完整契约。

协作流程

当 flow: companion 时:

  • 读取 BRIEF.md,并将已接受的 ## Assets 和 ## Customizations 与项目产物进行核对。完成已接受但仍悬而未决的工作;对已完成的工作不予处理;不要将已接受的能力当作新能力再次提供。
  • 以导演而非承包商的身份介入。 选择协作模式的用户是选择了参与和质量;诚实的回应是你能够设计出的最佳版本,而不是你能够辩护的最小版本。第一个方案是天花板级别的处理:故事弧线(借用最近的类型视角——菜单 § 类型视角)、设计规范、每个场景以其名字命名的动态处理(§ 5 的方案规范)、转场、音频身份——音乐和声音标记,或有意的沉默——用户素材的放置,以及设计好的开场和结尾。用一句话说明每一层增加了什么;在提及它们时标注出昂贵的部分(渲染时间、登录、计费)。用户是在裁剪方案,而不是通过逐项批准来拼凑一个。
  • 天花板属于概念,而非工具箱。 每一层都必须服务于简报的信息——一个可以套用在任何视频上的方案只是装饰。精湛的工艺达到天花板;内容永远不会超出被要求的范围(§ 6)。
  • 在检查点之间,../hyperframes/references/capability-menu.md 有两种工作方式。作为触发列表:当用户提到某个能力的输入或构建过程达到其需求时,提供相关能力。作为每次传递的升级渠道:一个方案、草图或构建检查点可能会附带一到两个针对用户当前关注素材的定向提供(“场景 3 的统计需要计数处理”)。在提供之前先阅读;永远不要倾倒整个目录。
  • 在用户接受某个能力后,立即产出其产物,并将决策记录到匹配的 BRIEF.md 正文部分。仅当用户明确更改时,才重写 frontmatter 字段并记录已确认的偏好。
  • 保持相同的故事板、验证、最终预览和渲染批准门控。协作模式改变的是谁在掌舵,而不是质量要求什么。

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

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

条件在操作前读取
任何合成 HTML 或场景布局/hyperframes-core;使用 references/determinism-rules.md 获取其布局契约
任何非平凡的创作或视觉处理/hyperframes-creative → references/house-style.md 和 references/video-composition.md
任何动态、动画或场景转场/hyperframes-animation;遵循其路由到匹配的规则、适配器、蓝图或转场参考
storyboard: yes../hyperframes/references/storyboard-format.md 和 ../hyperframes/references/review-loop.md
任何媒体资产或操作,包括旁白、BGM、音效、字幕、调色或变换/media-use;对于框架播放和放置,还需阅读 /hyperframes-core → references/variables-and-media.md
多场景装配../hyperframes/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 扩展提示。多场景方案引用每个场景的形状:当有合适的蓝图时,使用来自 /hyperframes-animation → blueprints-index.md 的蓝图 ID;否则,引用其组成的命名规则(来自 rules-index.md)——动态名称来自这些索引,切勿发明。故事真相决定哪些场景存在;引用来修饰它们。在你计划自行构建任何命名外观之前,请先搜索实时目录:对于简报中提到的每个外观、特效、处理或转场——例如“CRT 扫描线”、“故障效果”、“胶片颗粒”、“闪光扫掠”、“五彩纸屑爆裂”——请运行 npx hyperframes catalog --query "<the look, in plain English>" --json 并在方案命名如何构建该外观之前阅读最相关的结果。搜索无需安装任何东西:无需项目、无需预先 add、无需账户。它会从任何目录对整个托管注册表(约 400 个块和组件)进行排序,因此它也适用于用户在构建过程中要求的某个外观。方案中命名的块将在阶段 3 安装;仅当搜索后没有找到合适结果时,才手工创作某个外观。多场景方案也作为调度产物记录下来:在 STORYBOARD.md 中每个场景一个 ## 帧 N 块——status: outline,声明的 src:,蓝图/规则引用,以及节拍文本——即使 storyboard: no。该块是调度单元;故事板表格只是审查界面。
  2. 根据要求审查方案。 对于 storyboard: yes,在这些块上运行共享审查循环。对于 storyboard: no,继续执行,无需方案暂停或草图表格。如果方案暂停无论如何发生了,请将子代理委派授权(步骤 4 的调度需要,例如 Codex)合并到该暂停中,而不是稍后再次停止。
  3. 解决依赖关系。 在并行工作之前安装注册表块。暂存用户资源,采用现有资源,并安装任何缺失的注册表包。对于方案引用的每个块 ID,运行 npx hyperframes add <block-id>。如果步骤 1 的搜索发现了适合尚未引用的外观的块,也请添加它们。
  4. 调度构建。 对于单场景:直接使用 /hyperframes 框架的 compose 或 build 命令。对于多场景:使用子合成模式,每个场景有一个独立的文件,并通过主合成文件进行编排。在每个场景文件中,严格遵循 /hyperframes-core 的布局契约。对于每个场景,声明 data-media-start 和 data-duration 用于源修剪,data-start 用于时序定位。使用 <hyperframes-scene> 元素进行场景级别包装。在可能的情况下并行构建场景。
  5. 验证。 运行 npx hyperframes validate。修复所有报告的问题。对于 storyboard: yes,在最终预览之前运行故事板审查。
  6. 最终预览。 提供预览。对于 flow: companion,展示并等待输入。对于 flow: automation,继续。
  7. 渲染批准。 运行 npx hyperframes render。通知用户渲染完成。

6. 遵循创作约束

  • 除非简报明确要求,否则不要添加额外的转场或特效以“填充”时间。
  • 对于 flow: automation,仅在必要时进行交互。
  • 素材放置必须可追溯到来源。使用 data-src 属性。
  • 音频放置必须与视觉元素同步。使用匹配的时间范围。
  • 除非简报指定更短的时长,否则保持合理的节奏。
  • 对于长篇幅作品(>2 分钟),使用场景结构以获得更好的可管理性。

Individual skills in this repo

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

Zuhair-01/claude-skills-and-systems

Create AI avatar videos with precise control over avatars, voices, scripts, scenes, and backgrounds using HeyGen's v2 API. Use when: (1) Choosing a specific avatar and voice for a video, (2) Writing exact scripts for an avatar to speak, (3) Building multi-scene videos with different backgrounds per scene, (4) Creating transparent WebM videos for compositing, (5) Using talking photos as video presenters, (6) Integrating HeyGen avatars with Remotion, (7) Batch video generation with exact specs, (8) Brand-consistent production videos with precise control.

Zuhair-01/claude-skills-and-systems

Generate Mandarin and multilingual narration with Volcengine Doubao Speech 2.0. Use when creating Chinese voiceovers, when the user prefers Doubao/Volcengine/火山引擎/豆包 TTS, or when narration needs character-level timestamp metadata for subtitles.

Zuhair-01/claude-skills-and-systems

Edit existing videos using AI — remix style, upscale, remove background, and add audio via fal.ai's hosted video models.

Zuhair-01/claude-skills-and-systems

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

Zuhair-01/claude-skills-and-systems

Read-only queue dashboard for workspace-aware ship. (gstack)

Zuhair-01/claude-skills-and-systems

Generate HeyGen presenter videos via the v3 Video Agent pipeline — handles Frame Check (aspect ratio correction), prompt engineering, avatar resolution, and voice selection. Required for any HeyGen video generation. Replaces deprecated endpoints with v3. Use when: (1) generating any HeyGen video (via API or otherwise), (2) sending a personalized video message (outreach, update, announcement, pitch, knowledge), (3) creating a HeyGen presenter-led explainer, tutorial, or product demo with a human face, (4) "make a video of me saying...", "send a video to my leads", "record an update for my team", "create a video pitch", "make a loom-style message", "I want to appear in this video", "generate a HeyGen video", "make a talking head video". Accepts avatar_id from heygen-avatar for identity-first HeyGen videos, or uses a stock presenter. Returns video share URL + HeyGen session URL for iteration. Chain signal: when the user wants to create/design an avatar AND make a video in the same request, run heygen-avatar f...

Zuhair-01/claude-skills-and-systems

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.

Zuhair-01/claude-skills-and-systems

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.

Zuhair-01/claude-skills-and-systems

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

相关技能