从小说到可拍摄素材:AI 短剧制作技能全家桶 shuohao-skills 拆解
- 2026-11-14 18:49:48

摘要:shuohao-skills 是一套 Agent 无关的 AI 短剧制作技能集:把一部小说加工成能直接开拍的素材——人物小传、改编大纲、场景与道具设定、剧本、分镜。每个技能自带 SKILL.md 与配套脚本,可跑在 Claude Code、Codex 等任何支持 SKILL.md 的 Agent 上,且已在真实 AI 短剧生产中被反复使用。
项目介绍:它是什么
shuohao-skills 官方定位一句话:AI 短剧制作技能全家桶——把一部小说加工成能直接开拍的素材:人物小传、改编大纲、场景与道具设定、剧本、分镜。
值得关注,因为它把 AI 短剧链路拆成可单独重跑的技能而非黑箱一键工具。五个管线技能加 character-refs 各自自带 SKILL.md 与零依赖脚本,Claude Code、Codex 等任意支持 SKILL.md 的 Agent 都能跑,且已在真实短剧生产里反复验证。Apache 2.0,Node ≥18,无需 npm 安装。
它的关键属性是Agent 无关:每个技能自带 SKILL.md 与配套脚本,任何支持 SKILL.md 的 Agent 都能跑(Claude Code、Codex 等)。而且作者明确说明它已在真实 AI 短剧生产中被反复使用——不是演示级技能。
Agent 无关的短剧制作技能集:小说进来,可拍摄素材出去。

▲ ReelBench 工作台首屏
功能特性:一份小说进,五份可拍素材出——Agent 无关
shuohao-skills 的定位是「AI 短剧制作技能全家桶」:把一部小说加工成能直接开拍的素材——人物小传、改编大纲、场景与道具设定、剧本、分镜。它的关键属性是 Agent 无关:每个技能自带 SKILL.md 与配套脚本,Claude Code、Codex 等任意支持 SKILL.md 的 Agent 都能跑,且已在真实 AI 短剧生产中被反复使用——不是演示级技能。
核心能力一览
1. 角色圣经:把人物拆成可执行的设定文档——把小说人物拆成可引用的设定文档,后续生成不跑偏
2. 改编大纲:先定故事怎么取舍——小说改短剧先收敛叙事结构,解决「改什么、砍什么」
3. 场景与道具圣经:给视觉资产统一基准——场景 / 道具设定生成,跨镜头不飘、不串味
4. 剧本与分镜:文字工作做到「能开拍」——写剧本、切分镜,形成可执行稿,到此为止
5. 管线协同:五技能一条线,管住节奏纪律——段 ≤15 秒、2-5 秒硬门禁、18 个质量门禁脚本化
下面按能力逐个拆开看:
角色圣经:把人物拆成可执行的设定文档
novel-characters 把大纲定下的人物扩展成角色圣经:人物小传(profiles)、设计提示词、音色提示词(voice prompts)与造型表(model sheets)一应俱全。它从 outline.json 播种名单,报告语言可配置,但默认可中文 UI;即便源小说是英文,产出的也是中文人物档案。
一个硬约束值得注意:该技能的校验器会主动拒绝中文档案字段里出现英文——这逼着人物设定在中文创作链路里保持纯净。配合下游分镜与剧本,角色一旦定稿,后续引用的是同一份定义,不会跨集「变脸」。

▲ 角色圣经:人物拆成可执行的设定
拆人物、立人设。把小说里的人物拆成可执行的设定文档,供后续生成引用。
改编大纲:先定故事怎么取舍
novel-outline 把一部小说改成五件式短剧大纲:改编说明、演员表、情节节拍(beats)、逐集梗概,以及含叙事道具表的资产清单。它先把叙事结构收敛定稿,再往下游喂素材,避免剧本、角色、场景各写各的。
质量靠脚本而非人眼:14 个质量门禁全部由脚本检查,还提供 checkup 模式给已有大纲做体检。整条链路上,大纲是第一个也是最关键的交付物——结构定错,后面生成得再漂亮也救不回来。

▲ 改编大纲:先定故事怎么取舍
收敛叙事结构。小说改短剧,先解决「故事怎么取舍」的问题。
场景与道具圣经:给视觉资产统一基准
novel-art 产出美术圣经(场景 + 叙事道具):一致性锚点、光照与状态变体、比例参考,以及无人物 / 无手的白底图(white plates)。它同样从 outline.json 播种,确保场景与道具定义和上一阶段的大纲同源。
10 个质量门禁脚本化检查,保证视觉资产有统一的文字基准。对 AI 生图来说,这一步是「同一个人换个镜头不变形」的底气:分镜引用的是定义好的资产,不是每次重新描述。

▲ 场景与道具圣经:视觉资产统一基准
场景 / 道具设定生成,让视觉资产有统一的文字基准。
剧本与分镜:文字工作做到「能开拍」
novel-script 写 AI 短剧剧本:行动节拍与对白交替的节拍流(beat flow),单集时长按阅读速度确定性估算,前三拍有冷开场钩子的门禁,还产出按角色分线的台词本(line book),直接喂给 TTS。novel-storyboard 把镜头切成段(一次生成 ≤15s)→ 切(2-5s 硬门禁)→ 关键帧(主帧钉在 0.00s、子帧钉在切点)。
两段文字工作合计 28 个质量门禁(10+18)全部脚本检查:MiniMax H3 提示词对齐、切点时间逐字审计。文字层把能定死的都定死,才轮到生图生视频——这也是它敢说「做到能开拍」的原因。

▲ 剧本与分镜:文字做到能开拍
写剧本、切分镜,形成可执行稿。文字工作到「能开拍」为止。
管线协同:五技能一条线,管住节奏纪律
五个技能可合并成单页带左侧导航的报告:node scripts/report.mjs 是个组装器(assembler),不引入技能代码,只各自调每个技能的 render --html 再缝合。每个技能自带 SKILL.md + scripts/selftest.mjs(从不调模型、不耗额度),可单独跑、可单独拷贝。
合并要解三类污染:57 个类名里 13 个语义歧义需加作用域前缀;每个报告的脚本做范围代理包裹避免互相踩踏;相对资源路径按输出文件重定基。report-selftest.mjs 有 92 条断言、无需浏览器即可验证。这正是「五技能一条线、不是五个孤立工具」的工程体现。

▲ 管线协同:五技能一条线
大纲收敛结构,剧本 / 场景 / 角色迭代,分镜收口——五个技能是一条管线,不是五个孤立工具。
它管的是 AI 短剧最要命的「节奏纪律」:段(一次生成 ≤15 秒)→ 切(2-5 秒硬门禁)→ 关键帧(主帧钉在 0.00 秒、子帧钉在切点)。MiniMax H3 提示词对齐、切点时间逐字审计,18 个质量门禁全部脚本化检查,不靠人眼把关。

▲ AI 短剧生产流水线

▲ 改编大纲报告
技术架构拆解:SKILL.md 驱动、Agent 无关的技能管线
shuohao-skills 不是单体应用,而是一组遵循 SKILL.md 规范的技能:每个技能自带 SKILL.md 与配套脚本,由支持该规范的 Agent(Claude Code、Codex 等)加载执行。底层是纯 Node 标准库、零第三方依赖,并自带不调模型的自检脚本。先看拓扑,再逐层拆:

▲ shuohao-skills 系统拓扑:Agent 加载 SKILL.md → 五技能文本管线 → 产出可拍素材,纯 Node 零依赖
工程底子很轻:每个技能目录自包含(SKILL.md 与 scripts/selftest.mjs 必需,且 selftest 绝不调模型),仅用 Node 标准库、零 npm 依赖。node scripts/report.mjs 按目录约定自动发现五个 json 并合并;只跑了某技能就只出对应面板。自检约一秒、无 CI;Apache 2.0,仅 macOS + Node 24 实测。
架构要点一览
1. Agent 无关——SKILL.md 是统一协议:Claude Code / Codex / 任意支持它的 Agent 都能跑,不锁定平台
2. 零依赖运行时——Node ≥18 纯标准库实现,没有 npm 包要装,clone 下来就能跑
3. 工程化自检——每个 skill 自带 selftest.mjs,不调模型、不耗额度,本地即可验证
4. 一键安装——install.sh 软链全部技能到 Claude Code / Codex,git pull 后免重装
5. 质量门禁——18 个质量门禁脚本化检查:段 ≤15 秒、2-5 秒硬门禁、切点时间逐字审计
下面沿「Agent 宿主 → 技能内核 → 本地文件」逐层拆:
技能结构与运行宿主
零依赖与自检机制
安装与更新
安装使用:本地跑起来
按下面几步,把项目跑起来:
git pull 后无需重装即可生效;
▲ 快速上手关键步骤
纯 Node 标准库零依赖(Node ≥18),没有 npm 包要装。每个 skill 必须自带 selftest.mjs 且不调模型、不耗额度——仓库规范本身就很工程化。
其他 Agent 把技能目录软链进自己的 skills 目录即可。
案例:典型用法与适用场景
shuohao-skills 覆盖剧本落地前的全部文字工作,适合已经在用 Agent 做短剧、想把流程和质量管理起来的人。官方管线从一部小说一路加工到分镜稿,五份报告还能一键合并成一页总览。
典型用法:小说改编短剧的前置生产管线
1. 立角色圣经——跑 novel-characters 技能,把小说人物拆成可执行的设定文档,供后续生成稳定引用
2. 出改编大纲——跑 adaptation 技能收敛叙事结构,先定「故事怎么取舍」,再往下拆
3. 建场景道具圣经——生成场景 / 道具设定,给视觉资产一份统一文字基准,跨镜头不飘
4. 写剧本与分镜——写剧本、切分镜,形成「能开拍」的可执行稿,文字工作到此收口
5. 管线协同收口——大纲→角色→场景→剧本→分镜迭代,用 18 个质量门禁脚本化检查节奏纪律
6. 合并总览——五份报告一键合并成一页总览,每份独立可跳转,方便过审与返工
官方展示的完整前置生产管线,对应下面这张能力拆解图:
典型用法:小说改编短剧的前置生产管线
shuohao-skills 覆盖剧本落地前的全部文字工作,官方 README 展示的管线见下图:

▲ shuohao-skills 核心能力:角色圣经、改编大纲、场景道具圣经、剧本分镜、管线协同
适用场景:四类人用它最划算
结尾总结:什么情况值得用它
shuohao-skills 适合下面这些情况:
4.4k+ star、Apache-2.0——短剧制作的「文字段」本来就该被工具化,这套技能把这件事做成了全家桶。
要讲清边界:它产出「能开拍」的素材与脚本,不替你生图生视频——真正出片依赖你接的生图模型与额度。适合把短剧当连续产品做的团队:结构、角色、场景同源,跨集一致可复用。若只是偶尔玩一条视频,五技能的学习与编排成本要先算进去;想纯本地出图,character-refs 还需自配 ComfyUI 或 GPT Image 2。
如果这篇对你有用
这篇拆解如果帮你省下了踩坑时间:点个在看,让做 AI 短剧的朋友少走弯路;收藏这篇,五个技能的调用顺序都标好了;关注「AI深思智汇」,这个系列会把 25 个开源 AI 视频项目一个个拆到底,下一篇拆谁、什么时候发,关注后第一时间看到。你是让 Agent 直接干活,还是自己手动调?评论区聊聊。
文中所涉项目信息(版本、Star、功能与技术栈)均以 GitHub 仓库 eternityspring/shuohao-skills 公开 README 为准,截至 2026 年 10 月。项目为开源社区作品,使用前请自行评估依赖与合规;涉及声音克隆、视频复刻等能力时,请务必确认素材授权与平台规则。

▲ AI深思智汇 · 开源项目拆解系列