信息卡

一句话定位

一套面向 Claude Code 与 codex 的 AI 短剧制作技能集合：把一本小说直接推进到"能喂给生成管线"的生产素材——角色拆解、大纲、场景/道具设定、剧本与分镜一应俱全；核心设计原则是"大纲收敛结构，剧本/场景/角色同步迭代，分镜只做输出不做新决定"。

走红原因分析

AI 视频生成工具爆发后，真正的瓶颈从"生成"转移到"可批量生产的脚本物料"，shuohao 直接把这条工业化流水线开箱化补位；五技能各带质量关卡，显出超出玩具项目的认真度；零 npm 依赖、装完即用降低尝鲜成本。

核心功能拆解

• novel-outline：把小说改编成五部分短剧大纲（改编说明/"爽点"表/角色表/分集摘要/资产清单），含 14 个质量关卡，支持既有大纲的健康检查模式；
• novel-characters：产出角色设计集——画像、图像提示词、语音提示词、角色设定图，字段从 outline.json 预填；
• novel-art：场景与叙事道具的艺术指导集：一致性锚点、光照/状态变体、尺度参考、无人物白底提示词，11 个关卡；
• novel-script：按节奏流（动作+对白交替）撰写剧本，基于语速确定性的时长计算，以及支持 TTS 的对白集，10 个关卡；
• novel-storyboard：片段（单次生成 ≤15 秒）→镜头（硬性 2–5 秒门槛）→带切点的画面帧、MiniMax H3 提示词核对，导出生产包，17 个关卡；报告默认中文，`render --lang en` 出英文版。

架构与技术栈浅析

每个 skill 是独立目录 skills//，内含 SKILL.md、不调用模型的 scripts/selftest.mjs、零依赖工具与参考资料。单页报告器 report.mjs 是"组装器"而非 skill：逐个调 render --html 再拼接，处理了 13 处 CSS 类名冲突并重算图片输出路径，不改动任何 skill 代码。面板可用数字键 1–5 切换并支持深度链接。注意：仅在 macOS + Node 24 上验证过，无 CI。

安装与环境要求

Node ≥ 18 必须（纯标准库、零依赖、无需 install）；消耗当前会话模型额度，无需 API key；codex CLI 仅在内置 $imagegen 生图时需要，缺失则跳过生图。

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`（单技能）、`--codex`、`--uninstall`。

快速上手示例

node scripts/report.mjs --from <demo目录> --out report.html  # 汇总已生成的报告
node scripts/report-selftest.mjs          # 92 断言自测，无浏览器
for f in skills/*/scripts/selftest.mjs; do node "$f"; done

进阶使用要点

• 五技能逐级消费上游产物：改大纲会牵连角色表与资产清单，可用健康检查模式核对一致性；
• 镜头时长走语速确定性计算，配音前即可预估总片长；
• 提交成果时 .gitignore 排除生成的 HTML/PNG。

典型应用场景

• 网文作者把存量小说快速改编为可投喂视频模型的分镜包；
• MCN 小团队的批量化 AI 短剧试产线；
• 用质量关卡校验外部交付的大纲与剧本；
• AI 影视课程的教学流水线案例。

同类生态位对比

对比通用写作助手：它锁定短剧工业格式（15 秒片段、2–5 秒镜头）而非自由文本；对比 Runway/Pika 等 GUI 工具：本仓库专注生成之前的结构化准备，天然互补；与同榜 unlazy 同运行于 Claude Code skill 体系，但面向内容创作而非工程纪律。

资源导航

仓库 README（五技能表格与演示目录布局）、skills/*/scripts/selftest.mjs 自测入口、report.mjs 组装器、作者站外项目 ReelBench 与 hao_dev 社区（非仓库组成部分）。