剧本工具使用规范
GitHub规范剧本工具操作契约，对齐界面名称与操作对象边界。指导按任务读取分镜、画布、导演文档等附件，明确API调用与资源定位逻辑，确保生成流程合规。
Trigger Scenarios
Install
npx skills add looplj/reveric --skill 剧本工具使用规范 -g -y
SKILL.md
Frontmatter
{
"name": "剧本工具使用规范",
"description": "按任务读取剧本正文、制作片段、素材输入、生成、制作画布及导演文档的操作契约。",
"when_to_use": "适用于剧本：读写剧本结构，制作画布管理和节点操作，操作导演台，分镜管理和图像、视频生成（含 Seedance 合规校验），查询、自定义和应用视觉风格。"
}
剧本工具使用规范
先定位当前作品与任务目标，再按业务环节读取附件。剧情、对白、分镜和提示词写法使用匹配的创作技能；视频提示词的 Shot 格式由「剧本制片」提供，本技能只负责操作契约。
与界面名称对齐
| 用户在界面看到的名称 | 操作对象与边界 |
|---|---|
| 分镜、AI 拆分镜 | 已编入场次的制作条目，可为图片或视频；在 /clips 中以 is_storyboard=true 筛选，一条分镜的提示词可包含多个 Shot 镜头 |
| 视频、图片、音频 | 制作画布中的对应媒体节点；独立视频不因放在画布上就进入成片 |
| 画布、制作画布、人物参考图节点 | 集下的画布与人物参考图节点位于 /episodes/{episode_id}/production/canvas；/canvas 仅用于构思画布。具体操作前读取制作画布附件 |
| 导演台、导演构图、导演预演 | 用站位、关键姿势、整体运动和机位安排空间关系与镜头调度，输出构图静帧或白模预演；不提供动作库或自动表演 |
| 剪辑、多轨剪辑、分割 | 剪辑工程及时间线片段，使用「媒体处理与剪辑」；“分割”不是 AI 拆分镜 |
| Seedance 合规校验 | 把图片素材认证进渠道私域素材库，对应 Run assets certify；流程见分镜与媒体节点附件 |
| 导出本集、成片 | 本集 editing_id 对应的剪辑工程，使用「媒体处理与剪辑」导出；制作画布不直接合成成片 |
查询整集分镜用 /clips?episode_id=…&is_storyboard=true，只看视频分镜再加 kind=video。未关联场次的独立媒体不属于分镜；空白或未生成的场内条目仍是待完善分镜，不按标题、提示词或采用结果是否为空排除。视频分镜的 duration_ms 是计划时长，不证明正文容量或实际成片时长。
先结合用户当前视图、选中对象和读取结果定位。“第 2 个分镜”通常指一条场内制作条目，“Shot 2”指该条提示词内的镜头；仍无法确定目标时先澄清，不用内部 clip 名称猜测。反馈沿用界面名称，不把“分段”另造为一种资源。
按任务读取附件
| 任务 | Reference |
|---|---|
| 读取或修改季、集、节拍、场次与正文元素 | 剧本结构与正文 |
| 读取制作设置、创建片段、配置模型、绑定输入、修改提示词引用、Seedance 合规校验、生成与采用结果 | 分镜与媒体节点 |
| 查询风格、新建或编辑自定义风格，设置剧本默认风格、节点独立风格、无风格与继承 | 视觉风格 |
| 创建或整理制片节点、导入素材节点、调整布局、视频节点截帧／分离音轨／静音／裁剪、图片派生与预设草稿、宫格切分与高清、全景取景 | 制作画布 |
| 调整导演台人物、姿态、路径、机位、切镜和时间轴，检查画面和刷新预览 | 导演文档 |
复制 <skill_resources> 中的 reference-list 调用列出附件，再用 reference-get 读取所选文件；name 使用「剧本工具使用规范」，path 使用返回值。只加载本次任务涉及的附件，已完整读取且仍在上下文中的不重复读取。需要依据附件确定工具、参数或步骤的调用，等待附件返回后再生成，不与附件读取放在同一批。
作品内容的路径和字段以实际 Read 返回及 /_schema 为准；素材查询与导演调度使用 Run assets / Run stagings，导演文档用 Run stagings read 读取，不能通过 Read /stagings/... 读取。导演命令参数见导演文档附件；其他命令按对应附件的说明查询。不要猜 ID，不把局部读取当成完整资源。写入后回读，保留无关内容与身份。
需要查询媒体渠道与真实模型能力时，加载「系统管理」的模型查询附件。处理本地文件、剪辑时间线或跟踪后台操作时，加载「媒体处理与剪辑」对应附件。风格查询、自定义与设置的参数、流程见视觉风格附件。Run 命令是否可用以当前会话 Run help 为准；不可用时说明缺少的能力，不虚构调用或成功结果。
Version History
- ca297eb Current 2026-11-02 08:45
