用途
该技能面向程序化视频（programmatic video）的脚本创作，即把脚本写成结构化数据，让渲染引擎可以直接读取并生成视频。与传统的影视编剧不同，程序化视频脚本中的每个场景都有明确的时长、帧数、动画描述和旁白文本。技能覆盖的环节包括：访谈需求方、生成结构化 YAML 脚本、计算节奏与帧数、撰写旁白、以及根据反馈修订脚本。
主要能力
- 访谈驱动：在生成任何场景之前，先按 7 个类别进行结构化访谈（最多 30 个问题），不基于假设写脚本。7 个类别为：产品/主题、受众、视频目标、语气与风格、素材、内容、视觉偏好。时间紧张时可用 10 个核心问题的精简版。
- 结构化输出：每个脚本都是合法 YAML，包含 meta 块和 scenes 数组。场景字段包括 id、duration、frames、narration、visual、animation、music、sfx、transition_to_next。
- 画面优先：先写 visual 字段，再写 narration；旁白应补充画面，而不是重复描述屏幕上已有的内容。
- 节奏控制：按视频类型匹配场景数量与单场景时长。社交短片场景 3-8 秒；讲解视频可放宽到 5-12 秒。
- 旁白与画面同步：每句旁白必须与当下可见内容对应，一个场景只表达一个想法，旁白时长要能放进场景时长内。
- 帧数计算：total_frames = duration_seconds * fps；scene_frames = scene_duration_seconds * fps。需校验各场景帧数之和等于 meta 中的 total_frames。
- 转场规划：可选 hard-cut、cross-dissolve、fade-to-black、wipe-left、wipe-right、none；建议每个视频最多使用 2 种转场类型以保持一致性。
- 脚本修订：按反馈类型（节奏、旁白、画面、结构、语气）定位受影响场景，只改相关字段，保留帧数计算，并重新校验时长总和。
使用方式
技能被激活时，首次回复需以 :pencil: emoji 开头。典型流程为：先走访谈流程收集需求，再生成 YAML 脚本，然后校验帧数与时长，最后按反馈修订。技能文档中给出了产品演示脚本、社交短片脚本的完整 YAML 示例，以及帧数换算表（如 60 秒 30fps = 1800 帧）。旁白撰写规则包括：每句最多 15 词、主动语态现在时、与画面匹配、一个场景一个想法、先讲收益、可用空旁白留呼吸感、阅读速度约每秒 2.5 词。
适用场景
- 为程序化或代码生成的视频写脚本
- 规划视频的场景结构、时间与转场
- 以结构化格式（YAML、JSON）创建分镜
- 根据时长与 FPS 计算帧数
- 为视频场景撰写旁白文本
- 针对不同内容类型（演示、讲解、社交）规划视频节奏
- 通过访谈流程收集视频需求
- 修订或重构已有视频脚本
限制
不适用于：实拍电影制作或传统编剧；视频剪辑软件教学（Premiere、Final Cut、DaVinci Resolve）；播客或音乐制作等纯音频内容；静态图片设计或静态演示幻灯片。
文档还列出常见错误与注意事项，例如：先写旁白后写画面、场景超过 12 秒、帧数不匹配、旁白每句超过 15 词、前 3 秒没有钩子、转场不一致、跳过访谈、画面描述为空；以及帧数取整、旁白时长溢出、竖屏与横屏分辨率选择、音乐 ducking 冲突、修订后总时长漂移等细节。
关于配套技能检查：技能首次激活时会检查已安装的配套技能，若缺失会提示安装命令 npx skills add AbsolutelySkilled/AbsolutelySkilled --skill <name>。
该技能的详细子主题参考文件包括 references/interview-questions.md（完整 30 问访谈框架）和 references/pacing-guide.md（各视频类型的节奏策略、钩子技巧、CTA 位置与节奏模式），仅在任务需要时加载。