Communitygithub.com

oyi77/1ai-skills

将每周的更新日志 .md 文件转换为品牌化的发布日志视频,基于 HyperFrames 实现。在用户提供更新日志/摘要 markdown 并希望生成每周视频,或直接说“发布日志视频”时使用。技能自带字体、背景、词汇表和脚本,生成 1080×1080 方形、45-60 秒的动画品牌模拟 UI 视频。

1ai-skills 是什么?

该 AI 技能旨在将产品更新日志(changelog)自动转化为品牌化、带有动画效果的发布日志视频,主要面向需要视觉化传达产品更新的开发团队或产品经理。它支持 HyperFrames 平台,用户只需提供 markdown 格式的更新日志,技能即可根据内容生成带有动画模拟 UI、背景图案和语音旁白的 MP4 视频。技能内部包含了完整的字体、背景素材、词汇表和脚本模板,无需额外资源,最终输出为 1080×1080 方形、时长 45-60 秒的视频。工作流程包括从技能资产引导、解析日志内容、可视化路由(将每项更新映射到对应的 UI 动画)、双层脚本生成(旁白与显示文本分离)、语音合成与字幕对齐,以及通过多个检查门(hyperframes check、seam-gate.mjs verify、字幕可见性验证)确保质量。技能严格避免纯文本列表,强调每项功能更新都必须通过真实 UI 动画来展示,并附有反合理化表以防范常见的降低质量的倾向。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/oyi77/1ai-skills/tree/HEAD/content/hyperframes-changelog-video

在你喜欢的 AI 中提问

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

文档

概述

此技能使用 HyperFrames 基于 HTML 的渲染,将发布日志转化为精心制作的视频合成。当产品更新值得一个视觉化公告——包括主角帧、关键要点标注和背景图案——时使用。它会根据您输入的日志条目生成 MP4 视频。

HyperFrames — 发布日志视频

输入:一个发布日志 .md(主题 + 条目)。输出:一个代码整洁、通过 seam-gate-green 检查的 HyperFrames 项目。仅在用户要求时进行渲染。

使用时机

  • 用户提供了 更新日志/摘要 markdown 并希望生成每周视频
  • 用户说 “发布日志视频” 或 “每周摘要视频”
  • 用户想要一个带有动画模拟 UI 和语音旁白的 品牌化视频

禁止使用时机

  • 用户想要产品发布视频(请使用 hyperframes-product-launch-video)
  • 用户想要动态图形(请使用 hyperframes-motion-graphics)
  • 用户想要主播出镜视频(请使用 hyperframes-embedded-captions)

核心原则:可视化,而非罗列

每个主题都通过一个 实际 UI 的动画模拟或其忠实模拟 来展示体验变化,而不是用文字要点。在编写脚本之前,务必将每个主题/条目先通过可视化注册表处理。

工作流程

0 · 从技能资产引导(不可协商)

mkdir -p project/assets/fonts
cp <SKILL_DIR>/assets/fonts/*.woff2 project/assets/fonts/
cp <SKILL_DIR>/assets/bgm.mp3 project/bgm.mp3
ffmpeg -y -stream_loop 15 -i <SKILL_DIR>/assets/bg-pattern.mp4 -t <TOTAL> \
  -vf "scale=1080:1080,fps=30,eq=saturation=0.72,[email protected]:t=fill" \
  -an -c:v libx264 -crf 20 -pix_fmt yuv420p project/assets/bg-pattern-<TOTAL>s.mp4
cp <SKILL_DIR>/examples/master-skeleton.html project/index.html

然后完整阅读 references/build-spec.md —— 它定义了品牌令牌。

1 · 解析 + 编辑裁切

  • 提取:周范围、标题统计、主题、条目
  • 时间预算:总共 45-60 秒。 标题 ≤2 秒,片尾 ≤3.5 秒,4 个主题各约 9-12 秒
  • 每个主题保留一个核心可视化 + 最多 3 个口述条目
  • 按故事顺序排列主题:旗舰功能 → 产品界面 → 性能 → 可靠性

2 · 可视化路由

对于每个主题,从可视化注册表中选择界面并写一行:主题 → 界面 → 模拟执行的 2-4 个有序动作,每个动作对应一个脚本短语。

3 · 双层脚本(口述 vs 显示)

将脚本写成令牌行:使用对话式语域,每个技术术语在 spoken 中携带音标形式,而 display 保持标准拼写。字幕显示 display;旁白朗读 spoken。

4 · 旁白 + 单词时间戳

node scripts/heygen-tts.mjs ./vo-spoken.txt -o voiceover.mp3 --words vo-words.json --voice <voice_id>
node scripts/align-captions.mjs --tokens script-tokens.json --words vo-words.json --out captions.json

单词时间戳是硬性门控。 在继续之前,请确认 vo-words.json 非空且包含一个带有每个单词 start/end 的 words: [...] 数组。

5 · 构建

严格遵循 references/build-spec.md:品牌令牌 + 字体 + 动画背景编码 + 场景骨架 + chrome 效果 + 字幕轨道。然后按照原则顺序:向量账本 → seam 印章 → 基于旁白单词的内部节拍 → seam 门控验证。

字幕不可省略。 在继续之前,从 captions.json 填充 LINES 数组。

6 · 门控(全部通过后方可呈现)

  1. hyperframes check — 0 个错误
  2. seam-gate.mjs verify — 0 个失败
  3. 重启预览服务器,抽查 3-4 个节拍
  4. 除非用户要求,否则不要渲染
  5. 字幕存在性门控 — 抽样 3-4 帧,确认字幕轨道可见

反合理化表

合理化现实
“使用要点列表幻灯片展示 UI 变更”通过模拟界面来展示变更过程
“无法展示的条目用假 UI 代替”使用诚实的清单场景
“TTS 文本中直接写‘JSON’”词汇表中为口语形式;显示保持标准
“猜测发音”询问,然后扩充词汇表
“朗读每一条日志”每个主题 ≤3 条;摘要链接承载其余内容
“到处都是绿色强调”每个场景只出现一次绿色时刻
“从以前视频的 index.html 开始”始终复制 master-skeleton.html
“空的 LINES 数组没问题”空的 LINES = 不带字幕的出品 = 重新运行

验证清单

  • hyperframes check 通过,0 个错误
  • seam-gate.mjs verify 通过,0 个失败
  • 在 3 个以上抽样帧中字幕轨道可见
  • 单词时间戳与音频对齐
  • 品牌令牌与 build-spec.md 一致
  • 仅在用户明确要求时才渲染

Individual skills in this repo

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

oyi77/1ai-skills

The transition technique catalog for HyperFrames videos — five velocity-matched SEAMS (zoom-through, inverse zoom-through, cut-the-curve, waterfall cut, rack-focus blur-cut) plus in-scene techniques (waterfall entry, nudge curve). Covers partial-travel velocity matching, Z scale-sign rule, size-scaled blur, the 10/65/25 slide ratio, and the 2-3 transition budget. Read before authoring any transition, text-beat handoff, or kinetic text entry.

oyi77/1ai-skills

Add captions/subtitles to talking-head or launch videos using HyperFrames. Use when the user wants embedded captions, verbatim caption rails, or cinematic text behind the subject. Covers the drop/rail/embed caption model, the overlay law (captions are NOT a reserved band), matte occlusion for embedded climaxes, and word-timestamp alignment from TTS output.

oyi77/1ai-skills

Turn arbitrary text — an article, notes, a topic, a brief — into a faceless explainer video using HyperFrames. Use when the user wants a topic explainer, concept breakdown, how-to, or listicle with no product/website to capture. Every visual is invented per scene (typography, abstract graphics, diagrams, data-viz). Not a video built from a website (use hyperframes-product-launch-video).

oyi77/1ai-skills

The fallback HyperFrames workflow for anything that doesn't fit other skills — longer multi-scene pieces, brand/sizzle reels, title cards, static loops, freeform compositions. Input- and length-agnostic. Also the home of companion mode (co-create with the full toolbox). Use when no other HyperFrames skill matches, or when the user wants a freeform video.

oyi77/1ai-skills

Create short, unnarrated, design-led motion graphics (~under 10s) using HyperFrames. Use when the user wants kinetic type, stat/chart hits, logo stings, lower-thirds, animated tweets/headlines, or transparent overlay motion graphics. MP4 or transparent overlay output. Teaches seek-safe keyframe authoring and the 2-3 transition budget rule.

oyi77/1ai-skills

Turn a music track into a beat-synced HyperFrames video — lyric, slideshow, or kinetic promo. Use when the user provides an audio file, a video to pull audio from, or a mood brief for generated music. Music drives pacing. Teaches beat-map extraction, section-based scene planning, and audio-reactive visuals.

oyi77/1ai-skills

Create product launch videos from a URL, brief, or script using HyperFrames (HTML→MP4). Use when the user wants a product launch video, site tour, social clip featuring a product's own visuals, or marketing/promoting a product. Up to ~3 min (sweet spot 30-90s). Teaches the HyperFrames production loop: plan → write HTML → wire seekable animations → add media → lint → preview → render.

oyi77/1ai-skills

The Video Production Manager — manages ALL video production under 1ai-content. Delegates to HyperFrames, Remotion, AI video, and FFmpeg based on the task. Has memory via 1ai-hub brain, follows 1ai-rules, and reports to Content Director. Use when the user says 'make a video', 'create video', 'edit video', 'video strategy', or needs any video production work.

oyi77/1ai-skills

Agent skill at content/video/gen/SKILL.md

oyi77/1ai-skills

Use when track portfolio company KPIs, variances, returns analysis. Use when user says "monitor portfolio", "track KPIs", "portfolio returns".

oyi77/1ai-skills

Use when go-to-market planning — launch sequencing, channel strategy, audience building, PR outreach. Use when planning product launches, building launch checklists, or coordinating multi-channel campaigns.

oyi77/1ai-skills

Use when portfolio manager — capital allocation, risk management, and performance metrics tracking for trading strategies.

相关技能