用途：把故事结构化为参考图与生成单元，编写 Seedance 提示词，并产出符合 schema 的 JSON。它不负责故事本身、不执行生成，也不处理静帧提示词或 CLI 的 TypeScript 代码。
主要能力与限制：CLI 默认模型为 dreamina-seedance-2-5-260628（BytePlus ModelArk），Ark 是唯一返回 usage 块、可对账报价的路线；改用 bytedance/seedance-2.5 可走 Vercel AI Gateway。2.5 单段时长 4-30s，2.0 为 4-15s。每条镜头须绑定至少一张图，参考按媒体类型用序号绑定（如 @Image 2 指 references[] 中第二张图，first_frame 也占用图像序号）。2.0 家族中 frame 角色与 reference_* 混用属 schema 错误，2.5 可组合但 frame 角色需置前。超过 20s 须用时间戳计划（整数秒，如 0-6s:），分段数依事件数而非时钟。提示词完全展开，无跨生成记忆；音频仅收录同期声与氛围；字幕卡由 post 的 cards 数组渲染；建议 720p 生成，2.5 无 4K。
工作流：1. 锁定创意（logline、主线、时长、观感、生成预算）；2. 编写策划文档；3. 推导关键帧与道具/环境静帧，写入 stills.json，角色写入 characters.json；4. 编写 shots.json（提示词、锚定、序号绑定、seed、卡片）；5. 运行 vs cast sync 写入 cast 块与表引用；6. 对两个文件做 dry-run，修复所有警告并报告成本： node dist/cli.js stills films/<slug>/stills.json --dry-run node dist/cli.js generate films/<slug>/shots.json --dry-run 这些命令执行与真实运行相同的校验、lint 与成本估算，但不发起网络请求、不写 manifest。需分别报告生成数、片段总秒数与卡片秒数（卡片会额外增加时长）。2.5 影片不应设置 film.draftModel，留空则 --draft 以影片自身模型按 480p 运行。相关技能包括 storycraft、vs、nano-banana-2。