开源工具评测：shuohao-skills——一本小说一键跑成AI短剧的Skill流水线

你有没有想过，把一本动辄几十万字的小说，变成能直接投产的 AI 短剧素材，到底要干多少活？

光前期就有五件头疼事：角色拆不清——人物、关系、别名、形象、音色散落各处；大纲不会改——怎么砍线、合人、排爽点全靠经验；美术定不住——场景、道具、打光不一致，一集一穿帮；剧本难生产——场次、节拍、钩子、时长没人帮你结构化成可执行格式；分镜连不上——镜头切点一错，整段画面就断层。

传统做法要么全手动，一集短剧前期筹备就能耗掉你大半天；要么用一堆零散的 AI 工具来回拼装，角色反复变脸、镜头频繁穿帮，量一上来直接崩。

今天要聊的 shuohao-skills（说好 skills）就是冲着这件事来的：它把整条「小说 → 短剧前期素材」的工业化流程，拆成 6 个可独立接力、可验证、可投产的 Skill，直接在 Claude Code 或 Codex 里跑，零依赖、不花额外的 API Key。一句话概括：丢一本小说进去，自动跑完拆角色、排大纲、出美术、写剧本、切分镜的全流程。

📸 配图建议： 封面对比图：左侧传统做法的混乱场景（散落的文档、变脸的角色、断裂的分镜），右侧 shuohao-skills 自动化的整洁流程线，中间一条箭头贯穿，深色科技风，扁平插画，16:9。

一、项目是什么

• 项目名：shuohao-skills（说好 skills）
• 作者：eternityspring（社区昵称 @烁皓）
• 开源协议：Apache-2.0
• 技术栈：JavaScript，零 npm 依赖，要求 Node ≥ 18
• Star：约 3.9k，近期加速增长中
• 运行环境：Claude Code / Codex 等支持 Skills 的 AI Agent
• 核心能力一句话：把小说文本一键转化为可直接喂给生成管线的短剧前期制作素材包

它不是造了一个独立 App，而是把 Agent 本身当成运行时——每个 Skill 就是一个带 SKILL.md 的目录，配一组零依赖的确定性校验脚本，再加一个 selftest.mjs 自测。本质上是把一套影视工作室的前期工作流，伪装成了一堆文档。

整体管线是这样收敛的：改编大纲收敛结构 → 剧本、场景、角色三者同步迭代（无先后）→ 分镜只做输出、不做新决定 → 批量生成；试生成一旦失败，就批次补资产，攒够一批再做。

Skill	干什么	质量门
novel-outline	小说 → 短剧大纲五件套：改编说明、人物表、爽点表、分集梗概、资产清单（含叙事道具表），支持已有大纲体检模式	14 道脚本检查
novel-characters	大纲角色 → 角色设定集：人物画像、形象提示词、音色提示词、设定图；吃 outline.json 预填角色表，报告语言可选	—
character-refs	给任何角色真出参考图（不限小说，自己原创也行）：一段话描述 → 正面全身锚点 → 大头照/90°侧面/背面/细节图，每张带标识、可单独重出	—
novel-art	美术设定集（场景 + 叙事道具）：一致性锚点、光照与状态变体、尺度参照、无人无手白底提示词	10 道脚本检查
novel-script	写可生产剧本：场次 + 节拍流（动作与台词交替），逐集时长按语速确定性折算，钩子前 3 拍冷开场，台词本按角色聚合可直接对接 TTS	10 道脚本检查
novel-storyboard	出分镜：段（≤15 秒）→ 分镜（2–5 秒硬门）→ 分镜图（主图钉 0.00 秒），MiniMax H3 提示词逐字对账，export 一键出 H3 / Seedance 投产包	18 道脚本检查

📸 配图建议： GitHub 仓库/项目界面示意图：模拟仓库页展示项目名 shuohao-skills、作者 eternityspring、约 3.9k Star、README、安装命令与 Skill 目录结构，深色科技风，高保真界面模拟，16:9。

二、为什么推荐它

如果你的工作是做 AI 短剧 / 漫剧、网文改编、或者想批量生产短视频剧情内容，这套东西几乎是为你的场景量身定做的：

1. 真正解决「穿帮」和「量产」两大行业死穴。角色一致性靠 character-refs 的锚点参考图锁定，场景、道具一致性靠 novel-art 的一致性锚点，镜头连贯靠 novel-storyboard 的切点逐字对账——这正是单人小团队做连载剧最痛的两件事。
2. 每一步都有独立产物，可接力可回滚。拆角色、排大纲、出美术、写剧本、切分镜，中间产物全是结构化文件，你可以随时停、随时改、随时接续，不会一锅粥。
3. 质量门全部脚本化、确定性校验。52 道质量门不是靠 LLM 口头检查，而是跑在零依赖 Node 脚本里，selftest.mjs 不调模型、不花额度，几毫秒就能验证逻辑对不对。
4. 零门槛上手。没有 npm install 一堆依赖的噩梦、不用配 API Key、不连外部服务，只要你有 Claude Code 或 Codex，克隆 + 一条命令就装好。

一句话：它把「短剧前期制作」从一个需要经验的黑盒，变成了一套可复制、可校验、可量产的流水线。

📸 配图建议： 核心优势信息图：3 列图标+标题+说明，突出「零依赖零成本」「脚本化质量门」「全流程可接力」三大差异化优势，深色科技风，扁平插画，16:9。

三、核心优势对比

把它和「纯手动改小说」以及几类常见 AI 短剧工具放一起看，差异更明显：

维度	shuohao-skills	纯手动改编	独立漫剧 App（如 ArcReel / Toonflow 类）
核心方式	Agent 内 6 个 Skill 串联	靠人力和经验	独立工作台/网页
安装成本	git clone + install.sh	无	需部署/注册
是否需要 API Key	不需要（复用会话额度）	不适用	多数需要
是否本地运行	是（在 Claude Code/Codex 里）	是	视产品而定
数据隐私	素材留在你的会话/项目里	手动	部分在云端
质量保障	52 道确定性脚本质量门	靠自觉	部分有，多为提示词层
输出格式	character/outline/art/script/storyboard 结构化素材	散乱	平台内格式
价格	免费（Apache-2.0）	时间成本	部分订阅/付费
自定义能力	高度可改（全是目录+脚本）	全自定义	受平台限制

看完表，它的差异化亮点其实就三条：

1. Agent 即运行时——没有独立 App，复用你手头的 Claude Code/Codex，思维链和工作流长在一个地方。
2. 确定性质量门——52 道检查是脚本算出来的，不是大模型「觉得行」，可复现、可验证。
3. 自由组装——6 个 Skill 既可以整条跑，也能单独挑一个用（比如只出角色参考图），还能喂给不同生成管线。

📸 配图建议： 运行效果/终端界面图：模拟在 Claude Code/Codex 终端里运行 install.sh 安装、调用某个 Skill 生成报告的界面，展示命令执行与结构化输出，深色科技风，高保真终端模拟，16:9。

四、手把手实操教程

1. 环境准备

• 硬性要求：本机装了 Claude Code 或 Codex CLI；Node 版本 ≥ 18（作者实测 macOS + Node 24，Linux 理论兼容）。
• 好消息：不需要任何 API Key、不需要 npm install 装依赖、不连外部服务——所有校验脚本都是 Node 标准库。

2. 第一步：安装

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

install.sh 会自动检测你装的是 Claude Code 还是 codex，把 6 个 Skill 全部软链到对应技能目录。之后 git pull 更新立刻生效，不用重装。

想验证装没装对？每个 Skill 目录下都有 selftest.mjs，直接 node selftest.mjs 跑一遍，不调模型、不花额度，几毫秒出结果。

3. 第二步：基础用法——跑通整条管线

装好后，在 Claude Code / Codex 里丢进一本小说（或一段原创剧情），按序触发：

1. novel-outline：先生成短剧大纲五件套（改编说明 / 人物表 / 爽点表 / 分集梗概 / 资产清单），输出 outline.json。
2. novel-characters：基于 outline.json 预填角色表，产出角色设定集（人物画像、形象提示词、音色提示词）。
3. novel-art：生成美术设定集（场景 + 叙事道具），含一致性锚点、光照变体、无人无手白底提示词。
4. novel-script：把结构写成可生产剧本——场次 + 节拍流，台词按角色聚合，直接对接 TTS。
5. novel-storyboard：最后切成可生成分镜包，export 一键出 H3 / Seedance 投产包。

4. 第三步：进阶用法

• 角色真出参考图：character-refs 一段话描述角色 → 先出正面全身锚点 → 大头照/90°侧面/背面/细节图都只参考这张锚点，可单独重出。支持 Qwen Image（ComfyUI）、codex 出图、GPT Image 2 API、自定义命令。
• 已有大纲体检：novel-outline 支持「体检模式」，拿你手头现成的大纲进去，14 道门帮你查结构问题。
• 中英双语报告：默认中文，render --lang en 一键出全英文；character-refs 还内置中英日界面。
• 失败补资产：试生成失败就批次补资产，攒够一批再做，不浪费轮次。

5. 常用命令/参数速查表

操作	命令 / 动作
克隆仓库	git clone https://github.com/eternityspring/shuohao-skills.git
安装	cd shuohao-skills && ./scripts/install.sh
自测	任意 Skill 目录下 node selftest.mjs
更新	仓库内 git pull（软链立即生效）
英文报告	render --lang en
出投产包	novel-storyboard 内 export（H3 / Seedance）

📸 配图建议： 应用场景/工作台图：模拟一个短剧创作工作台界面，展示从小说输入到角色/美术/分镜的成果陈列（含人物设定图、场景道具、分镜列表），深色科技风，高保真界面模拟，16:9。

五、适用场景 & 落地案例

1. 网文改短剧的小团队 / 个人创作者：有小说、想做短剧号，用它从拆角色到切分镜全流程跑一遍，前期素材一次成型，省掉大量手工整理。
2. 连载剧批量生产：需要日更或多集联动的团队，靠 character-refs 锚点图 + novel-art 一致性锚点锁死画风，解决最头疼的穿帮和量产。
3. 原创 IP 的视觉资产搭建：不限于小说，你自己原创的故事角色也能用 character-refs 真出参考图，搭出人物形象、音色、三视图的资产库。
4. AI 短剧技术探索 / 教程作者：想研究「Skills 工程化」怎么落地的人，这套零依赖、带自测、质量门脚本化的实现本身就是一个极佳范本。

六、客观优劣总结

✅ 优势

• 零 npm 依赖、无需 API Key、不连外部服务，上手成本极低
• 6 个 Skill 覆盖小说→分镜全流程，每步独立产物、可接力可回滚
• 52 道确定性脚本质量门，可复现、可验证，不是「大模型觉得行」
• 自带 selftest.mjs，不花模型额度自测
• 中英双语（character-refs 还支持日文）报告
• 高度可自定义：全是目录 + 脚本，能自由改、单独用、接任意生成管线
• Apache-2.0 完全开源免费

⚠️ 局限性 / 注意事项

• 没有图形界面，是纯 Agent 侧工作流，不适合想要「点按钮」的用户
• 作者主要在 macOS + Node 24 实测，Linux / 旧版 Node 理论兼容但未充分验证
• 无 CI 管线，靠本地秒级自测兜底
• 美术设定图的生成依赖可选的 Codex CLI；没有的话只出文本指南
• 分镜目前针对性对接 MiniMax H3 / Seedance，其他模型要自己适配
• 中文圈信息较多，英文文档相对少，海外用户上手可能略费劲

⚠️ 安全提醒：虽然本工具不需要额外 API Key，但若你自己配置了 codex 出图等自定义命令或接入 API，请妥善保管密钥，不要把敏感配置提交进仓库或分享到公共群组。

七、总结

shuohao-skills 是那种「思路比功能更值钱」的开源项目。它没有造一个你必须迁移过去的封闭平台，而是把短剧前期制作拆成 6 个可验证、可接力、可量产的 Skill，直接塞进你手头的 Claude Code / Codex 里跑——零依赖、零额外成本、52 道脚本质量门兜底，专治 AI 短剧最头疼的穿帮和量产。

如果你正在做 AI 短剧、漫剧、网文改编，或者想研究 Skills 工程化的落地范本，它值得你 git clone 下来亲手跑一遍。

📌 项目地址：https://github.com/eternityspring/shuohao-skills

快速上手：

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

觉得有用就点个 Star，让更多人看到这套「小说一键跑成 AI 短剧」的工业级思路。