Georges Petrov 让 Claude Code 用开源的 Screenplay 给文档每一页拍功能演示视频,按钮改名后夜间检查会直接报红
SaaS 文档里每个功能页配一段操作视频会更好懂,但录一段要一小时,产品一改版又过时了。Georges Petrov(@georges_petrov)把每段视频写成一个小脚本:agent 先在演示账号里摸清功能、写好步骤,开源工具 Screenplay 在无头浏览器里照着点、录屏并剪辑(平滑光标、跟着点击放大、字幕、可选配音)。同一个脚本也是测试:check 快速跑一遍不录像,按钮被改名或删掉时就失败,放进每晚的 CI 里就能知道哪段视频过期了。我们在 Linux 上装了 Screenplay 0.1.7,用它自带的示例应用完整录了一段 22 秒的 1080p 视频,再把「Take over」按钮改名,check 在第 3 步失败、退出码为 2。
访问官网 Screenplay (agent-screenplay) + Claude Code ↗- 定价
- 免费
- 地区
- 海外
- 出自哪里
- 海外社区
- 上架日期
- 2026 年 11 月 14 日
- 实测日期
- 2026 年 11 月 14 日
- 用的版本
- agent-screenplay 0.1.7 (npm), Chrome Headless Shell 159; author used Claude Code with Fable 5.2
- 我们实测
- 部分实测
- 成本 / 耗时
- Screenplay 免费开源(MIT),本身不含 AI、不需要模型 key。写脚本和看分镜靠你的 agent,消耗 Claude Code、Codex 或 Cursor 的额度;配音可选,用 Cartesia 或 ElevenLabs 按量付费。
要解决的事
给产品文档的每个功能页配一段一分钟内的操作视频,并且在界面改动后能自动发现哪些视频已经和产品对不上。
步骤
- 准备 Node 20 以上,运行 npx agent-screenplay init。它会下载一次 Chromium,把 Screenplay 的 MCP 服务加进 Claude Code(有 Codex、Cursor 也会加),并装一份教 agent 怎么拍好视频的指南。作者用 claude --model claude-fable-5-2 启动。
- 做一个看起来有人在用的演示账号或测试环境,不要拍正式环境(脚本会真的点「发送」)。用 npx agent-screenplay login <你的应用地址> -o videos/.screenplay/auth.json 登录一次保存会话,这个文件不要提交到 git。
- 先让 agent 读完 docs/,为每个演示操作的页面提一段视频,写成 videos/shotlist.md 表格,先别拍。你在表里删掉、合并或拆分条目。作者的规则:一段视频讲一件事,60 秒以内。
- 在 videos/screenplay.config.json 里定一次统一风格(背景、边距、圆角),或用 npx agent-screenplay style 在画面上挑。
- 把「好视频」的规则写成一个 skill(.claude/skills/docs-video/SKILL.md):旁白用页面上的原词、讲观众得到什么、先 check 再录、每次录完看分镜图、最多录三次。
- 让 agent 按 shotlist 每行开一个子 agent 并行拍,每次 4 个。需要配音时在配置里打开 voice,并设置 Cartesia 或 ElevenLabs 的 key;没有 key 可以自己生成音频文件挂到每一步。
- 视频放到对象存储加 CDN,仓库里只留脚本。每晚对测试环境跑一遍 npx agent-screenplay check,失败时日志会说是哪一页的哪一步。
提示词
读一遍 docs/ 里的每一页。凡是展示用户在应用里做某件事的页面,各提一段视频:对应页面、看完后观众应该会做的那一件事、起始网址、演示它的 3 到 8 个操作,以及最后停在什么结果上。跳过概念介绍页和 API 参考。写成表格放进 videos/shotlist.md。先不要拍。
原文怎么说
Georges Petrov @georges_petrov(X 长文,2026-11-12):他们文档「Needs you」页顶部的视频 56 秒、1080p、带配音、平滑光标和跟随点击的放大,没人打开录屏软件,是 agent 在演示账号里探索、写脚本、拍出来的。用 Claude Fable 5.2 一条提示词就能拍完一整个文档文件夹。配音按文本缓存,台词不变重渲染不花钱;改台词用 render,不用重拍。他在 Screenplay 的示例应用里把「Take over」改成「Assign to me」后,check 失败并保存了停下位置的截图。Screenplay 是他自己写的开源工具(MIT);文末也介绍了他做的 Brigade(本地免费,云端 99 美元/月/工作区),可以在每次推送到 main 后自动重拍坏掉的视频并开 PR。
我们实测
2026-11-14 在 Linux(Node 24.22.1)上 npm i agent-screenplay(0.1.7),批准 ffmpeg-static 的安装脚本后,npx agent-screenplay init --no-mcp --no-skill 下载了 Chrome Headless Shell 159(125.7 MiB)。用仓库自带的 examples/handoff-demo.json(8 步,对着 examples/demo-app):check 8 步全部通过,约 3 秒;record 生成 handoff-demo.mp4(22.3 秒,1920×1080,30 fps,约 5.2 MB)和一张分镜图,整个过程约 33 秒,分镜图里能看到放大和字幕。然后把 demo-app 里的「Take over」全部改成「Assign to me」再跑 check:第 3 步失败,提示 nothing visible matches,并列出页面上能看到的按钮(包括 Assign to me),保存了停下位置的截图,退出码 2,可以直接让 CI 变红。没有接 Claude Code 或 Fable 5.2,没有让 agent 写脚本、拍真实文档、并行拍摄,也没有测配音和 Brigade。
我们亲自试下来:录制和「过期检查」这两块按文章说的工作:同一份脚本能录出带放大和字幕的 1080p 视频,按钮改名后 check 会失败并指出是哪一步。agent 写脚本和自查分镜的效果要你接上自己的 agent 再看。
怎么用上
原帖是英文 X 长文,可用浏览器翻译。Screenplay 的 README 和命令行都是英文;旁白支持多语言,加一份翻译后的脚本并设 language 即可出中文版。
适合谁
有网页版产品和功能文档、想给每页配演示视频的团队;已经有测试环境或演示账号的更容易上手。
踩坑提示
- check 和 record 会真的点按钮,只对着演示账号或测试环境用。
- 并行拍摄的视频会互相改到共享数据,给每段视频单独的项目和客户,会改共享数据的放最后单独拍。
- 保存的登录会话会过期,要定期刷新;check 只能发现流程断了,界面改版后要全部重拍。
- 我们用的 npm 版本默认不跑依赖的安装脚本,需要 npm install-scripts approve ffmpeg-static 再 npm rebuild,否则缺 ffmpeg。
- 桌面应用录制需要真实屏幕,无头服务器上只能录网页。
同类用例
- 火柴人讲解短片改成代码生成,单条约 0.54 美元视频创作Claude CodeFFmpegChrome需 Claude 订阅或 API;本机渲染○ 未实测国内
- 一句话话题,本机做出带配音的技术讲解视频视频创作Claude CodeChatterboxffmpeg技能免费;需 Claude Code 订阅◐ 部分实测海外
- 用代码逐帧渲染出克制的动效视频视频创作Claude CodePlaywrightffmpeg需 Claude 订阅;其余工具免费◐ 部分实测海外
- 一张参考图,出可拆开的机械 3D 模拟器视频创作teardownClaude Codethree.js技能免费;需 Claude Code/Opus◐ 部分实测海外
- 说一个选题,出一条每句有出处的知识短片视频创作Claude Code小米 MiMoRenoise基础档 0 积分;需 Claude 订阅◐ 部分实测国内