小说一键变 AI 短剧
shuohao-skills（eternityspring/shuohao-skills）是 AI 短剧制作的 Agent Skill 集合。它把「小说改编成短剧」的整条流程拆成多个自包含的 Skill：从一本小说出发，产出改编大纲、角色设定、美术设定、剧本、分镜等可直接喂给 AI 视频生成管线的投产素材包。Claude Code 和 Codex 都能跑，任何能读 SKILL.md 并运行 Node 脚本的 Agent 也能用。
核心设计：大纲先锁住人物线、爽点、场景和道具 → 角色、美术、剧本三者同步迭代 → staging 定每场开场 → 分镜只做收尾。整套通过同一份结构化数据保持上下游一致，避免各写各的；并用质量门层层拦截（大纲 14 道、美术 10 道、剧本 17 道等，脚本自动检查），如「主角不能超 5 人、爽点间隔不能超 3 集、分镜 2–5 秒」。它不是一键生成最终短剧，而是产出能继续投产的素材包。
版本与获取：实测 5,006 Star（691 fork，JavaScript，2026-08 创建、今天仍在更新），协议 Apache-2.0，配套 ReelBench AI Video Workspace（studio.reelbenchai.com）。
✨ 核心亮点
- 🧩 7 个 Skill：大纲/角色/角色参考图/美术/剧本/分镜调度/分镜
- ⛔ 质量门拦截：脚本自动检查，不合规直接报错阻断
- 🔗 上下游一致：同一份结构化数据贯穿全流程
- ⚡ 免 API Key：用会话 quota，Node 标准库零依赖
🧩 它能做什么、输出什么
| Skill | 产出 |
|---|---|
| novel-outline | 改编说明 + 人物表 + 爽点表 + 分集梗概 + 资产清单（含叙事道具表），14 道质量门 |
| novel-characters | 角色设定集：档案、设计 Prompt、音色 Prompt、模型表（中文优先） |
| character-refs | 实际生成角色参考图：正面全身锚点 + 头像/侧面/背面/细节各视角（可用 Qwen/GPT Image 2） |
| novel-art | 美术设定集：场景 + 叙事道具，一致性锚点、光照/状态变体，10 道质量门 |
| novel-script | 可生产剧本，17 道质量门 |
| novel-staging | 每场开场调度（staging），分镜前定位置 |
| novel-storyboard | 分镜包：开场分镜 → 视频生产素材 |
🖼️ 效果图与演示
以下为 shuohao-skills 两个 Skill 的真实产出报告截图（官方素材）。
🚀 上手步骤
最快路径：git clone + ./scripts/install.sh 一键装进 Claude Code/Codex，然后把一本小说丢给它，按 outline → characters → art → script → staging → storyboard 顺序产出。
① 安装（自动识别 Claude Code / Codex）
安装脚本会检测 Claude Code 和 Codex 并把每个 skill symlink 到位，git pull 后无需重装。
git clone https://github.com/eternityspring/shuohao-skills.git
cd shuohao-skills
./scripts/install.sh # 全部安装
# ./scripts/install.sh novel-characters # 只装一个
# ./scripts/install.sh --codex # 只装进 Codex② 手动安装到任意 Agent
不想用安装脚本也可以手动 symlink，或直接把 skill 目录复制到你的 skills 目录。
ln -s "$PWD/skills/novel-characters" ~/.claude/skills/novel-characters
ln -s "$PWD/skills/novel-characters" ~/.codex/skills/novel-characters③ 导入小说 → 跑流程
把小说丢给 Agent，按固定顺序执行。大纲先锁结构（选改编幅度：忠实/抽核/借壳，短剧九成选「抽核」），角色/美术/剧本同步迭代，staging 定开场，最后出分镜。
novel-outline → novel-characters → novel-art → novel-script → novel-staging → novel-storyboard
（character-refs 独立用，可生成任意故事角色参考图）④ 质量门与产出
每步有脚本级质量门，不合规直接报错阻断（主角不超 5 人、爽点间隔不超 3 集、分镜 2–5 秒等）；产出素材包可直接喂给 AI 视频生成管线。
🎯 典型应用场景
- 📕 小说改编短剧：从网文到可投产短剧素材
- 🎨 角色参考图：任意角色生成统一视角参考图
- 🎬 短剧分镜生产：开场分镜喂给视频生成管线
- 📋 短剧立项：改编说明+爽点表做立项评审
📈 与同类做法对比
| 做法 | 结果 |
|---|---|
| 纯 prompt 让 AI 写短剧 | 各环节各写各的，角色/美术/剧本不一致，无质量把关 |
| 一键出片工具（平台） | 固定流水线，难做小说级改编与分镜级控制 |
| shuohao-skills | 7 个 skill 成链，同一结构化数据保证上下游一致，脚本质量门层层拦截，产出可投产素材包 |
⚠️ 提醒：这是投产工作流，不是「一键生成最终成片」——它产出的是可供 AI 视频生成管线继续加工的大纲/角色/美术/剧本/分镜素材。改编剧本/角色/美术请尊重原著版权与平台规则；作者也开放远程协作/半合作邀约。
❓ 常见问题
Q：这能直接出最终短剧吗？
不能直接出成片。它是投产工作流：产出大纲、角色、美术、剧本、分镜等可继续投产的素材包，再交给 AI 视频生成管线（如 ComfyUI/视频模型）做成片。
Q：支持哪些 Agent？
任何能读 SKILL.md 并运行 Node 脚本的 Agent 都行；Claude Code 和 Codex 是已支持的两个例子，不绑定特定运行时。
Q：需要 API Key 吗？
不需要。skill 用你当前会话的模型额度，脚本只调 Node 标准库（零 npm 依赖）。只有 character-refs 生成参考图时需配一个图像模型。
Q：怎么装？
git clone + ./scripts/install.sh，自动检测 Claude Code/Codex 并 symlink（git pull 即生效）。其它 Agent 手动 symlink 或复制 skill 目录即可。
Q：质量门是什么？
每个 skill 带脚本级校验（大纲 14 道、美术 10 道、剧本 17 道等），不合规直接报错阻断，如主角不超 5 人、爽点间隔不超 3 集、分镜 2–5 秒。配套 selftest.mjs 自测不调模型。
Q：能生成角色参考图吗？
能。character-refs 支持任意故事角色：一条消息描述角色 → 拆字段补全确认 → 生成正面全身锚点 → 头像/90°侧面/背面/细节各视角只参考该锚点；可用 ComfyUI（Qwen Image）、codex 图像、GPT Image 2 API 或自定义命令。
Q：输出语言是？
中文优先。novel-characters 即使源小说是英文，也产出中文角色档案，校验器还会主动拒绝该字段里的英文。
Q：怎么保上下游一致？
各 skill 从同一份结构化数据（如 outline.json）播种，角色/美术/剧本同步迭代，避免各写各的。
Q：商用 / 二次开发？
Apache-2.0 开源。作者正处求职间隙开放远程协作/半合作（生活成本+利润分成），详见 README。
📎 GitHub 搜索 eternityspring/shuohao-skills · 关注「AI工具匠」获取更多 AI 工具实操教程