shuohao-skills 是给 AI 编码 agent 用的短剧制作 Skill 集合，覆盖从小说到生成素材的完整管线。整条管线分五段：novel-outline 把小说改编成短剧大纲五件套（改编说明、人物表、爽点表、分集梗概、资产清单），novel-characters 把大纲定下的角色做成角色设定集（画像、形象提示词、音色提示词、设定图），novel-art 出场景与叙事道具的美术设定集，novel-script 写场次与节拍流剧本并按语速折算时长，novel-storyboard 切分镜并生成 MiniMax H3 提示词与投产包。每个 Skill 一个目录、自包含、可单独拷走，脚本零 npm 依赖、零 API key，用当前会话额度；出图走 codex 内置 $imagegen（可选）。核心主张是 checklist 交给模型自觉靠不住，因此各层的质量门（大纲 14 道、角色 4 类硬规则、美术 11 道、剧本 10 道、分镜 17 道）全部由脚本确定性检查，自测里每道门都有击穿用例。报告界面默认中文，可切英文。
由 novel-outline、novel-characters、novel-art、novel-script、novel-storyboard 五个 Skill 依次接力：novel-outline 把小说改编成短剧大纲并产出 outline.json，novel-characters 依据大纲角色表产出 cast.json，novel-art 产出场景与道具美术设定 art.json，novel-script 写出剧本 script.json，novel-storyboard 切分镜并 export 一键出分镜投产包；前一段的 JSON 产出作为后一段的输入，最终得到可直接下单给视频模型的分镜投产包。
大纲 14 道、美术 11 道、剧本 10 道、分镜 17 道质量门均由 validate 确定性检查，例如分镜每切 2–5 秒、单句台词 ≤ 35 字、钩子必须落在全集前 3 拍内、道具提示词必须带尺度短语，自测中每道门都有击穿用例。
novel-characters 按 4 万字符重叠块并发扫描角色，再按名字与别名归并跨块的不同称呼，并列出 mergeCandidates 疑似同人候选供复核；novel-outline 按章节标题分卷（默认每卷 15 章）汇总，上限 60 卷，超出明确报 truncated 不静默截断。
novel-script 按语速（默认 4.5 字/秒）折算台词、按节拍估时（默认 2.5 秒/拍）折算动作，每集必须落在目标时长 ±15% 内；novel-storyboard 的段上限 15 秒、分镜 2–5 秒，H3 提示词的对齐指令与切点时刻由分镜秒数推导并逐字对账。
每个 Skill 产出 JSON + Markdown + 可离线双击打开的单页 HTML 报告，报告内嵌数据并带导出 JSON 按钮，下载的就是原始 JSON，改完可直接喂回 render / validate；界面默认中文，render 加 --lang en 输出英文界面。
有 codex 时走内置 $imagegen 出角色设定图、场景与道具设定图、分镜图（拿设定图当参考图）；novel-storyboard 还支持 --shots 挂载外部镜头配方卡库，不给则明说跳过，配方建议景别与运镜刻意不设门。
使用场景把一本小说跑完整条短剧制作管线
仓库自带《渡口》样例：6 集微型大纲、三场景加两件叙事道具（旧皮箱、县衙旧砚）的美术设定、全 6 集完整剧本（每集冷开场兑现钩子）、角色设定与分镜，全部质量门通过，同时充当各 Skill 的自测夹具。
使用场景手上已有短剧大纲，只想诊断问题
运行 node scripts/novel-outline.mjs checkup outline.json 在终端输出 ✓/✗，或 render 出报告看质量门面板；未过的门不阻止渲染，把病灶直接摆出来。
使用场景需要非中文界面的评审报告
novel-characters 内置中文 / English / 日本語 三套界面文案，其他语言可用 ui-template 打印骨架自行翻译后写入 cast.json 的 ui 字段；出图和 TTS 提示词永远英文，原文引文保持原文语言。
Golang-error-handling 是面向 Go…
