Communitygithub.com

产品电影故事板

将产品电影的故事编写为节拍(观众看到的、屏幕上的文字、配音、音效、节拍存在的原因以及每个声明的证明位置),并以一页故事板的形式(附帧画面)发送给所有者以供评审;当故事方向尚未确定时,提供2-4个方向。这是产品电影的第二阶段,评审格式也可复用于配音。在策划发布/宣传片的故事、分镜列表或脚本时,或者当所有者说“给我一个故事板”、“给我方向”、“我来评审并决定”时使用。

产品电影故事板 是什么?

该技能用于指导AI助手(如Claude Code等)执行产品电影故事板的生成与评审流程。它从已批准的简报和产品参考资料出发,将电影故事分解为一系列详细的“节拍”(beat),每个节拍包含时间码、画面描述、屏幕文字、配音脚本、音效、存在理由及证明来源(声明)。当故事方向未定时,技能要求AI生成2-4个截然不同的方向(例如“观众能用的技巧”与“日常烦恼”),每个方向附带一句话创意、风险和适配人群。然后,技能通过Python脚本自动构建一个可发送给产品所有者的一页HTML故事板,其中包含每个方向的配音段落(用于闭眼倾听测试)以及带帧画面的节拍序列。技能强调在构建前先评审,因为修改一句文字仅需一分钟,而修改已渲染的画面则需一小时。它支持所有编写电影故事板的平台(如Claude Code、Cursor、Codex等),其工作流包括阅读参考资料、草拟故事板JSON、构建页面、执行自我检查与评审关卡,最终将storyboard.json作为唯一真实来源,确保所有后续变更(如镜头时长、配音措辞)均先在此处修改并重新生成页面。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aqeelshamz/product-film-skills/tree/HEAD/film-storyboard

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

产品电影故事板 是做什么的?

故事板是所有者进行大部分修正的地方,因为修改一句话只需一分钟,而修改一个已渲染的镜头则需一小时。在开始构建之前发送它,并在录制配音之前再发送一次(附上真实帧画面)。

优秀产品电影故事的要素

对照以下要点检查每个节拍。每一条都来自被拒绝的草稿(参见 product-film/references/lessons.md)。

  1. 观众的痛点,在他们日常的场景中。 用观众自己的话描述习惯或烦恼。测试这句话:听到它之后,一个陌生人会认为我们卖什么?"Same numbers every day"(每天同样的数字)让人联想到分析软件,所以失败了。
  2. 角色不能被误解。 用真实工具的名称和Logo展示。检查每一对相邻的台词:"Ask the AI you already pay for. It's called Nimbet."(问你已经在付费的AI。它叫Nimbet。)让产品听起来就是那个AI。要把名称与产品所做的具体事情绑定。
  3. 具体,而非抽象。 作为标签的"你的AI"含义模糊;Claude Desktop的真实窗口就清晰明确。真实的Stripe仪表盘远胜于标有"收入"的框框。
  4. 范围需要空间。 如果承诺是"你需要的任何东西",展示8种以上不同类型的人(每类一屏全屏卡片),然后是一面混合了工作、生活和乐趣(游戏、宠物、贴纸)的诸多物品墙。少于约6个会"感觉卡住了"。这需要45-65秒;20秒太短。
  5. 仅限真实。 每一项功能、能力和声明都在产品中真实可用。用证明来源填充 claim 字段(文件、文档、测试)。如果故事需要产品做不到的东西,向所有者提出:要么构建它,要么删掉它。
  6. 在描写之前先理解每个镜头。 为每个节拍写下 why。如果你说不清一个镜头的作用,去问所有者。(有一行关于宠物的台词被写在了实际展示用户自定义小部件的镜头之上。)
  7. 每一行都易读。 屏幕文字:每词约0.3秒 + 1秒,完全可见时间不得少于1.5秒。
  8. 以行动收尾,包含名称和URL,如果使用了任何品牌,还需加上提述使用条款。

步骤

  1. 阅读已批准的简报、reference/NOTES.md、产品的实时运行状态和网站,以及经验教训文件。
  2. 草拟节拍到 storyboard.json 中(格式见脚本头部):
    { "title": "…", "subtitle": "draft 1 · 16:9 · 60 s", "directions": ["A · …", "B · …"],
      "beats": [{ "t": "0.0–4.0", "still": "review/sketches/01.png", "picture": "…", "onscreen": "…",
                  "vo": {"A · …": "…", "B · …": "…"}, "sfx": "…", "why": "…", "claim": "…" }] }
    
    在电影存在之前,still 可以是快速草图或带备注的参考帧;之后,务必使用真实的已渲染帧(node scripts/render.mjs --at …)。
  3. 方向。 当角度未定时,写出2-4个在创意上(而非措辞上)不同的方向(例如 "观众能用的技巧"、"日常烦恼"、"你的AI已经了解你什么")。每个方向包括:一句话创意、风险以及适合人群。将你的首选放在最前面。
  4. 构建页面:
    python3 ~/.claude/skills/film-storyboard/scripts/storyboard.py storyboard.json review/storyboard.html
    
    页面以每个方向的配音段落开始(闭眼倾听测试),随后是每个节拍及其帧画面。
  5. 发送前自我检查: 仅阅读配音段落。闭眼听是否合理?是否有任何可能被误读的台词?是否有 "你的X,你的Y" 列表、三连句或重复词汇?是否有任何声明缺少证明?
  6. 评审关卡。 发送页面(SendUserFile, display render),询问:哪个方向?哪些节拍需要修改?添加第2阶段问题(来自 product-film/references/question-bank.md,涉及开场、角色展示方式、人物形象格式、人物角色、UI真实感)。等待明确的确认。提交 storyboard.json。

批准之后

将 storyboard.json 作为唯一真实来源:电影中的镜头时长和配音中的短语位置都来源于此。当所有者后来更改某个节拍时,先在此处修改,然后重新生成页面。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

film-build

Build a product film in code as a deterministic seek(t) web page (real product UI, real OS chrome, kinetic text, typed prompts, a cursor, morphs and camera moves), review it as stills and drafts, render it at 60 fps with motion blur, and adapt it to 9:16 without changing 16:9. Ships a project kit (init.sh, film engine, render/sync/probe/sheet/regression tools). Stage 3 and 6 of product-film. Use when building, fixing or rendering the picture of a launch/promo film, or making its vertical version.

film-sound

Add sound to a finished product-film picture with real recorded sound effects (CC0 packs such as Kenney's) placed only on real on-screen events, decide with the owner whether there's a music bed, mix to -14 LUFS and mux into the renders without re-rendering. Stage 4 of product-film. Use when a film's picture is approved and needs sound effects or music, or when the owner says the sounds feel fake, synthetic or "AI slop".

film-voiceover

Write, review, test and record the voiceover for a product film after its picture is approved, as a script on a storyboard of the film's real frames, with directions to choose from, an eyes-closed coherence check, a pronunciation test for the product name, TTS recording per section (Fish Audio), phrase placement on the film's timeline, mixing and muxing. Stage 5 of product-film. Use when a launch/promo film needs narration, or the owner says the voiceover sounds like AI, doesn't match the frames, or mispronounces the name.

product-film

Make a product launch / promo / explainer film that sells and does not look or sound AI-made, through review gates the owner signs off one at a time. Study a reference video for its grammar (never copy it), then storyboard, build the film in code, add sound, write and record the voiceover, and deliver 16:9 and 9:16. Use when someone wants a launch video, promo, product film, explainer, ad, "a video like this one" for their product, or says the last video looked like "AI slop" or "vibe coded". Entry point for the film-* skills (film-reference-study, film-storyboard, film-build, film-sound, film-voiceover).

相关技能