shuohao-skills README

The project's README from github.com/eternityspring/shuohao-skills. As one markdown file: README.md.

中文 English 关注作者 X

🎬 AI视频工作台

ReelBench AI短剧工作台首屏

shuohao-skills

AI 短剧制作的 skill 集合：从一本小说到直接喂生成管线的制作素材——拆角色、排大纲、出场景与道具设定、写剧本、切分镜。给 AI 编码 agent 用，Claude Code 和 codex 都能跑。

整条管线长这样——改编大纲收敛结构，剧本、场景、角色三者同步迭代，分镜只做输出不做新决定：

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

五段管线 skill 的报告都支持中英双语界面：默认中文，render --lang en 出全英文报告（数据内容保持原文）。character-refs 的报告同样内置中英日界面，其他语言现场翻译。

AI 短剧交流社群

我建了一个付费AI视频交流群，讨论 AI 视频的工作流、工具和实操。交流群 ReelBench AI 视频工作台是两项独立服务。

有兴趣的加我：微信 hao_dev，添加时备注 github。

烁皓微信二维码

合成一张单页

五段的报告可以合成一张单页，左侧导航切换——有哪几段就出哪几个面板：

node scripts/report.mjs --from <demo目录> --out report.html

--from 按下面的工作目录约定自动发现五份 json；也可以逐个指定（--outline --cast --art --script --storyboard）。只跑了角色那一段就只有一个面板，不报错。

它是组装器，不是独立 skill：不 import 任何 skill 的代码，而是调各自的 render --html 拿产物再拼装。所以五个 skill 一行不改、各自仍然独立可跑、可以单独拷走；某个 skill 改了渲染，这边自动跟上。

合并时处理三件事——这三件都在组装器里做，不侵入 skill：

默认一次显示一个面板（五份加起来将近六十万字符）。左下角「平铺全部」把所有面板同时展开，Cmd+F 恢复全局搜索。数字键 1–5 切面板，#pane-script 这样的深链可以直接分享到某一屏。

node scripts/report-selftest.mjs   # 92 项断言，不起浏览器

丢一本小说进去，出这五套：

novel-outline · 短剧改编大纲

短剧改编大纲报告

novel-characters · 角色设定集

角色设定集报告

novel-art · 美术设定集（场景 + 道具，设定图为 skill 实际生成）

美术设定集报告

novel-script · 剧本（时长仪表 + 分集剧本 + 台词本）

剧本报告

novel-storyboard · 分镜（分镜节奏带 + 主/子分镜图为 skill 实际生成 + H3 提示词）

分镜报告

不从小说出发也行，给任何一个角色真出参考图：

character-refs · 角色参考图（锚点 GPT 出、其余 Qwen 出，全部为 skill 实际生成）

角色参考图报告

安装

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

自动检测本机装了 Claude Code 还是 codex，把所有 skill 软链过去——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

前置条件

必需？ 说明
Node 必需 ≥ 18。skill 的脚本只用标准库，没有 npm 依赖，不需要 install
模型额度 必需 用你当前会话的额度，不需要任何 API key
codex CLI 可选 只是一个能跑这些 skill 的运行环境，跟 Claude Code 等价。五段管线 skill 不出图，不需要它的任何本机能力
出图模型 只有 character-refs 需要 四选一：自己的 ComfyUI（Qwen Image）、本机 codex 内置出图（吃 ChatGPT 订阅额度）、OpenAI API key（GPT Image 2）、自定义命令。第一次使用时选

仓库约定

每个 skill 一个目录，自包含、可以单独拷走：

skills/<skill-name>/
├── SKILL.md          给 agent 读的工作流（必需）
├── README.md         给人读的说明
├── scripts/
│   ├── <name>.mjs    确定性工具，零依赖
│   └── selftest.mjs  自测，不调模型（必需）
├── references/       按需加载的详细指令
├── examples/         自带样例，同时当测试夹具
└── assets/           截图

两条硬要求：

加新 skill 之前，先把全部自测跑一遍：

for f in skills/*/scripts/selftest.mjs; do node "$f"; done

没有配 CI——自测足够快（1 秒），本地跑一次比等 CI 更省事。只在 macOS + Node 24 上验过；代码没有平台相关调用，Linux 和更低版本 Node 理论上没问题，但没验。

端到端 demo 工作目录约定

把一本小说从头跑完五段（角色 → 大纲 → 美术 → 剧本 → 分镜），会产出大量 *.json / *.md / *-report.html。不要平铺在根目录，按五个 skill 各建一个目录归档，一眼对应流水线五段：

<demo>/
├── outline/       ← novel-outline 产出：<剧>-outline.json / .md / -report.html
├── characters/    ← novel-characters 产出：<剧>-cast.json / .md / -report.html
├── art/           ← novel-art 产出：<剧>-art.json / .md / -report.html
├── script/        ← novel-script 产出：<剧>-script.json / .md / -report.html
├── storyboard/    ← novel-storyboard 产出：<剧>-storyboard.json / .md / -report.html
│   ├── manifest.json  ← export 产出
│   ├── E01-01/        ← export 的分镜投产包，每段一个文件夹（prompt.md + f1..fN.png）
│   ├── E01-02/
│   └── …
├── docs/          ← 自己写的使用说明、PR 草稿等（与机器产物解耦）
└── scripts/       ← 跑管线的辅助脚本（探索期脚本用 _ 前缀保留溯源）

约定要点：

这套结构来自《渡口》端到端 demo 的实际归档经验，demo 的工作目录在本仓库之外，这里只固化约定。

Star 趋势

Star 趋势曲线

License

Apache 2.0

shuohao-skills (eternityspring/shuohao-skills)

Searching Database…

4.7K ·GitHub
Shuohao-skills
这是什么？一套用来把小说制作成 AI 短剧的智能体技能：它从小说中拆解出角色、构建改编大纲、生成美术/道具设定集、撰写剧本并切分分镜。它在 Claude Code 或 codex 里作为编程智能体运行。
这是一个应用，还是一批可供挑选的独立技能？它是一组独立的技能文件夹（novel-outline、novel-characters、character-refs、novel-art、novel-script、novel-storyboard）；每个都自带 SKILL.md、可以单独复制出去独立运行，也可以串成完整的五阶段管线。
怎么把它装进我的智能体？运行安装脚本：它会自动检测你配置的是 Claude Code 还是 codex，并把每个技能软链接到位，这样之后 'git pull' 会立即生效，无需重装。如果你愿意，也可以手动创建软链接。
除了 Claude Code 或 codex 还需要什么？Node.js 18 或更新版本——技能脚本只用标准库，所以不需要 npm install。五个管线技能只用你现有的模型会话配额，不需要单独的 API key。
图像生成需要额外配置吗？只有 character-refs 技能需要，而且首次使用时你要从四个选项里挑一个：自己的 ComfyUI 加 Qwen Image、codex 内置的图像生成（消耗你的 ChatGPT 订阅配额）、用于 GPT Image 2 的 OpenAI API key，或自定义命令。
它在 Linux 和 Windows 上也能用吗，还是仅限 macOS？它只在 macOS 加 Node 24 上验证过。作者指出代码没有调用任何操作系统专属的东西，所以 Linux 理论上应该能正常跑，但未经证实；完全没提 Windows。
五个管线技能各自实际产出什么？novel-outline 产出改编大纲（角色表、钩子列表、分集梗概、素材清单）；novel-characters 构建带肖像和语音提示的角色设定集；novel-art 制作场景/道具美术设定集；novel-script 撰写带时长标尺的完整剧本；novel-storyboard 把剧本切分成带 H3 提示词的分镜并导出制作包。
能在小说管线之外为某个角色生成参考图吗？可以，character-refs 技能是独立的：用一句话描述角色，确认解析出的字段，它就会生成一张正面锚点图，外加与该锚点关联的头部特写、90 度侧面、背面和细节图。
能把五份报告放在一起看，而不是五个单独的 HTML 文件吗？可以，一个单独的组装脚本会把五份报告合并成一页并带左侧导航；它不导入任何技能的代码，只是调用每个技能的 render --html 并拼接输出，同时对 CSS/JS 做作用域隔离，避免五份报告互相冲突。
生成的报告只有中文吗？报告默认是中文，但运行 render --lang en 会产出完整的英文报告（底层数据保持不变）；character-refs 还额外支持日文报告界面。
What are similar projects?godogen, AI-drama-pound, herk-edit-kit, chinese-novelist-skill, guizang-product-video-skill, oh-story-dsh, eian-riso-broll, oh-story-claudecode
Which topics is it in?novel-writing, qwen-image, storyboarding, gpt-image, short-drama, creative-writing, skill-md, openai-api, comfyui, text-to-image, codex-skill, claude-code-skill
Creator
eternityspring
Size
14.2 MB
Stars
4.7K
Updated
CommitOct 15
Age
2mo
Commits · 90 Days