Communitygithub.com

ASoudy/AGS 演示视频生成器

当用户要求从截图或场景描述创建演示视频、产品导览、功能展示、动画演示、营销视频或 GIF 时使用。通过编排 playwright、ffmpeg 和 edge-tts MCP 工具,生成精良的视频内容。

AGS 演示视频生成器 是什么?

这是一个专为 AI 代理设计的演示视频生成技能,用于将截图或场景描述自动转化为高质量产品演示视频。其核心工作流程包括三个步骤:首先使用 Playwright 对 HTML 场景进行截图,然后通过 Edge-TTS 生成语音旁白,最后利用 FFmpeg 进行视频合成和转场。视频会输出为 1920x1080 分辨率,包含完整的音轨、场景过渡和精心设计的视觉风格。该技能支持在 Cursor、Claude Code 和 Codex 等 AI 开发工具中使用,当所有 MCP 组件可用时能全自动工作,否则会生成手动可执行的构建脚本。它内置了多种叙事结构(如经典演示、问题-解决方案、15秒预告片),帮助用户从产品功能罗列转向有故事弧线的演示视频,并特别关注节奏控制、视觉层次和情感传递。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ASoudy/AGS/tree/HEAD/claude_skills_libraries/nginity-skills-library/engineering/demo-video/skills/demo-video

在你喜欢的 AI 中提问

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

文档

演示视频

你是一位视频制作人。不是幻灯片制作者。每一帧都有其任务。每一秒都要赢得下一秒。

概述

通过编排浏览器渲染、文本转语音和视频合成来创建精良的演示视频。像视频制作人一样思考——故事弧线、节奏、情感、视觉层次。将截图和场景描述转变为可分享的产品演示。

何时使用此技能

  • 用户要求创建演示视频、产品导览或功能展示
  • 用户想要动画演示、营销视频或产品预告
  • 用户希望将截图或 UI 截图转变为精良的视频或 GIF
  • 用户说“制作视频”、“创建演示”、“录制演示”、“宣传视频”

核心工作流程

1. 选择渲染模式

在开始之前,确认可用工具:

  • playwright MCP 可用吗? — 用于自动截图。备选方案:要求用户手动截取 HTML 文件的截图。
  • edge-tts 可用吗? — 用于生成旁白音频。备选方案:输出旁白文本文件,供用户自行录制或使用任何 TTS 工具。
  • ffmpeg 可用吗? — 用于合成。备选方案:输出单个场景图片 + 音频文件,并附带用户可手动运行的 ffmpeg 命令。

如果以上均不可用,则生成 HTML 场景文件 + scenes.json 清单 + 旁白脚本。用户可手动合成或使用任何视频编辑器。

模式方法何时使用
MCP 编排HTML → playwright 截图 → edge-tts 音频 → ffmpeg 合成当 playwright + edge-tts + ffmpeg MCP 全部连接时使用
手动模式编写 HTML 场景文件,提供 ffmpeg 命令供用户运行当 MCP 不可用时使用

2. 选择故事结构

经典演示 (30-60 秒): 钩子 (3 秒) -> 问题 (5 秒) -> 神奇时刻 (5 秒) -> 证明 (15 秒) -> 社交证明 (4 秒) -> 邀请 (4 秒)

问题-解决方案 (20-40 秒): 之前 (6 秒) -> 之后 (6 秒) -> 如何做 (10 秒) -> 行动号召 (4 秒)

15 秒预告片: 钩子 (2 秒) -> 演示 (8 秒) -> 标志 (3 秒) -> 口号 (2 秒)

3. 设计场景

如果未提供截图:

  • 对于 CLI/终端工具:生成具有终端风格深色背景、等宽字体和动画打字效果的 HTML 场景
  • 对于概念性演示:使用文字密集的场景,搭配特定的色彩语言和排版系统
  • 仅在产品是视觉性的且描述不足时,向用户索要截图

每个场景只能有一个主要焦点:

  • 标题场景:产品名称
  • 问题场景:痛点(红色,混乱)
  • 解决方案场景:结果(绿色,宽敞)
  • 功能场景:突出显示的截图区域
  • 结尾场景:URL / 行动号召按钮

4. 撰写旁白

  • 每个场景一个观点。如果你需要用到“并且”,说明你需要两个场景。
  • 以动词开头。“整理你的标签页”,而不是“提供标签页组织功能”。
  • 不要使用术语。“你的标签页会自动整理”,而不是“AI 驱动的标签页分类”。
  • 使用对比。“24 个标签页。一次点击。5 个分组。”

输出工件

为每个视频在 demo-output/ 目录中生成以下文件:

  1. scenes/ — 每个场景一个 HTML 文件(1920x1080 视口)
  2. narration/ — 每个场景一个 .txt 文件(用于 edge-tts 输入)
  3. scenes.json — 按照顺序列出场景及其持续时间和旁白文本的清单
  4. build.sh — 运行完整管道的 shell 脚本:
    • playwright screenshot 每个 HTML 场景 → frames/
    • edge-tts 每个旁白文件 → audio/
    • ffmpeg 带交叉淡入淡出过渡的连接 → output.mp4

如果 MCP 不可用,仍然生成项目 1-3。在 build.sh 中包含 ffmpeg 命令,供用户手动运行。

场景设计系统

请参见 references/scene-design-system.md 获取完整的设计系统:色彩语言、动画时机、排版、HTML 布局、语音选项和节奏指南。

质量检查清单

  • 视频包含音频流
  • 分辨率为 1920x1080
  • 场景之间无黑帧
  • 前 3 秒抓住注意力
  • 每个场景只有一个焦点
  • 结尾卡片包含 URL 和行动号召

反模式

反模式解决方案
幻灯片式节奏 — 每个场景持续时间相同,没有韵律变化持续时间:钩子 3 秒,证明 8 秒,行动号召 4 秒
屏幕上的文字墙将信息转移到旁白,简化视觉
泛泛的旁白 — “此功能使您能够...”使用具体的数字和具体的动词
无故事弧线 — 只列出功能使用问题 -> 解决方案 -> 证明的结构
原始截图始终添加圆角、阴影、深色背景
使用 ease 或 linear 动画使用弹簧曲线:cubic-bezier(0.16, 1, 0.3, 1)

交叉引用

  • 相关:engineering/browser-automation — 用于基于 playwright 的浏览器工作流
  • 另请参见:framecraft — 开源场景渲染管道

Individual skills in this repo

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

ASoudy/AGS

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

ASoudy/AGS

Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

ASoudy/AGS

Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

ASoudy/AGS

One sentence - what this skill does and when to invoke it

ASoudy/AGS

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

ASoudy/AGS

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

ASoudy/AGS

Pull a YouTube video transcript into a queryable markdown vault with yt-dlp subtitle discovery, VTT cleanup, metadata frontmatter, and capture-seed stubs.

ASoudy/AGS

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

ASoudy/AGS

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.

ASoudy/AGS

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

ASoudy/AGS

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

ASoudy/AGS

Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

ASoudy/AGS

Next.js App Router principles. Server Components, data fetching, routing patterns.

ASoudy/AGS

Expert integration of Supabase Auth with Next.js App Router

ASoudy/AGS

React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

ASoudy/AGS

Best practices for Remotion - Video creation in React

ASoudy/AGS

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

ASoudy/AGS

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

ASoudy/AGS

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

ASoudy/AGS

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

相关技能