这是什么
shuohao-skills 是一个面向 AI 短剧制作的开源技能集合，由作者 eternityspring 开发，采用 Apache-2.0 协议。
它把从一本小说到可直接喂给生成管线的制作素材的完整流程，拆解为五个相互独立又协同工作的 skill：
- novel-outline：将小说改编成短剧大纲五件套——改编说明、人物表、爽点表、分集梗概、资产清单（含叙事道具表），并内置 14 道质量门脚本检查。
- novel-characters：根据大纲生成角色设定集，包括人物画像、形象提示词、音色提示词和角色设定图。
- novel-art：产出美术设定集（场景 + 叙事道具），包含一致性锚点、光照与状态变体、尺度参照等，10 道质量门脚本检查。
- novel-script：编写剧本，采用场次 + 节拍流结构，逐集时长按语速确定性折算，台词本按角色聚合并带音色提示词，可直接对接 TTS，10 道质量门检查。
- novel-storyboard：生成分镜，段（≤15 秒）→ 分镜（2–5 秒硬门）→ 分镜图，支持 MiniMax H3 提示词对齐，18 道质量门检查，并可一键导出 H3 / Seedance 投产包。
五个 skill 的报告均支持中英双语界面，默认中文，可通过 render --lang en 输出英文报告。
适合谁
这个技能集特别适合以下人群：
- AI 短剧创作者：希望用 AI 辅助从小说改编到分镜的全流程，提高制作效率。
- 编剧与导演：需要快速将小说 IP 转化为结构化剧本和分镜，用于后续 AI 视频生成。
- AI 视频工具使用者：已经使用 Claude Code 或 Codex 等编码 Agent，希望扩展其能力到创意制作领域。
- 内容工作室：需要标准化、可复用的短剧生产流程，减少人工重复劳动。
能做什么
整个管线遵循「改编大纲收敛结构，剧本、场景、角色三者同步迭代，分镜只做输出不做新决定」的原则，具体能力包括：
- 小说改编：输入一本小说，自动生成结构化的短剧改编大纲，包含人物表、爽点表、分集梗概等。
- 角色设定：基于大纲生成详细的角色设定集，包括形象提示词和音色提示词，方便后续 TTS 和图像生成。
- 美术设定：生成场景和道具的美术设定，提供一致性锚点和提示词，确保 AI 生成画面风格统一。
- 剧本编写：自动生成场次和节拍流剧本，时长按语速折算，台词本可直接对接 TTS。
- 分镜生成：将剧本拆分为分镜，生成分镜图和 H3 提示词，支持导出投产包。
- 单页报告合成：可将五段报告合成一张单页，左侧导航切换，支持平铺全部面板和深链分享。
使用前准备
在使用之前，请确保满足以下条件：
- Node.js：需要 Node.js 版本 ≥ 18，技能脚本仅使用标准库，无 npm 依赖，无需额外安装。
- 模型额度：使用当前会话的模型额度，不需要任何 API key。
- 运行环境：需要安装 Claude Code 或 Codex CLI 作为运行环境，技能本身不依赖其本机能力。
安装方法
安装非常简单，只需执行以下命令：
git clone https://github.com/eternityspring/shuohao-skills.git
cd shuohao-skills
./scripts/install.sh
安装脚本会自动检测本机安装了 Claude Code 还是 Codex，并将所有技能软链到对应目录，之后 git pull 即可生效，无需重新安装。也可以只安装特定技能：
./scripts/install.sh novel-characters # 只装某一个
./scripts/install.sh --codex # 只装到 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
使用示例
以端到端 demo 为例，将一本小说放入工作目录，按五个技能依次运行，即可得到五套报告：
- novel-outline：生成短剧改编大纲报告。
- novel-characters：生成角色设定集报告。
- novel-art：生成美术设定集报告。
- novel-script：生成剧本报告（含时长仪表、分集剧本、台词本）。
- novel-storyboard：生成分镜报告（含分镜节奏带、主/子分镜图、H3 提示词）。
合成单页报告的命令：
node scripts/report.mjs --from <demo目录> --out report.html
该命令会自动发现五份 JSON 并合成单页，支持数字键 1–5 切换面板，深链可分享到特定面板。
丢一本小说进去，出这五套：
novel-outline · 短剧改编大纲
novel-characters · 角色设定集
novel-art · 美术设定集（场景 + 道具，设定图为 skill 实际生成）
novel-script · 剧本（时长仪表 + 分集剧本 + 台词本）
novel-storyboard · 分镜（分镜节奏带 + 主/子分镜图为 skill 实际生成 + H3 提示词）
风险与注意事项
- 平台兼容性：作者仅在 macOS + Node 24 上验证过，代码无平台相关调用，Linux 和更低版本 Node 理论上没问题，但未经验证。
- 分镜图片路径：分镜报告中的图片使用相对路径，要求报告 HTML 与段文件夹同级，否则图片会静默变成「未生成」占位，且不会报错。
- 版本控制建议：报告 HTML 和分镜 PNG 可由 render 重跑再生，建议只提交 JSON、MD、docs、scripts 目录，用 .gitignore 排除生成文件，保持仓库轻量。
- 付费社群：作者提供付费 AI 视频交流群，与 ReelBench AI 视频工作台是两项独立服务，请根据自身需求决定是否加入。