前言¶
短剧、竖屏剧、信息流剧的交付节奏快，团队里常见分工是编剧出稿、导演口头补视觉，再交给摄影和剪辑拆镜。若分镜只靠表格或聊天记录整理，景别、机位、卖点镜头和后期说明容易散落，后期改一版剧本就要整表重抄。
下面介绍 SkillHub 上的 短剧文字分镜脚本（@ihangfeng/hf-drama-storyboard-script，v1.0.0）。它在 Agent 侧把「剧集内容 + 导演视觉建议」收敛成逐镜头文字分镜，并按固定 schema 输出 严格 JSON，便于拍摄、剪辑、特效和宣发标注共用同一套结构。
这是什么¶
短剧文字分镜脚本 是面向内容创作的 Agent Skill，发布者为 航峰汇智，来源标注为 enterprise，分类为 content-creation。SkillHub 页面显示评分 100000，下载约 3153 次；标签 requires_api_key=false，安装后无需额外 API Key。
官方入口：
- Skill 资源：
https://api.skillhub.cn/ihangfeng/hf-drama-storyboard-script - 商店页：
https://www.skillhub.cn/skills/ihangfeng/hf-drama-storyboard-script
一句话定位：根据剧集剧本内容和导演视觉建议，生成短剧文字分镜脚本，覆盖镜头拆解、景别设计、镜头调度、视效说明、剪辑节奏、卖点标签整合，以及可拍摄分镜 JSON 输出；适用短剧、漫剧、信息流剧、竖屏剧等形态。
核心功能¶
以下能力均来自该 Skill 的 SKILL.md 说明，启用后由 Agent 按文档执行。
输入与边界¶
用户通常提供两类材料：
- 剧集内容：剧本、梗概、动作、台词、人物状态、场景说明。
- 视觉呈现内容：导演建议、视觉风格、情绪曲线、视觉锚点、必须入镜元素、色彩风格、特效方向。
若只有剧集内容，仍会生成分镜；与导演意图相关的字段会标明「未提供，按剧情语境推定」。Skill 明确要求：不得凭空新增会改变剧情因果的事件、角色或道具。
工作流程¶
Agent 按固定步骤处理：
- 通读剧集内容，提取场景、角色、行动链、台词、情绪与冲突。
- 通读视觉呈现，提取情绪曲线、视觉锚点、必入镜元素、色彩、特效与商业卖点。
- 按动作节奏拆镜：环境交代、起势、冲突、反应、反转、结果、钩子各自成镜。
- 为每镜指定景别、机位运动、人物调度、光影色彩、特效后期、声音与剪辑点。
- 把导演视觉建议写入对应镜头字段，而非堆在备注里。
- 最终只交付严格 JSON，不输出解释、Markdown 表格或代码块包裹。
镜头与字段规范¶
- 一镜一事：每个镜头只承载一个清晰动作、情绪反应或信息揭示；视觉描述以
【全景】、【中景】、【近景】、【特写】、【极特写】等景别标签开头。 - 商业卖点（打脸、身份暴露、亲密拉扯、危机、反转等）需落到可被剪辑抓取的镜头；高情绪段倾向短镜头与特写，铺垫段可用稳定中景或横移。
- 单镜字段包括：
镜头编号（S01连续编号）、剧情节点、时长建议（秒数区间）、景别、视觉描述、人物与动作、台词与声音、剪辑与转场、特效与后期、导演意图整合、卖点标签（数组）、来源依据。 - 顶层 JSON 仅含
分镜信息与文字分镜脚本；分镜信息含剧集标题、场景、整体情绪曲线、色彩风格、视觉锚点、必须入镜元素，以及无法分配的未使用导演元素说明。
交付前 Skill 要求自检：JSON 可解析、无 Markdown/注释/尾随逗号、镜头编号连续、导演必入镜元素已分配等。
安装与启用¶
SkillHub 推荐两种方式：用 CLI 安装到当前 Agent 的 skills 目录，或把安装提示词发给 AI 按官方文档操作。
1、安装 SkillHub CLI（若尚未安装）¶
command -v skillhub && skillhub --version
未安装时可执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装本 Skill¶
安装时必须用 --dir 指向当前 Agent 识别的 skills 目录，否则默认落在 ./skills/ 可能无法被加载。官方文档给出的常见路径如下：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
安装命令示例（命名空间为发布者 ihangfeng）：
skillhub install hf-drama-storyboard-script --namespace ihangfeng --dir ~/.cursor/skills/
将 ~/.cursor/skills/ 换成你当前客户端对应路径即可。商店页亦提供自然语言安装提示：请根据 https://skillhub.cn/install/skillhub.md，安装 @ihangfeng/hf-drama-storyboard-script。
安装完成后按各客户端要求刷新或重启 Agent，使 Skill 生效。
典型用法¶
在对话中引用 Skill 后，粘贴剧集内容与导演视觉说明，要求按规范输出 JSON。Skill 包内 agents/openai.yaml 给出的默认提示可作为起点：
使用 $hf-drama-storyboard-script 根据剧集内容和导演视觉建议，生成严格 JSON 格式的短剧文字分镜脚本。
实操时可按下面结构组织输入（内容为示例格式，需替换为你的真实剧本与导演 brief）：
【剧集内容】
场景：办公室夜戏。女主发现合同被换页，男主进门对峙……
（附台词与动作）
【视觉呈现】
情绪曲线：压抑 → 爆发 → 冷寂收尾
视觉锚点：红色印章特写、窗外霓虹
必须入镜：合同页角折痕、女主手背青筋
色彩：冷蓝环境 + 暖色台灯面光
特效：合同文字微距高光，无魔幻元素
请输出完整文字分镜 JSON，字段名与 SKILL 要求一致。
注意：Skill 规定 不要复述分析过程，不要输出 Markdown；模型应直接返回可被标准解析器读取的 JSON 对象。
适用场景与注意¶
适合谁
- 短剧 / 漫剧 / 竖屏剧 / 信息流剧的前期：编剧、导演、制片需要快速把剧本拆成可沟通的分镜表。
- 需要把「卖点镜头」和剪辑节奏写进结构化数据，方便后续剪辑脚本、宣发打标签或自动化流水线消费 JSON 的团队。
使用注意
- 输出质量依赖输入剧本与导演 brief 的完整度；视觉字段缺失时会推定，但推定范围受 Skill 约束，不能改剧情因果。
- 本 Skill 交付的是 文字分镜 + JSON schema，不包含分镜图绘制或自动成片；摄影、灯光、演员走位仍需现场调整。
- 若 Agent 仍用 Markdown 或代码围栏包裹 JSON，可在提示中再次强调「仅输出 JSON、无代码块」，并对照 Skill 内「质量检查」清单要求重试。
- 下载量、评分来自 SkillHub 页面展示，会随时间变化；以商店页为准。
结尾¶
短剧文字分镜脚本 把剧本与导演视觉要求收敛为统一的逐镜头 JSON，减少分镜表反复手改的成本，并显式保留卖点标签与来源依据，便于拍摄与后期对齐。需要安装或查看说明时，可打开官方地址：https://www.skillhub.cn/skills/ihangfeng/hf-drama-storyboard-script，资源坐标为 @ihangfeng/hf-drama-storyboard-script。
