视频脚本撰写器 是做什么的?
为产品演示、功能演练和发布视频撰写视频脚本。处理节奏、视觉方向、时间安排和适合平台的时长。
输入解析
按以下顺序解析提供的参数:
- 现有营销简报(包含“执行摘要”或“关键信息”的
.md文件)的路径 -> 营销简报 - 现有博客文章(具有博客文章结构的
.md文件)的路径 -> 博客文章 - 现有更改日志的路径 -> 更改日志
- 现有新闻通讯的路径 -> 新闻通讯
- 匹配 GitHub URL 或
#\d+模式 -> PR - 包含
...或..-> Git 引用范围 - 解析为现有文件/目录 -> 代码库功能
- 否则 -> 自由文本
如果未提供参数,则询问:“视频要关于什么内容?您可以提供营销简报、博客文章、更改日志、PR URL/编号、Git 引用范围、文件/目录路径,或者直接描述该功能。”
如果多个解释匹配,则与用户确认。
流程
digraph video_script {
rankdir=TB;
"解析输入" [shape=box];
"阶段 1:发现" [shape=box];
"阶段 2:配置" [shape=box];
"阶段 3:大纲" [shape=box];
"大纲已批准?" [shape=diamond];
"阶段 4:撰写" [shape=box];
"阶段 5:审查" [shape=box];
"已批准?" [shape=diamond];
"阶段 6:输出" [shape=box];
"解析输入" -> "阶段 1:发现";
"阶段 1:发现" -> "阶段 2:配置";
"阶段 2:配置" -> "阶段 3:大纲";
"阶段 3:大纲" -> "大纲已批准?";
"大纲已批准?" -> "阶段 3:大纲" [label="否,修改"];
"大纲已批准?" -> "阶段 4:撰写" [label="是"];
"阶段 4:撰写" -> "阶段 5:审查";
"阶段 5:审查" -> "已批准?";
"已批准?" -> "阶段 4:撰写" [label="修订"];
"已批准?" -> "阶段 6:输出" [label="是"];
}
不要跳过任何阶段。 以自然节奏提问。如果用户一次性回答多个问题,则接受捆绑答案并跳转到后续阶段。
如果用户说“直接选默认值”或类似的话,则选择合理的默认值,说明您的选择,并要求用户进行一次性确认。
阶段 1:发现
步骤 1 - 分析输入
| 输入类型 | 需读取的内容 |
|---|---|
| 营销简报 | 提取问题陈述、价值主张、受众、关键信息。跳到步骤 3。如果简报缺少产品上下文,则仍需执行步骤 2。 |
| 博客文章 | 提取标题、关键点、受众、行动号召。跳到步骤 3。 |
| 更改日志 | 提取关键条目,关注最有影响力的更改。跳到步骤 3。 |
| 新闻通讯 | 提取主题、关键更新、行动号召。跳到步骤 3。 |
| PR | Diff、PR 描述、审查评论、提交信息。对于大型 PR(20+ 个文件),关注面向用户的更改。 |
| Git 引用 | git diff 和 git log 在引用之间。优先选择面向用户的更改。 |
| 代码库功能 | 读取指定的文件/目录。 |
| 自由文本 | 解析用户的描述。如果缺乏细节,请用户提供更多信息或指向特定文件/PR。 |
面向用户的更改包括:新功能、UI 更改、API 更改、性能改进、错误修复和文档更新。内部更改包括:重构、测试添加、CI 更改和依赖项升级。
错误处理:
gh不可用 -> 告知用户,提供替代输入- 无效的 PR/引用 -> 请用户验证
- 文件未找到 -> 请求正确的路径
步骤 2 - 读取更广泛的产品上下文
读取(如果存在):README、docs/、package.json(或等效文件)。
如果未找到,则询问:“您能简要描述一下产品及其面向的受众吗?”
步骤 3 - 呈现理解
“以下是视频脚本将基于的内容:”
- 功能 A - 简短描述
- 功能 B - 简短描述
“需要添加、删除或更正什么吗?”
在用户确认范围之前,不要继续。
步骤 4 - 敏感内容检查
在继续之前,扫描可能敏感的内容:安全补丁、内部定价、凭据、未发布的路线图项目或标记为机密的内容。向用户标记任何可疑内容。
阶段 2:配置
提出以下问题:
问题 1 - 视频长度:
- 短视频(30-90 秒) - 社交媒体(Reels、Shorts、TikTok)
- 中视频(3-5 分钟) - YouTube、产品演示、演练
问题 2 - 脚本类型:
- 画外音 - 在屏幕录制/素材上朗读的旁白文本
- 分栏脚本 - 左栏:视觉方向/屏幕操作,右栏:旁白
- 面对镜头演讲 - 演讲者在镜头前,对话式表达
问题 3 - 语气: 阅读现有仓库内容以检测语气。确认:
“根据您现有的内容,语气似乎是 [例如 对话式和开发者友好型]。我应该匹配这种语气,还是采用不同的方向?”
如果没有内容可供分析,则直接询问。
问题 4 - 行动号召: 根据上下文推断:
- 开源 -> “Star 仓库”、“试试看”
- SaaS -> “免费注册”、“开始试用”
- 功能更新 -> “立即尝试”、“查看文档”
“我建议的行动号召是:[推断的行动号召]。要采用这个还是其他内容?”
阶段 3:大纲
生成包含时间安排的结构化大纲。根据视频长度使用适当模板:
短视频(30-90 秒)- 3-4 部分:
## [工作标题] - [总时长]
1. **钩子** (0:00-0:05) - [方法]
- 关键点
- 视觉: [要展示的内容]
2. **问题** (0:05-0:15) - [要建立的痛点]
- 视觉: [要展示的内容]
3. **解决方案** (0:15-0:45) - [功能演练]
- 关键点 A
- 视觉: [要展示的内容]
- 关键点 B
- 视觉: [要展示的内容]
4. **行动号召** (0:45-0:60) - [要采取的行动]
- 视觉: [结束画面]
预估总计:约 X 词(约 Y 秒,按 135 词/分钟计算)
中视频(3-5 分钟)- 5-8 部分:
## [工作标题] - [总时长]
1. **钩子** (0:00-0:10) - [方法]
- 视觉: [要展示的内容]
2. **问题** (0:10-0:30) - [痛点、背景、为何重要]
- 视觉: [要展示的内容]
3. **解决方案概述** (0:30-1:00) - [高层级的构建内容]
- 视觉: [要展示的内容]
4. **深入探讨:[功能 A]** (1:00-2:00) - [演练]
- 关键点
- 视觉: [屏幕录制步骤]
5. **深入探讨:[功能 B]** (2:00-3:00) - [演练]
- 关键点
- 视觉: [屏幕录制步骤]
6. **深入探讨:[功能 C]** (3:00-3:45) - [演练]
- 关键点
- 视觉: [屏幕录制步骤]
7. **回顾** (3:45-4:30) - [总结关键收益]
- 视觉: [总结幻灯片或并排对比]
8. **行动号召** (4:30-5:00) - [要采取的行动]
- 视觉: [结束画面]
预估总计:约 X 词(约 Y 秒,按 135 词/分钟计算)
调整深入探讨部分的数量以匹配所涵盖的功能。
在撰写前呈现大纲并等待批准。
阶段 4:撰写
节奏参考
| 视频长度 | 目标词数 | 词/分钟 |
|---|---|---|
| 30 秒 | ~65 词 | 130 |
| 60 秒 | ~135 词 | 135 |
| 90 秒 | ~200 词 | 135 |
| 3 分钟 | ~400 词 | 135 |
| 5 分钟 | ~675 词 | 135 |
目标节奏:130-145 词/分钟,适合对话式表达。标记任何超出分配时间的部分。
按类型的脚本格式
画外音脚本:
## [标题]
### 钩子 (0:00-0:05) - ~15 词
视觉: [屏幕上内容的描述]
[此处为旁白文本。]
### 部分名称 (0:05-0:20) - ~30 词
视觉: [屏幕上内容的描述]
[此处为旁白文本。]
分栏脚本:
| 时间 | 视觉 | 旁白 |
|---|---|---|
| 0:00-0:05 | [屏幕:登陆页面加载] | [旁白文本] |
| 0:05-0:15 | [屏幕:点击设置菜单] | [旁白文本] |
| 0:15-0:30 | [屏幕:切换暗黑模式] | [旁白文本] |
面对镜头演讲脚本:
## [标题]
### 钩子 (0:00-0:05) - ~15 词
摄像头: [演讲者在镜头前,中景]
[演讲者文本。对话式,直接面对镜头。]
### 部分名称 (0:05-0:20) - ~30 词
摄像头: [切换到屏幕录制]
画外音: [屏幕录制上的旁白]
摄像头: [回到演讲者]
[演讲者文本。]
钩子
开头的 3-5 秒决定了观众是否会继续观看。钩子必须:
- 解决一个痛点或提出一个挑衅性问题
- 不要以您的公司/产品名称开头
- 不要以“在本视频中,我将向您展示...”开头
- 立即创造好奇心或情感共鸣
视觉方向
无论脚本类型如何,始终在行内包含视觉方向:
视觉:/屏幕:用于屏幕录制和素材摄像头:用于面对镜头演讲的摄像头方向- 要具体:“屏幕:点击导出按钮,展示 PDF 下载”,而不是“屏幕:展示功能”
- 包括场景之间的过渡说明
每部分时间安排
为每个部分包含预估时长和词数:
### 部分名称 (0:15-0:30) - ~30 词- 如果任何部分超出其时间预算,则进行标记
- 总脚本词数必须与目标时长匹配(按 135 词/分钟计算)
撰写规则
- 对话式,听起来不像是照着稿子念。写出人们实际说话的方式。
- 短句。每个句子最多 10-15 个词。
- 每个句子一个想法。
- 始终使用主动语态。
- 在生成的内容中切勿使用长破折号。没有“---”字符。改用逗号、冒号、句点或括号。
- 展示,而不是告知。“看看这个加载速度有多快”优于“它加载得非常快”
- 对于中视频,使用“三原则”:三个收益、三个功能、三个示例。对于短视频,专注于单个关键收益。
行动号召
- 视频的最后 5-10 秒
- 单一、清晰的行动
- 包含结束画面的视觉方向(订阅按钮、链接覆盖层、QR 码)
阶段 5:审查
呈现包含时间分解的完整脚本:
“这是脚本:”
[完整脚本]
时间分解:
- 钩子:5 秒(~15 词)
- 问题:10 秒(~25 词)
- 解决方案:30 秒(~70 词)
- 行动号召:10 秒(~20 词)
- 总计:55 秒(~130 词,按 135 词/分钟计算)
“需要做任何更改吗?”
等待批准。仅在用户确认后才进入输出阶段。
阶段 6:输出
始终在终端打印最终批准的脚本。
然后询问:“要将其保存到 scripts/<slug>.md 吗?或者其他路径?”
如果目录不存在则创建。如果文件已存在,则询问是覆盖还是创建版本化副本。
错误处理
gh不可用 -> 告知用户,提供替代输入- 无效的 PR/引用 -> 请用户验证
- 无产品上下文 -> 请用户描述产品
- 脚本超出目标时长 -> 标记并在审查前建议删减
此技能不做什么
- 录制或编辑视频
- 生成缩略图或视觉素材
- 创建动画或动态图形
- 撰写博客文章或社交媒体文案(请使用
/blog-post或/social-copy)