Communitygithub.com

视觉叙事

以可视化方式向人们展示复杂事物:在一张大画布上制作动态解说影片,包含镜头、场景和字幕;交互式系统或流程图;带有微动效、过渡效果和静态PDF的演示文稿;适配手机版本、帧精确的MP4导出、发布到子域名并生成二维码。

视觉叙事 是什么?

该技能专为创建视觉叙事内容而设计,能够将复杂的系统、流程或想法转换为动态解说影片、交互式地图或精致的演示文稿。它支持多种输出格式,包括帧精确的MP4视频、静态PDF、手机和平板适配版本,并允许发布到子域名和生成二维码。技能通过分批次工作流运行:首先与用户确认目标和参考模板,然后编写脚本(场景或幻灯片表格),接着制作样片并获得用户确认,再以2-3个场景/幻灯片为一组分批完成,最后进行组装。核心优势在于避免一次性完成所有内容(这样用户修改风格会导致全部重做),通过逐批展示和确认来确保方向正确。该技能在Claude Code等AI代理工具中实现,并通过一系列参考文件(如`references/motion-film.md`、`references/scheme.md`、`references/deck.md`等)来指导具体任务,从触觉规则到质量检查和发布流程均有覆盖。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/smixs/visual-story/tree/HEAD

在你喜欢的 AI 中提问

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

文档

视觉叙事 是做什么的?

将复杂事物用图像展示:场景逐一展开,画面宏大,动效用于解释而非装饰。字幕说明正在发生什么;画布则展现它。每个工作批次结束时向用户展示一帧画面并获得他们的“确认”。

你要制作什么 → 打开哪个执行手册

任务执行手册
解说影片:同一画布上的多个场景,镜头,字幕,“完整示意图”地图references/motion-film.md
流程或系统的交互式地图,可在节点间跳转references/scheme.md
带有微动效、过渡效果和PDF的演示文稿references/deck.md
没有场景或镜头的普通会议演讲使用常规幻灯片工作流;借用deck.md中的可读性规则
将影片或地图导出为MP4references/video-export.md
手机和平板版本references/responsive.md
发布、子域名、密码、二维码references/publish.md
目视检查:通过URL查看帧、缩略图联系表、检查清单references/qa.md
审美规则:色彩、字体、动效、密度references/taste.md
可供复制框架的参考作品references/examples.md

在第一行代码之前,打开taste.md、examples.md和对应的执行手册。在第一次展示之前打开qa.md。

影片还是地图?影片是一个随时间展开的故事,由演示者带领观众逐场景观看。地图是一张大图,供观众自行探索。“为网络研讨会动画化我们的流程”是影片;“一个可供查看的系统地图”是地图。如果不确定,问一个问题。

每种类型的工作顺序

  1. 用用户的语言表述目标,然后提问。 一次性提出,优先推荐选项,仅询问尚未回答的问题:选择哪个参考(“和上次一样”)、如何展示(演示者点击/自动播放/视频/PDF)、风格(产品的网站)、语言、数据(虚构或用户提供)、截止日期和屏幕尺寸。
  2. 脚本以表格形式呈现 — 场景或幻灯片:编号、标题、一行含义。等待“确认”。
  3. 样片。 一个场景或一两张幻灯片,完全完成:图像、动效、字幕。展示帧 → 等待“确认”。为什么:在样片中确定的风格可以延续到所有内容;而在第十二个场景中确定的风格意味着重做十二个场景。
  4. 分批处理2-3个场景或幻灯片;展示每批并等待确认。
  5. 整体组装: 导航、完整示意图地图或概览、手机布局、发布、二维码、PDF或视频 — 取决于订单内容。

截止日期在一天内: 一个样片和一次“确认”,其余内容一次性完成;仅在实际展示的尺寸下检查帧(广播屏幕,以及如果观众收到链接则包括手机尺寸)。

在说“完成”之前

  • 从qa.md中获取展示尺寸下的帧并进行审查;缺陷一次性修复。
  • 如果已发布:在线地址提供新版本(?v=NN),并且zbarimg能读取二维码。
  • 如果要求了PDF或视频:打开文件并逐页或逐帧审查。
  • 用户已看到结果并回复。
  • 清理你自己的屏幕截图、浏览器会话和服务器进程(通过其PID停止服务器)。

常见错误

  • 一次性完成全部内容并在最后展示 → 用户更改风格,你重做所有内容。分批工作。
  • 把内容做得太小:画布上十个微小标签,而不是一个宏大概念。图像要大,代码要小。
  • 用文字含糊其辞:二维码下面写“用手机扫描”、“还在成长中”、“你可以…”、手势提示。能用画面说清楚的就不要加文字。
  • 过度装饰:卡片边缘的彩色装饰条纹、闪烁、“只是好看”。动效要么用于解释过渡,要么就不存在。
  • 数字没有名词和情境(“8张卡片”) → 观众不知道他们在看什么。
  • 只“通过读取代码”检查,而没有在正确尺寸下查看帧 → 在手机上一切都会崩溃。

相关技能