shuohao-skills：把一本小说变成短剧拍片的素材

丢进一本小说，AI Agent 自动拆角色、排大纲、出场景道具设定图——这个仓库让"写小说"和"拍短剧"之间只差一个 git clone 的距离。

这个项目解决什么问题？

2026 年 8 月，shuohao-skills 在 GitHub 上一周涨到 900+ Star。它的定位非常精准：为 AI 编码 Agent（Claude Code、Codex）提供一套短剧制作工具链——输入小说文本，输出角色设定集、改编大纲、美术设定图。
短剧现在是内容行业最热的赛道之一，但把小说改编成短剧需要三步重活：

1. 拆角色：从几百万字的小说里提取人物画像、形象提示词、音色
2. 排大纲：把小说结构转换成短剧分集梗概、爽点表
3. 出美术：场景设定图、道具参考图
   每一步都要靠人手工做，耗时几周。这个仓库把这三步封装成了三个可以独立运行的 Agent Skill。

核心亮点

一、三个 Skill，各自独立、可单独拷走

skills/ ├── novel-characters ← 角色设定集 ├── novel-outline ← 短剧改编大纲 └── novel-art ← 美术设定集

每个 Skill 自带 SKILL.md（Agent 读）、scripts/（零依赖 Node.js 脚本）、references/（详细指令）、examples/（样例数据）。不需要 npm install，Node 标准库就够用。
二、质量门脚本化，不靠 LLM 自己判断
这是最有意思的设计。传统的 AI 写作工具靠 LLM 自己判断"写得好不好"，但这个仓库用确定性脚本做质量检查：

• novel-outline：13 道质量门，全部脚本检查
• novel-art：11 道质量门，全部脚本检查
• 每个 skill 自带 selftest.mjs，不调用模型、不花额度，1 秒跑完
  这意味着质量评估是可重复、可验证的，不是每次生成质量不同的"薛定谔的 AI"。
  三、吃 outline.json 预填清单
  novel-art 可以直接读取 novel-outline 输出的outline.json，自动预填需要出图的场景和道具清单。三个 skill 之间有明确的数据接口，不是三个独立的玩具。

快速上手

gitclone https://github.com/eternityspring/shuohao-skills.gitcdshuohao-skills ./scripts/install.sh

自动检测本机装了 Claude Code 还是 Codex，软链过去，git pull 后立刻生效。
前置条件：Node ≥ 18、当前会话的模型额度（不需要额外 API key）。

我的评价

shuohao-skills 的 Star 数能到 900，靠的不是"又一个 AI 写作工具"，而是它踩中了一个真实的痛点：短剧行业需要工业化生产素材，而传统的素材生产方式是纯人力的、不可复制的。
这个仓库的价值在于它证明了：Agent Skill 可以把"创意工作流"拆成可执行、可验证、可组合的模块。每个 Skill 是一个独立的"工具包"，但组合起来就是一条完整的短剧制作流水线。
和同类项目相比，shuohao-skills 的三个特点值得注意：

1. 不依赖外部 API：所有脚本只用 Node 标准库，没有 npm 依赖
2. 质量门自动化：不是靠 LLM 自说自话，而是用脚本检查结构完整性
3. 双 Agent 兼容：Claude Code 和 Codex 都能跑，降低迁移成本
   局限：目前只在 macOS + Node 24 上验证过，Linux 和低版本 Node 未测试。出图功能依赖 Codex 的$imagegen，没有配置时会跳过出图。
   适合谁：写小说想做短剧改编的作者、短剧工作室的技术团队、Agent 使用者。不适合谁：只需要简单文字生成的用户。

项目：eternityspring/shuohao-skills
协议：Apache 2.0