shuohao-skills 快速入门

这是什么？适合谁？

shuohao-skills 是AI 短剧制作的完整 skill 链：从一本小说到直接喂生成管线的制作素材——拆角色、排大纲、出场景与道具设定、写剧本、切分镜。给 AI 编码 agent 用，Claude Code 和 Codex 都能跑。整条管线的核心设计：改编大纲收敛结构，剧本、场景、角色三者同步迭代，分镜只做输出不做新决定。每个 skill 都带脚本化质量门（13/11/10/16 道不等），报告支持中英双语。

适合人群：AI 短剧创作者与工作室、网文改编短视频的从业者、研究”AI 内容工业化管线”的创作者、Claude Code / Codex 用户。 使用前提：Claude Code 或 Codex、一部待改编的小说文本、（出图环节）图像生成工具。

快速上手（3 步）

第一步：安装 skill 集

git clone https://github.com/eternityspring/shuohao-skills
# 将 skills/ 下的五个 skill 装入 Claude Code / Codex 的 skills 目录

五个 skill：novel-characters（角色）、novel-outline（大纲）、novel-art（美术）、novel-script（剧本）、novel-storyboard（分镜）。

第二步：从大纲开始

给 novel-outline 喂小说文本，产出短剧大纲五件套：改编说明、人物表、爽点表、分集梗概、资产清单——13 道质量门全部脚本检查，支持对已有大纲做”体检模式”。

第三步：走完管线

大纲 → novel-characters 拆角色设定集（人物画像/形象提示词/音色提示词/角色设定图）→ novel-art 出美术设定集（场景+叙事道具，11 道质量门）→ novel-script 写剧本（场次+节拍流，10 道质量门）→ novel-storyboard 切分镜（16 道质量门，段≤15 秒、分镜 2–5 秒硬门）。

初级用法

• 五个 skill 各司其职：也可以只用其中一环（例如只用 novel-script 把已有设定写成剧本）。
• 质量门即反馈：每道质量门是脚本化检查，不过门就打回重改——不是”AI 自评”，是确定性校验。
• 双语报告：五个 skill 的报告都支持中英双语界面，默认中文。

高级玩法

1. 完整投产管线：novel-storyboard 的分镜图拿设定图当参考图真出图，export 一键出投产包——从小说到可交付素材一条龙。
2. TTS 对接：novel-script 的台词本按角色聚合、带音色提示词，直接对接 TTS 生成配音。
3. 体检模式复用：把已有人工大纲丢给 novel-outline 的体检模式，13 道质量门帮你找出结构漏洞。

常见踩坑（5 条）

踩坑 1：跳过大纲直接写剧本

• 现象：剧本散架、角色漂移
• 原因：管线设计是”大纲收敛结构”——大纲是后续一切的锚
• 解决：严格按 outline → characters/art → script → storyboard 顺序

踩坑 2：分镜环节想改剧情

• 现象：分镜阶段反复推翻剧本
• 原因：设计原则”分镜只做输出不做新决定”
• 解决：改动回到 script 层做，分镜层保持纯输出

踩坑 3：质量门报错看不懂

• 现象：16 道门不知道挂了哪道
• 原因：输出信息量大
• 解决：从第一道失败门开始修，后面的失败常是连锁

踩坑 4：长篇小说一次喂入

• 现象：大纲五件套质量下降
• 原因：超长文本稀释注意力
• 解决：按卷/章分段处理，先做分册大纲再合并

踩坑 5：出图风格不统一

• 现象：角色设定图与分镜图风格脱节
• 原因：没用设定图当参考图
• 解决：novel-storyboard 生成时显式携带 novel-art 的设定图作为参考

FAQ（5 个常见问题）

Q1：shuohao-skills 免费吗？ A：Apache-2.0 开源免费；实际成本是 Claude Code / Codex 的订阅与出图工具费用。

Q2：必须五个 skill 全用吗？ A：不——各 skill 独立可用，按需取用；完整管线效果最佳。

Q3：支持哪些 agent？ A：Claude Code 和 Codex 均可运行（README 明确声明）。

Q4：分镜时长怎么控制？ A：novel-storyboard 内置硬门：段（一次生成 ≤15 秒）→ 分镜（2–5 秒硬门）→ 分镜图（主图钉 0.00 秒、子图钉各自切点），逐字对账切点时刻。

Q5：能做非短剧内容吗？ A：管线针对短剧叙事优化；广告、MV 等短内容可借鉴结构但需自行调整。

小技巧（5 条）

1. 先跑体检模式：有旧大纲先过 13 道门，了解自己的起点。
2. 爽点表当节奏地图：novel-outline 的爽点表就是逐集钩子清单，投放策略围绕它排。
3. 音色提示词早定：角色设定集里的音色提示词直接决定 TTS 效果，早锁定早试听。
4. 资产清单管预算：大纲五件套里的资产清单就是出图/建模的工单，按它控成本。
5. 双语报告做交付：出海项目直接用英文报告交付海外团队。

进阶学习建议

• 研究”剧本、场景、角色三者同步迭代”的实现机制，理解多 skill 协作的状态管理
• 逐个拆解 13/11/10/16 道质量门的脚本实现，学习”确定性质量门”的内容工程化
• 用 MiniMax H3 提示词对齐机制（storyboard 内置）对接你的视频生成管线
• 把”大纲收敛结构、分镜只输出”的分层决策原则迁移到任何多阶段内容流水线

参考链接

• shuohao-skills GitHub 仓库

本文基于公开资料于 2026-08-17 整理，社区指标反映 GitHub 公开数据。独立实测未进行，功能和配置项可能随版本更新而变化，请以官方文档为准。