shuohao-skills 开源：AI 短剧工业化技能包，52 道代码级质量门把坑全部堵死

最近 AI 短剧圈子里出了个让人眼前一亮的开源项目。
说起来，做 AI 短剧的朋友大概都有过这种体验：好不容易写完剧本，结果角色形象前后不一致，分镜切得乱七八糟，提示词写了半天视频模型还是不按套路出牌，到最后花在调错上的时间比创作还多。
更头疼的是，这些流程全靠经验撑着，换个人来做又是另一套打法，质量根本没法稳定输出。
直到我最近在X上刷到了shuohao-skills这个项目——一个刚上线不久就拿到1900+ Star的AI短剧制作技能包。

它不是那种又大又全的SaaS平台，也不是什么需要复杂部署的系统，而是一套给Claude Code和Codex这类AI编码助手用的"插件"。
丢一本小说进去，它能从改编大纲开始，一路给你拆角色、出美术设定、写剧本、切分镜，最后输出的东西能直接喂给 Seedance、MiniMax H3这类视频模型生成，中间每一步都有代码级的质量检查，根本不给模型"自由发挥"搞砸的机会。

项目简介

简单来说，shuohao-skills是一套AI短剧制作的完整技能集合，它把从小说到可投产素材的整个流程，拆成了五个各司其职的skill模块：

这意味着前面的环节如果没拍板，后面根本不会往下走——从流程上就避免了"返工"这件事。
最绝的是，五个skill的报告还能合成一张单页HTML，左侧导航切换，数字键1-5直接切面板，Cmd+F还能全局搜索。不管是自己审还是给客户看，双击打开就能用，连服务器都不用部署。

核心亮点

质量门用代码写，不靠模型自觉

每一道质量门都是确定性的代码检查，不是给模型读的文字提示。
•novel-outline有14道质量门：主角组必须≤5人、爽点间隔不能超过3集、第1集必须有钩子、大爆点不能压最后一集……

•novel-art有11道质量门

•novel-script有10道质量门

•novel-storyboard有17道质量门，甚至连H3提示词的对齐指令和切点时刻都会逐字对账

每道门都有"击穿用例"——证明它真的会拦，不是永远为真的假测试。改了分镜秒数忘改提示词？当场拦下。提示词里混进了中文没按设定来？直接报错。这种"不信任模型"的设计哲学，恰恰是做稳定生产的关键。

零依赖，安装简单到离谱

整个项目只用Node.js标准库，没有任何npm依赖，连npm install都不需要跑。
安装就是三行命令：

git clone https://github.com/eternityspring/shuohao-skills.git
cd shuohao-skills
./scripts/install.sh

脚本会自动检测你装了Claude Code还是Codex，把所有skill软链过去——以后git pull更新完立刻生效，连重装都不用。不想用脚本就自己手动软链也行，就一行ln命令的事。

真·端到端，分镜直接能投产

很多所谓的"AI短剧工具"停留在剧本或者简单分镜层面，shuohao-skills是真的做到了最后一公里。
拿novel-storyboard举例，它的结构完全是按视频生成的规律设计的：
•段（segment）：一次视频生成调用，≤15秒，不跨场次
•分镜（cut）：段内剪切，每切2-5秒（硬门，短剧观众注意力节奏就是3秒左右）
•分镜图：每切一张关键帧，主图钉0.00秒，子图钉各自切点
•H3提示词：一段一条，多图对齐指令和切点时刻自动推导，逐字对账
两人对话的正反打？在一段里一次生成，全景、A近景、B近景各是一个2-5秒的分镜，每格构图由自己的分镜图控制，不靠文字赌。
分镜图不是凭空画的，是拿novel-art和novel-characters出的设定图当参考图合成的——前面做的资产在这一步真正被消费了。

中英双语，离线可用，细节拉满

• 五个skill的报告全部支持中英双语界面，render --lang en就出全英文报告
• 所有报告都是内联SVG/CSS，零外部依赖，离线双击就能开
• 剧本里每句台词的时长是按语速算出来的，不是让模型估的
• 分镜的运镜词直接用MiniMax H3官方词表（Push In、Pan Left、Tracking Shot…），不瞎写
• 连台词怎么放进提示词都按官方规定来：<d>[Chinese] …</d>逐字保留原文
这些细节单独看好像没什么，但凑到一起你就知道——作者是真的拿着这些东西去生成过视频，踩过所有坑，然后把坑都填在了代码里。

管线怎么跑？

整个流程走下来大概是这样的：
第一步：改编大纲（novel-outline）
丢小说进去，先出快版骨架给你拍板：砍了哪条线、合了哪些人、大爆点在第几集。点头之后才允许写分集梗概，而且分集是分批写，每批≤10集——60集一口气写后半段必崩。
产出的大纲报告特别专业：KPI带开门见山，爽点节奏用时间轴标出来，空档直接标红，每集三栏卡片（梗概+钩子+悬念），还有每集调度矩阵——谁出场、在哪拍，一列竖着读就是需求单。
对了，它还有个"体检模式"，你已有大纲想诊断问题，直接跑checkup就行，质量门面板就是诊断书。
第二步：角色设定（novel-characters）
照着outline.json定下的角色清单做，不用再判断一遍谁轻谁重。角色分三档管理：主角组出全套设定图，重要配角出半身参考，功能性角色（医生、店员这种占脸不占名的）提示词直出——毕竟每一档的一致性投入完全不同，没必要给路人甲也做全套。
第三步：美术设定（novel-art）
出场景和叙事道具的设定集，带一致性锚点、光照与状态变体、尺度参照，还有无人无手的白底提示词——懂的都知道，手和多人场景是AI生成的重灾区，人家直接从提示词层面就规避了。
第四步：剧本写作（novel-script）
按场次+节拍流写，动作和台词交替，逐集时长按语速确定性折算。钩子前3拍冷开场兑现是硬门，台词本按角色聚合还带音色提示词，直接对接TTS不用再整理。
第五步：分镜制作（novel-storyboard）
这是管线最后一环，也是最见功力的一环。节拍全覆盖（剧本每个节拍被恰好一个分镜认领）、每切2-5秒硬门、台词装得下（逐切检查台词秒数≤分镜秒数）、同框≤3人……17道质量门把所有能想到的坑都堵了。
最后export出来的投产包，真的是拿去就能生成视频。

快速上手

安装

git clone https://github.com/eternityspring/shuohao-skills.git
cd shuohao-skills
./scripts/install.sh

如果只想装某一个skill：

./scripts/install.sh novel-characters

想装到codex：

./scripts/install.sh --codex

卸载也简单：

./scripts/install.sh --uninstall

手动安装（不想用脚本）

ln -s "$PWD/skills/novel-characters" ~/.claude/skills/novel-characters
ln -s "$PWD/skills/novel-characters" ~/.codex/skills/novel-characters

写在最后

这段时间看了太多 AI 短剧工具，要么是套壳的SaaS把简单问题复杂化，要么是一堆提示词拼凑起来的"工作流"，换个模型就不好使。
shuohao-skills 给我的感觉完全不一样。
更难得的是，这是个真正"可复制"的流水线。以前做AI短剧，质量全靠核心成员的经验，新人进来要踩半年坑才能上手。
现在有了这套东西，把规则写进代码里，新人照着流程走，产出质量不会差到哪去。
项目地址在这里：
https://github.com/eternityspring/shuohao-skills