一整套 AI 短剧的 skill,终于有人把整条流程开源了
- 2026-11-19 04:01:13
shuohao-skills 是 GitHub 上一个开源项目,干的事一句话就能说完:把小说改编成 AI 短剧的前期流程,打包成六个 skill,装进 AI 编程工具里就能跑。
做 AI 短剧的朋友应该有体会,真正费时间的是前面一长串准备工作。小说要拆,大纲要排,角色长什么样、什么声线要定下来,剧本要一集一集卡时长,最后分镜还得几秒几秒地切。这些活儿碎,还省不掉。这个项目管的就是这串活儿,8 月初刚开源,现在已经有3.9k Star了。
这篇跟大家分享一下它具体能干什么,我翻完 README 和各个 skill 的文档,挑我觉得做得实在的地方说。
整体思路
整套设计一张图就能说明白:

小说原文进去,先出改编大纲,把故事结构收敛住。然后剧本、场景清单、角色设定这三块同步迭代,互相约束。最后才是分镜,分镜这一层只做输出,不再做新的创作决定。
作者把这条原则直接写进了 README,创作类工具最怕的就是每个环节都在偷偷改前面定好的东西。
六个 skill 里,五个串成这条管线,剩下一个 character-refs 是独立出图用的,后面单独说。
六个 skill 分别干什么
改编大纲(novel-outline)
丢一本小说进去,出来五件套:改编说明、人物表、爽点表、分集梗概、资产清单。改编跟从头写新故事不一样,得先决定砍哪条线、合并哪些人、爽点往哪放,这些都在大纲阶段定死。
这个阶段有 14 道质量门,全部是脚本检查,不靠模型自己觉得行。手里已经有大纲的话,还可以走体检模式,让它帮你把结构问题查一遍。

角色设定集(novel-characters)
大纲定下来的角色,这一步做成设定集:人物画像、形象提示词、音色提示词、角色设定图。它能直接读大纲阶段产出的文件,角色表自动预填,不用重新输一遍。
同一部剧里两个角色的提示词写得太像,脚本会算相似度,超过 0.75 就点名报错,告诉你是哪两个角色撞了。
这个阈值也不是随便定的,作者在代码注释里写了依据:自带样例里四个角色两两最高才 39%,而只改年龄和衣服颜色的雷同用例能到 98%,中间余量很大。作者应该是真拿它跑过东西。
音色提示词是双语的,可以直接拿去喂 Qwen3-TTS 或者 ElevenLabs 这类语音工具。

角色参考图(character-refs)
这是六个里面唯一真出图的,不归在管线里,随时可以单用,自己原创的角色也行。一段话描述角色,它拆字段、补全、跟你确认,然后先出一张正面全身锚点图,后面的大头照、侧面、背面、细节图全都只参考这张锚点来出,一个人物的多张图才不会长得不像同一个人。每张图带标识,可以单独重出。
出图方式四选一:自己部署的 ComfyUI、codex 内置出图、OpenAI 的 API、或者自定义命令,第一次用的时候选一种就行。

美术设定集(novel-art)
场景和叙事道具的设定集。每个场景有一致性锚点、不同光照和状态的变体、尺度参照,提示词统一要求无人无手白底。10 道质量门,同样全是脚本检查。
这一步产出的设定图后面会一直用。切分镜的时候,分镜图就是拿它当参考图出的,画面风格从头到尾不容易跑偏。

剧本(novel-script)
剧本按场次加节拍流来写,动作和台词交替。时长这块卡得很死:台词按语速折算成秒数,动作按节拍估,每集都要落在目标时长里,超了或者少了,报告里直接红字标出差多少秒,一眼就能看见。
开头钩子也是一道门,冷开场的前 3 拍必须把它兑现掉,过不了就打回。台词本按角色聚合成一份,带着音色提示词,可以直接对接 TTS 配音。

分镜和投产包(novel-storyboard)
这是最后一步。
一段最长 15 秒,一段里切成 2 到 5 秒一个分镜,这是硬门。分镜图的主图钉在 0.00 秒,子图各自钉在切点上,MiniMax H3 的提示词和切点时刻会逐字对账,改了秒数没同步改提示词,脚本直接拦住。这一段的质量门最多,18 道。
全部弄完 export 一下,出 H3 或者 Seedance 的投产包,每段一个文件夹,提示词和分镜图都在里面,拿去喂视频生成管线就行。

五份报告还能合成一页
跑完管线会一段一份 HTML 报告。仓库里有个组装脚本,能把这些报告合成一张单页,左边导航切换,跑到哪段就有哪段的面板,只跑了一段也不报错。
作者在 README 里讲了合并时处理的三件事:样式串味、脚本串味、图片路径,全部在组装器里做,五个 skill 本身一行不用改。每个 skill 都是自包含的,看中哪个可以单独拷走用。
安装这块
本机已经在用 Claude Code 或者 codex 的话,装起来很简单。我装的时候就是克隆仓库然后跑一条脚本:
git clone https://github.com/eternityspring/shuohao-skills.gitcd shuohao-skills./scripts/install.sh脚本会自己检测本机装的是哪个,把所有 skill 软链过去。以后 git pull 更新立刻生效,不用重装。只想装某一个也行,把 skill 名字加在命令后面就可以。
前置要求不多:Node 18 以上,脚本只用标准库,没有 npm 依赖。跑 skill 用的是当前会话的额度,不需要额外配 API key。只有 character-refs 出图那一步要选一个出图方式。
几个要注意的点
这套东西到分镜投产包为止,不直接出成片。它管的是文本和分镜的约束,最后视频的质量还要看后面的生成和制作环节。
作者写明了只在 macOS 加 Node 24 上验过。代码本身没有平台相关的调用,Linux 和更低版本的 Node 理论上也能跑,但没实际验过,真碰到了问题可以去仓库提 issue。
报告默认中文,管线各段的报告都能切英文界面,角色相关的报告还内置了日文。
最后说两句
这个项目最值得说的是,它把检查单独拎出来做了。能检查的东西基本都落到脚本里,时长、提示词相似度、切点对账,全是脚本在查,不靠模型自觉。AI 写东西经常写完没人核,这套 skill 就给每一环配了自动检查,查不过就回去改。
片子最后好不好看,这个 Skill 发挥的作用不大,那是视频模型的活儿。如果你本来就在折腾 AI 短剧,前期这些碎活儿按流程走一遍,能省不少时间。项目文档写得很细,每个 skill 都有给人看的 README 和自带样例,想上手的直接从大纲那段开始跑就行。
开源地址
https://github.com/eternityspring/shuohao-skills