Communitygithub.com

Malik-rgb43/编辑-动态图形

使用 HyperFrames/GSAP 设计、构建并审阅一段动态图形作品:产品/应用发布、功能公告、动感排版、Logo 展示、UI 演示、动画截图。

编辑-动态图形 是什么?

该技能旨在交付一个完整的动态图形短片(MP4格式),作品以 HyperFrames HTML 和一个暂停的 GSAP 时间线为基础构建。其核心工作流遵循严格的“先批准后编码”原则:在自动执行时,AI 代理必须先起草一份帧级别的 `PROMPT.md` 文件,待人工批准(决策默认 Q6)后才能进入编码阶段。整个过程由一系列自动化门控(Gates)驱动,涵盖从规格检查(G1)、平滑度验证(G2)、密度评估(G3)、3D 资产决策(G4)、调色板锁定(G5)、UI 源追踪(G6)、无状态安全扫描(G7)到最终的音频混音(G8)与渲染质量保证(G10)。该技能支持多种“风格模式”(注册表),如 `launch`(发布)、`kinetic`(动感排版)和 `explainer`(解释说明),并为每种模式定义了特定的画面更替节奏、镜头运动和声音设计规范。该技能适用于 HyperFrames 平台,并整合了 Blender、Three.js 及 2.5D 深度处理等外部工具,但明确禁止在此技能内进行任何 AI 生成或付费 3D 调用,这些操作必须通过专门的 `paid-generation-gate` 进行。严格的资源管理是其核心:文件路径、字体和色彩方案都必须严格遵守本地化约定(如希伯来语处理),且渲染队列通过 `render_lock` 进行序列化,一次只执行一个较大的任务。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Malik-rgb43/editing-workflow/tree/HEAD/.agents/skills/edit-motion-graphics

在你喜欢的 AI 中提问

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

文档

编辑-动态图形 是做什么的?

成品动态短片(MP4)的所有者,作品构建为 HyperFrames HTML 加一个暂停的 GSAP 时间线。帧级别的 PROMPT.md 是产品本身;代码仅用于渲染它。

不可协商的规则(优先级最高)

  1. 未经批准的帧级别 PROMPT.md 不得编码 – 自动运行时也是如此:代理起草,人工批准(决策默认 Q6)。批准需在文件中记录一行 APPROVAL: <谁> <日期>。变更顺序始终是:台账 -> PROMPT.md -> 代码。
  2. 此处无支出。 AI-3D、AI 静态图像或任何付费生成都需通过 paid-generation-gate;此技能不进行任何付费调用。目录清单不等于账户访问权限。
  3. 审阅顺序: Studio 预览 -> hf_segment 范围区 -> 每轮意见仅生成一个完整渲染 -> 最终渲染的逐帧质量检查。一次只处理一个繁重任务(render_lock)。收集意见;在用户仍在书写时进行诊断,但不得开始渲染。
  4. 硬性陷阱: HyperFrames 根节点上不允许 dir="rtl"(RTL 仅用于文本元素,<html> 上使用 lang="he");字体来自文件(hf/fonts/ 中的 @font-face);hyperframes snapshot --describe false,每次调用不超过 5 个时间戳;ASCII 工作根目录(new_project)。
  5. 故障闭合: 无法运行的关卡标记为 blocked(not_run),绝不能标记为 pass。超时、空白样本或缺少渲染的情况绝不通过。成功的工具调用是执行证据;已查看的渲染是呈现证据;静态图像不能证明动态。
  6. 规则 vs 品味: 规则 1-5 是法则。下方标记为 studio style 的项目(默认无字幕、禁用列表、“不要粉色”、Higgsfield 语法、21st-first)是拥有者的品味,需附带其理由进行教授;反之,一份明确说明不同的简报在品味上优先,但绝不能凌驾于关卡之上。
  7. 数字携带其帧率(除非简报另有说明,否则为 30)且测量的时间需要注明机器(拥有者的 Windows 11 / Ryzen 7 7435HS / RX 7600S / 32 GB)。NVIDIA/Apple 的时间为未测量值。限制预算、安装或发布的项目将覆盖此技能。

输入 -> 输出

输入:简报/台账(来自 video-intake)、品牌工具包、UI 截图或组件、音乐/旁白。输出:hf/PROMPT.md(帧级别)、hf/DESIGN.md(一个锁定的调色板 + 字体 + 动态令牌)、hf/cues.js(画面和声音的单一时间源)、hf/SOURCES.md、合成文件、mix.wav、最终 MP4、质量检查报告。交接:意见 -> revision-round;其他比例 -> multi-video-variants(完全重新布局,绝不清除);交付关卡 -> render-qa-deliver;如果给定了参考 -> 首先执行 reference-style-transfer(无参考 -> 询问哪个时间范围是“风格”)。

流程

  1. 注册 + 接收。 选择一个注册表(launch | kinetic | logo | explainer | calm)并锁定长度、宽高比、旁白、音乐、交付物名称(references/launch-register-and-pace.md)。一个密集的 30 秒发布感觉快了 1.7 倍;批准的长度是 45 秒:首先决定长度。
  2. 起草 PROMPT.md + DESIGN.md(6 个块;摄像机、过渡和事件表;任何 3D 的节拍卡)。运行 python scripts/motion_spec_check.py hf/PROMPT.md --register <r>;修复;请求批准。
  3. 源素材节拍(references/ui-sources-and-port.md):目录 -> hf-blocks -> shadcn 注册表(默认)-> 仅在有账户时使用 21st.dev -> 手工构建;决定每个节拍的 3D 方案(references/three-d-decision.md)。
  4. 构建一个 index.html + cues.js;移植的组件需重新编写以保证寻帧安全。然后运行 hf_preflight --strict,python scripts/seek_safe_scan.py hf/,python scripts/palette_audit.py hf/DESIGN.md hf/ [--png <3D 渲染>]。
  5. 视觉批准: 四张静态图 + 每个过渡的截图 + sheet 联系表;Studio 预览;意见批量处理。
  6. 音频(references/sound-and-captions.md):hf_mix --report;每个品牌事件上的品牌音效;混合并测量最终文件。
  7. 一次完整渲染在锁定下,先给出预计完成时间;frame_qa、motion_qa、hf_deliver;使用一个独立的评论者按照 agent-content/benchmarks/motion-graphics.rubric.md 评分;呈现文件、编号的更改、核对过的台账以及诚实记录的差距。

注册表一览(详情见 references/launch-register-and-pace.md)

注册表新画面事件节奏镜头声音
launch每 2-6 秒,>= 2 个深度层<= 0.5-1 秒;手动计数 45-110 次/分钟永不停歇(漂移 2-4 %/s,推入 8-15 %)音乐即是音效;每个品牌事件加品牌音效;渐出
kinetic每 1-3 秒高达约 200 次/分钟(单词对换也算)字体即是镜头关键词在说出后 0 到 +7 帧处落地
logo一个想法,3-8 秒结果在 0.4-0.75 秒内可见一次移动 + 稳定揭示时的品牌音效;3 步结束
explainer一个想法,3-6 秒30-110 次/分钟有目的性,指向所解释的对象旁白主导;仅在可见变化时有音效
calm允许停顿稀疏亦可缓慢或锁定一个统一的背景音 + 细微的环境音效;无上扬/下抑效果

每个节拍的 3D 方案(五行概述)

每个节拍分别决定,在 PROMPT.md 中写明理由:Blender 用于真实几何 / 屏幕上显示超过 2 秒的英雄材质(优先 EEVEE;在 384-640 像素下测量每帧 1.2-2.25 秒,每个发布增加 1-1.5 分钟);Three.js 用于数据驱动、实例化、带有实时文本的 3D-UI、可迭代编辑或精确十六进制颜色的节拍,需在 1 秒 hf_segment AMD 关卡之后;AI-3D 只能通过 paid-generation-gate 并在许可检查后进行;2.5D(depth_25d,Depth Anything V2 Small,每 2 秒片段耗时 8.1-9.9 秒)用于需要小幅移动的静态图片;无用于 UI/消息节拍。3D 物体绝不能遮挡信息,且需对文字做出反应。

“枯燥 / 看起来像 AI 做的 / 静态” 在某个时间戳

替换节拍概念,而非修饰它。从菜单中选择:由真实语音频谱驱动的语音球;数据驱动的构建(条形图、计数器、路线地球仪);在代码中重建 UI 并作为物体拍摄(透视、景深、150-300% 放大);承载内容的共享元素变形;原地进行数字或文字的切换;在关键词上落地的 3D 英雄元素。永远不要使用小的角落“功能胶囊”、带有小幅推近的平面截图或黑色背景上的点。将注释添加到禁用列表行,并在每次出现时修复它(重复时作为全局规则)。

时间预算(在拥有者的机器上建模或测量;非学生测量值)

目标:一个 30-45 秒发布的首个可演示草稿大约需要 3-4 小时,包含 1-2 轮修改(第一个真实发布耗时 10 个草稿、7 轮评论者评审、4 轮拥有者意见);每轮恰好一次完整渲染。渲染参考(HyperFrames 0.8.98,E11,繁重 40 秒 / 1200 帧):1 个 worker 132.6 秒,4 个 worker 92.8 秒,8 个 worker 88.1 秒;浏览器 GPU 减少 12%;捕获是瓶颈(CPU 仅使用 16 个逻辑核心中的 2-3 个)。早期高级渲染:典型 8-14 分钟,观察范围 4-21 分钟(0.8.79-0.8.93)。始终对一个单元进行基准测试,并在超过 3 分钟的任务前发布预计完成时间行。

关卡

状态:pass | fail | blocked | n/a,始终附带理由。

关卡前提条件证据若为假负责人需重新检查
G0 接收注册表、长度、宽高比、交付物名称、旁白/音乐来源、参考回答已记录hf/BRIEF.md提问(每轮 3-4 个问题);blockedvideo-intake简报变化
G1 帧级别规格6 个块;每个节拍都有帧数、像素、缓动、声音、过渡;禁用列表行;十六进制调色板;APPROVAL: 行motion_spec_check.py 退出码 0(2 = 缺少批准 = blocked)修复规格;在代码之前停止此技能 + 人工审批者任何重定时或新节拍
G2 干净流畅每个场景一条样条线,每次移动 >= 1.2 秒,反向移动 >= 1 秒且 <= 1.3 倍,文本在每一关键帧内位于画面中;过渡出口 = 入口,英雄元素持续存在,无重复技巧,无淡入淡出PROMPT 中的表格 + 检查器;motion_qa 在渲染上报告 0 个卡顿范围重新定时 / 重新路径;替换节拍概念而非修饰此技能任何镜头或过渡变化
G3 密度按注册表:launch = 每 2-6 秒新画面,事件间隔 <= 0.7 秒(声明的呼吸除外),45-110 次事件/分钟(手动计数)事件表 + 每个场景 3 帧样本添加或替换节拍;将长移动拉伸至 1.6 倍而非硬塞此技能任何重定时之后
G4 每个节拍的 3D每个 3D 节拍都有一张卡片:路线(Blender / Three.js / AI-3D / 2.5D / none)、一句理由、预计完成时间、关卡证据、许可节拍卡表格;Three.js 行:一个非空白的 1 秒 hf_segment 帧重新决定;AI-3D 行需要 paid-generation-gate此技能新节拍或资产
G5 调色板锁定一个调色板表格;源文件中的每个十六进制颜色和每个 3D 渲染都在其内palette_audit.py 退出码 0(+ --png)重新着色 / 重新渲染;若无表格则为 blocked此技能新资产、新渲染、色彩注释
G6 UI 源每个 UI/效果节拍在 SOURCES.md 中有一行(来源、许可、版本、日期)和一个寻帧安全的移植;项目中无 npx shadcn add;无复制 21st 预览/媒体内容SOURCES.md + 扫描替换来源或手工构建并写明理由此技能新组件
G7 寻帧安全hf_preflight --strict 0 错误;seek_safe_scan.py 0 错误;非连续时间的快照一致报告 + 快照对修复;绝不要无故“修复”为抑制此技能每次代码修改后
G8 音频每个品牌事件有品牌音效;旁白下的音效在 -18 至 -26 dB 之间且在画面之前 1-3 帧;音乐渐出;最终文件 -14 LUFS +-0.5,TP <= -1(内部预设 v1,Q5)hf_mix --report,hf_deliver 在 FINAL 文件上验证重新混音并重新封装(无需重新渲染)render-qa-deliver 进行测量任何音频或画面重定时
G9 字幕除非简报要求,否则无字幕元素grep id/class + <direction> 行删除 / 一行内提问此技能简报变化
G10 渲染 + QA本轮一次完整渲染;frame_qa 0 个标记;评分标准平均分 >= 4.0,无维度 < 3,M1/M3/M7 >= 3;台账每一行已核对QA 报告 + 评论者输出返回至失败的关卡;升级前最多一轮修改render-qa-deliver每次完整渲染

记录关卡结果(hf/QA.md,每个关卡一行)

G1 pass   motion_spec_check exit 0, 24 beats, approval "<who> 2026-10-02"  (r2 retime 后重新运行: pass)
G5 blocked  3D render coin_r2.png not readable by palette_audit (not_run) - install Pillow or downscale
G7 fail   seek_safe_scan SS02 index.html:211 Math.random -> seeded hash; rescan pending

没有行的关卡视为 not_run。切勿根据之前轮次的记忆写下 pass:重定时、新资产或补丁会使其无效(请参阅“需重新检查”列)。

呈现草稿(render-qa-deliver 拥有交付关卡)

消息 = 立即提供文件 + 编号的更改(按用户自己的意见编号)+ 每行都已核对的台账 + 来自独立评论者的评分标准得分 + 差距(未验证的内容:希伯来语校对、设备叠加、手机上的响度)+ Studio 链接。绝不要呈现带有标记帧、失败关卡或未核对台账行的内容。

参考文献(加载时机)

  • references/seam-camera-event-tables.md - 总是在编写或审阅 PROMPT.md 时;也参考 agent-content/techniques/frame-spec-prompt.md 和 clean-smooth-motion.md。
  • references/launch-register-and-pace.md - 选择注册表、节奏反馈、禁用列表、缓动数字。
  • references/three-d-decision.md - 任何涉及深度或 3D 的节拍;2.5D 参考 agent-content/techniques/2-5d.md。
  • references/ui-sources-and-port.md - UI 卡片、效果、截图动画;agent-content/techniques/screenshot-rebuild.md。
  • references/seek-safe-and-render-traps.md - 编写代码、补丁、渲染差异。
  • references/palette-lock.md、references/typography-hebrew-kinetic.md、references/sound-and-captions.md - DESIGN.md、希伯来语字体、声音方案。
  • references/dated-versions.md - 固定版本和许可(带日期;过期 = 未知)。
  • 脚本(python <script> --self-check 首先运行):motion_spec_check.py、palette_audit.py、seek_safe_scan.py。它们检查文本和模式,而非外观。

停止并升级

标记为 blocked,而非猜测:缺少批准行;无法进行渲染;缺少关卡输入;价格或许可未知;Three.js 节拍在 AMD 上的 1 秒片段为空白(回退到 Blender 精灵)。在任何支出、安装、发布或向第三方发送消息前询问。绝不要向其他代理会话发送消息。用户关于时间戳“枯燥 / 看起来像 AI 做的 / 静态”的注释意味着从注册表的菜单中替换该节拍概念,并用一行解释。

维护

易变的事实仅存在于 references/dated-versions.md 和全局的带日期模块中(hyperframes-traps.md、three-d-routes.md、audio-mix.md)。将每条新的所有者注释添加到禁用列表行,而非此文件。仅限指定的、确定性的检查;不运行模型评估(决策默认 Q4)。

Individual skills in this repo

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

Malik-rgb43/editing-workflow

>- Script, edit or review a paid-social ad, sponsored post or brand promo for a business, product, app or store (Meta, Instagram, TikTok, 15-60 s): exact offer and CTA, ranked hooks, hook variants, end card, blocking compliance table, licence checks. Triggers: ad, promo, sponsored, campaign; מודעה, פרסומת, קמפיין, ממומן, פרומו, מבצע, הנחה, הוק. NOT for testimonials (edit-testimonial), organic expert reels (edit-talking-head), AI-only films (edit-ai-generated), ratio exports (multi-video-variants).

Malik-rgb43/editing-workflow

>- Transcribe Hebrew speech and build burned-in Hebrew captions: ASR route per hardware, word timestamps, proofreading, RTL and mixed English/number lines, caption font, entrance and exit animation, safe zone, caption QA. Triggers: תמלול, תמלל, כתוביות, כתוביות בעברית, מילים בולטות, קריוקי, המילה יצאה לא נכון, Hebrew captions, transcribe Hebrew, word timestamps, ו/ז look-alike. NOT for translation-only, non-Hebrew ASR, analysis reports (video-analysis), or caption-free motion launches.

Malik-rgb43/editing-workflow

>- Deliver one approved video as several outputs (other aspect ratios, hook variants, platform versions, no-music/no-captions versions) or run several videos in parallel, with one shared mix, strict naming and a manifest that blocks stale derivatives. Triggers: export as 9:16 and 1:1, hook variants, variants batch; גרסאות, וריאציות הוק, כמה סרטונים יחד, 9:16 ו-16:9. NOT for a single deliverable (render-qa-deliver) or designing the master (the type skill).

Malik-rgb43/editing-workflow

>- Turn a video the user sends or links (file, or YouTube/TikTok/Instagram URL) or a folder of clips into measurements (cuts, pacing, per-frame data), keyframe sheets, a Hebrew transcript and sound analysis (SFX, BPM, key, beats, song ID). Triggers: watch, analyse, break down, transcribe this video/reel/ad; תנתח, תעבור על, תמלל, מה קורה בסרטון, קאטים, BPM. NOT for cutting or rendering (type skills), applying a style (reference-style-transfer), or captions for a final render (hebrew-captions-asr).

Malik-rgb43/editing-workflow

Turn a new video idea, brief or list of specifics into a checkable Concept Ledger and ask questions until every parameter is precise, before any concept, prompt or build. Use at the start of any new video, with or without footage, or when the user pastes a concept with specifics. Hebrew - סרטון חדש, בריף, יש לי רעיון, קונספט, תכין לי סרטון, בוא נתחיל פרויקט. NOT for notes on an existing draft (revision-round), analysing a reference (video-analysis) or paid generation (paid-generation-gate).

相关技能