1实现原理 · 为什么它能做到
定位是「审片编辑」而非「生成器」：把口播视频 + 转录变成有节奏的动效节拍组，原则是不遮挡说话人、不为填空而加图。
.claude/skills/hyperframes-video-beats/SKILL.md
Use this skill to turn a talking-head video plus transcript into a paced set of motion graphics that support the narration without covering the speaker unnecessarily.
注：判据被写成四个问题（该记住什么/哪个概念需要结构/哪个数据值得强调/哪里节奏变慢会掉观众），而不是时间戳驱动。
第一步是读工程现状：AGENTS.md、根 composition、现有节拍表、共享 CSS、转录，然后从 data-start/data-duration 或 master SHOW 数组建覆盖图。
.claude/skills/hyperframes-video-beats/SKILL.md
3. Build a coverage map from the root `data-start` / `data-duration` entries or the master `SHOW` array. … 5. Identify topic spans by narration, not by arbitrary timestamps.
注：工具选择偏本地快速命令：Prefer `rg`, `Select-String`, and small Node/PowerShell transcript scripts.（不做网络检索）
两类节拍有明确分工：整屏皱纸（paper takeover）用于论点/清单/章节/引言/数据，玻璃下三分（glass lower-third）用于解释型、话题标签、公式式心智模型，且必须不遮脸。
.claude/skills/hyperframes-video-beats/SKILL.md
Use a paper takeover when the narration reaches a major thesis, list, section marker, quote, or stat that should briefly become the whole frame. … Use a glass lower-third when the speaker should remain visible and the graphic should support the current idea.
注：整屏规则：通常 4-12 秒、黑字为主、只有真正的统计数字或一个关键词用强调色；下三分规则：留在下三分/下半屏、一条标题 + 可选短副标或 2-4 条列表。
节奏用可量化的覆盖阈值兜底：开头不超过 20-30 秒无节拍，正文不超过 30-45 秒，并把 30s 设为严格扫描阈值、45s 设为正文上限。
.claude/skills/hyperframes-video-beats/SKILL.md
- Early video: avoid more than 20-30 seconds without a visual beat. … - Main body: avoid more than 30-45 seconds without a beat.
注：扫描时要求按真实可见区间报缺口：report true gaps from the visibility schedule, not just the DOM order.（有 SHOW 数组时以它为准）
对时方法锚在词上：找到话题起始词、提前 0.2-0.6 秒进场、话题结束或自然交棒才收起，下一拍紧接时提前 0.1-0.5 秒清场。
.claude/skills/hyperframes-video-beats/SKILL.md
2. Start the beat 0.2-0.6 seconds before that anchor when possible. … 4. If the next beat begins immediately, clear 0.1-0.5 seconds before it unless the handoff is intentional.
注：点名了一个反复出现的失败模式：卡片对了话题但只活 5-8 秒，而说话人还讲了 20-40 秒 —— 正确做法是一张卡活过整个话题、中途用副标或列表递进。
把 HyperFrames 的硬约束写成实现清单：每个挂载的定时元素要有 data-start/data-duration/data-track-index，子组合要注册暂停的 GSAP 时间线到 window.__timelines，并用 tl.set({}, {}, SLOT); 钉住槽位，不许出现非确定性逻辑。
.claude/skills/hyperframes-video-beats/SKILL.md
- Every mounted timed element needs `data-start`, `data-duration`, and `data-track-index`. … - Sub-compositions should register a paused GSAP timeline on `window.__timelines`. … - Pin each sub-composition timeline with `tl.set({}, {}, SLOT);`.
注：改完节拍的五步流程（建文件 → 根部挂载 → 更新可见表 → SLOT 对齐时长 → 查同轨重叠）与收尾 `npx hyperframes lint` 都写在 SKILL.md 里。
收尾是自检 + 汇报：跑 lint、清零错误、单列已知非阻断告警；若用户要可渲染产物就渲染或冒烟渲染，并给出精确的文件路径与时间戳。
.claude/skills/hyperframes-video-beats/SKILL.md
1. Run the HyperFrames linter. 2. Fix all errors. 3. Mention warnings separately if they are known and non-blocking. … 5. Give the user exact file paths and timestamps changed.
注：还有一组实用默认值（整屏概览 8-10s、整屏数据 5-8s、玻璃解释 12-30s、长话题玻璃卡 25-45s、下三分宽 68-72vw / 上限 1240-1280px）供无上下文时兜底。
2核心能力
01先建覆盖图再动手，且明确「不为填空而加图」
02节拍类型决策树：整屏皱纸 vs 玻璃下三分 vs 不加，各带用途清单
03时长纪律：整屏 4-12 秒且克制，下三分一条标题 + 可选短副标或 2-4 条列表
04按叙事话题对时（转录锚点 ±0.2-0.6 秒进场、0.1-0.5 秒清场），并点名「对了话题但活太短」的失败模式
05缺口扫描阈值可执行：严格 30s、正文上限 45s，并按真实可见区间（SHOW 数组）报缺口
06文案写法规范：1 秒内读懂，短名词短语/直白标签/一张卡一个心智模型，并给出正例句式
07视觉规范与样式复用：黑字为主、强调蓝只给大数字/关键词、玻璃卡沿用既有 class、下三分宽度 68-72vw
08HyperFrames 实现合规清单（data-* 属性、window.__timelines、SLOT 锚、同轨不重叠、运行 lint）
09交付前自检与汇报：跑 lint、清零错误、单列非阻断告警，并给出改动文件与时间戳
10把用户口味当约束：被砍短的节拍不因通用覆盖规则而恢复，已批准的样式继续复用
3外部依赖
| 类型 | 依赖 |
|---|---|
| cli | HyperFrames CLI（对编辑后的 HTML 跑 lint；用户要 render-ready 时渲染或冒烟渲染，用法由 ../hyperframes-cli 提供） |
| cli | 本地搜索/脚本工具（rg、Select-String、小型 Node/PowerShell 转录脚本） |
| package | Node.js（跑 lint/转录小脚本的环境前提） |
4风险提醒 风险提醒：蓝色 · 知晓即可
风险提醒：蓝色 · 知晓即可
- 依赖具体工程形态（SHOW 数组 / data-start 可见表） — 覆盖扫描与对时都假定项目有可解析的可见性表或 master SHOW 数组；换到结构不同的 HyperFrames 工程时需要先做适配，否则缺口报告会失真。
- 阈值只是经验值，硬套会出问题 — 20-30s / 30-45s 是为长视频留存调的；短片、教程型内容或已经过用户删减的节拍表，照搬阈值反而会加出多余图形——文档自己也提醒以用户口味优先。
- 改写用户工程文件，回滚需靠版本管理 — 流程会新增 composition 文件并修改 index.html 与可见性表；skill 无备份机制，建议在 git 工作区里操作。
- 内容层注入的相邻面 — 转录与项目内既有文案都会被当作事实来源读入上下文；不受信任的转录内容可能影响节拍与文案撰写，尽管不会带来代码执行。
风险提醒：蓝色，知晓即可。判级对象＝本 skill 自身目录（仅 2 个文件：SKILL.md + agents/openai.yaml）。它是纯指令型工作流：读项目文件与转录、给节拍设计与对时规则、指示 agent 写 HTML 并跑外部 lint；自身 0 脚本、0 凭证读取、0 网络外发、0 破坏性操作。之所以不落绿档，是因为流程会实际改写项目内的 composition/index.html 与可见性表（本地写盘），且依赖官方 hyperframes CLI 与本地搜索/脚本工具完成验证——属『仅本地工具/CLI 与本地读写』的蓝色特征。无红档特征（无沙箱关闭、无 TLS 降级、无反自动化绕过、无任意代码执行面）。
5第二遍独立确认
- [ok] 目录文件清单 — find 返回 SKILL.md（8.4KB）与 agents/openai.yaml（250B）；无 scripts/、无 references/、无二进制资产。
- [ok] 网络/凭证面反例搜索 — 全目录 0 处 http(s) URL、0 处 fetch、0 处 env/API_KEY/TOKEN/SECRET；唯一外部命令是 `npx hyperframes lint` 与本地 rg/Select-String。
- [ok] 数字口径跨章节一致性 — Pacing Heuristics 的 20-30s / 30-45s 与 Coverage Scan 的『30s 严格、45s 上限』自洽；Timing Method 的 0.2-0.6s 进场与 Practical Defaults 的『Beat start lead-in: 0.2-0.6 seconds』一致；整屏 4-12s 上限与 Practical Defaults 的 5-8s/8-10s 分档相容。
- [ok] 实现规则是否可被 lint 校验 — 时序元素属性（data-start/data-duration/data-track-index）、子组合时间线注册（window.__timelines）、SLOT 锚（tl.set({}, {}, SLOT);）、同轨不重叠 —— 均为同仓 HyperFrames 系列 skill 反复出现的 lint 口径，文档并明确 Run `npx hyperframes lint`。
- [ok] 是否夸大了自动化 — 文档要求人工/agent 判断（不为填空加图、按话题而非时间戳定位、保留用户口味），并给定扫描阈值与人工复核点，无『全自动生成』表述。
- [ok] 宿主元数据内容 — agents/openai.yaml 仅含 interface.display_name / short_description / default_prompt 三项展示字段，无权限、无命令、无环境变量。
6结论
适合：适合：已有 HyperFrames 工程的长视频/播客口播（YouTube 留存向）需要系统补齐动效节拍；也适合作为审稿清单，检查现有节拍表的覆盖缺口与时长失衡。
不适合：不适合：从零建工程（那是 make-a-video / hyperframes）、短视频 9:16 快剪（有 short-form 系列）、以及期望自动生成全部图形的场景——它产的是设计决策与合规实现规则，不是素材生成器。
安装 agent 直装可复制
① 本站镜像 更新 2026-09-28
方式 A · 人下载镜像包下载 hyperframes-video-beats.tar.gz
sha256:
方式 B · JSON 格式安装指南，复制给 agentf17e6d21395b29b4…agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
② 上游 GitHub · 原始来源
来源信息 GitHub 原始
作者 / 仓库nateherkai / nateherkai/hyperframes-student-kit
原始 GitHubnateherkai/hyperframes-student-kit ↗
Stars1070
最近推送2026-09-28
本 skill commit
0d30152a82许可NOASSERTION（仓库根 LICENSE，实为 MIT 文本）
本站信息
收录日期2026-09-06
分类内容创作
侦查报告AI 侦查 · 2 遍 · 2026-09-06
本站镜像与 GitHub 原始是不同来源：本站锁定 commit 快照经 /r2 分发；GitHub 为实时上游，内容可能已更新。