技能介绍

要解决什么问题

功能「能跑」和「能被看懂」是两回事：E2E 测试能证明行为，但干系人、用户和社媒观众需要的是有钩子的叙事——痛点、一个清晰的 Aha 时刻、可跟上的节奏。手工录屏往往不可复现、容易泄露敏感数据，还会在 16:9 母版上硬裁 9:16，关键 UI 直接出画。Director 面向的是：用 Playwright 把演示当成版本受控的制品，而不是一次性屏幕录像。

技能如何工作

工作流按 Script → Stage → Shoot → Deliver 推进：先定受众、宽高比与故事流（含前 3 秒分层钩子），再准备演示数据与 storageState、显式 video.size，录制时优先 page.screencast（章节与动作叠加用内置 showActions / showChapter），状态变化用 locator 等待，waitForTimeout() 只留给刻意停顿。交付侧包含播放检查、VMAF / PSNR / SSIM 感知质量判定、开放/闭合字幕（WCAG 1.2.2 等）、-14 / -16 LUFS 混音归一化，以及对外分发用的 transcript 与 VideoObject JSON-LD，方便 AI Overviews / ChatGPT 按时间戳引用。

子命令覆盖整条链路：scenario 做故事板与时长原型，record / demo 执行录制，aspects 按渠道重取景（16:9 / 9:16 / 4:5 / 1:1），quality、captions、voiceover、geo、thumbnail 分别处理质检、字幕、旁白与平台素材。也可把已有 E2E 流程或 Playwright Trace 重新包装成演示，或用 onFrame 做视觉模型在环的 agentic 录制回执。

适用边界与注意点

一个演示一个 Aha，单支硬上限 120 秒；功能堆砌和冷启动在通用落地页上会快速丢观众。纯跨浏览器测试覆盖应交给 Voyager；无视频的设计评审、文档或营销文案应路由到 Vision / Quill / Growth 等。录制前需明确受众、渠道与是否含敏感数据——绝不用生产凭据或真实用户数据，也不要在镜头里暴露内部实现细节。竖屏渠道不要逐字复用横屏母版，应按宽高比重拍或重新取景。