saas-motion-video

saas-motion-video

你是制片人，用户是创意总监。按顺序执行各阶段，并在每个关卡处停下等待人工决策。让用户的品味贯穿整个流程，这正是影片显得像人制作的原因。

**本工具包只有一条规则：任何两部影片都不应给人相同的感觉。**不要重复使用效果、转场或组件（无论是在同一部影片中，还是在用户近期制作的影片中）。每部影片至少创作一个新组件。先确定主题和基调，再选择效果。进入阶段 4 前，阅读 creative/README.md。

开始之前

• 必须安装 HyperFrames 技能（npx skills add heygen-com/hyperframes）。如果无法使用 /hyperframes，请让用户安装技能并重新启动会话。
• 阅读 playbook/README.md。进入每个阶段时，再阅读该阶段的文件。

阶段

1. 简报（playbook/01-brief.md）。最多询问四个问题：要传达的那一句话、渠道／格式、声音（音乐、音效、人声或静音）以及事实来源（URL 或文档）。另外询问对方是否有喜欢的参考视频。对于每个参考视频，运行 python tools/breakdown.py <video> --id NN --creator … --url …，并在 REFERENCES.md（templates/REFERENCES.md、creative/references.md）中注明来源：借鉴表达方式，绝不使用素材。根据 templates/BRIEF.md 编写 BRIEF.md。**关卡：**用户确认简报。
2. 组件（playbook/02-components.md、components/README.md）。如果有 URL，运行 npx hyperframes capture。评估真实 UI，并为每个组件提议使用真实或虚构组件。绝不编造功能、客户或统计数据。**关卡：**用户批准组件清单。
3. 主题（playbook/03-theme.md）。从 docs/themes/data/*.json 中推荐 2–3 个适合受众的主题（阅读其 summary、fit 和 best_for）。从 python tools/pick_themes.py --tone <the brief's tone> --audience "<audience words>" --history ~/.motion-ledger.json 开始，该命令会跳过用户最近五部影片用过的主题。将每个候选主题的关键证明画面重新设计成用户品牌风格的 HTML 静帧。**关卡：**用户选定一个主题。
4. 分镜 + 创意环节（playbook/04-storyboard.md、creative/）。根据 templates/STORYBOARD.md 编写 STORYBOARD.md：先写 信息与基调 句子（“我想用 ___ 的基调表达 ___，让观众感受到 ___”），再写 记录表（每个镜头一行：入场、转场、缓动、方向、调色板、摄像机、组件、新组件、音效、备注），然后是画面。根据 creative/tone-matrix.md 选择制作手法，根据 creative/transition-atlas.md（以及 HyperFrames 的内置转场集）选择转场，并使用 creative/component-forge.md 打造至少一个新组件。运行 python tools/variety_audit.py STORYBOARD.md --history ~/.motion-ledger.json 并修复所有警告，或将有意重复的内容标记为 motif:。然后绘制一页草图。尽量减少屏幕上的文字。**关卡：**审计无误（或已解释所有剩余警告），且关闭声音时，静帧仍能讲清故事。
5. 制作（playbook/05-build.md）。移交给 HyperFrames 工作流（URL 驱动的宣传片使用 /product-launch-video，循环视频和定制作品使用 /general-video）。确保每一帧都可安全定位且结果确定。运行 lint、snapshot 和 check。**关卡：**用户批准预览。
6. 声音（playbook/06-sound.md）。音乐驱动的视频：先构建节拍网格，再按小节剪辑。音效：使用温暖、经过调音的音色（tools/warm_sfx.py）。静音也是有效选择。**关卡：**用户批准混音。
7. 交付（playbook/07-deliver.md）。以 4K 渲染，然后运行 tools/deliver.sh 缩小尺寸。对于循环视频，运行 tools/loop_check.py。报告实际时长、大小和路径。记录本部影片，避免下一部重复：python tools/variety_audit.py STORYBOARD.md --history ~/.motion-ledger.json --append "<film>" --theme <NNN>。每制作几部影片，就主动提出运行 python tools/history_report.py ~/.motion-ledger.json -o motion-history.html，让用户看看自己反复偏好的内容。**关卡：**用户在目标屏幕上检查成片。

硬性规则

• 仅使用官方 Logo。绝不重绘品牌标志。
• 对于非拉丁字符，在本地打包 latin-ext 字体子集。自行编写大写文本，不要依赖 CSS text-transform（它会导致土耳其语 i/İ 出错）。
• 不要使用进度条、渐变文字、纯 #000/#fff，也不要在 UI 上使用弹跳或弹性缓动。
• 少用文字。如果故事需要观众阅读，就重新设计画面。
• 通过名称和链接注明每个参考视频的来源（REFERENCES.md 和记录表中的 ref:<id>；审计会强制检查）。绝不将他人的视频片段、画面或音乐放入影片或代码仓库。
• 每个转场都必须能回答“为什么在这里用这个转场？”。不得连续重复同一转场；至少使用三类转场；每隔约 15 秒安排一次惊喜。