shuohao‑skills：开源AI短剧Agent技能集，小说一键输出短剧全套素材

什么是 shuohao‑skills

shuohao‑skills是开源AI短剧制作Agent技能集合，适配Claude Code、codex运行环境，主打把网络小说原文加工成可直接投产的短剧全套素材，包含大纲、人物、美术、剧本、分镜整套产出，和ReelBench本地AI视频工作台为相互独立项目，可搭配使用也可单独部署运行。

项目核心定位不是视频生成工具，而是一套AI短剧生产的指令技能库，负责文本链路全部创作输出，图像、视频生成交由外部模型接口完成，解决AI短剧创作中设定前后矛盾、分集节奏失控、分镜与剧本脱节的痛点。

功能特色

1. 完整流水线闭环：从原始小说文本出发，依次输出改编大纲、角色设定、美术资产、短剧剧本、标准化分镜，整套模块互相约束迭代，避免人物、场景设定前后冲突。

2. 模块化可拆分技能：五大技能单元可以独立调用，不需要完整跑完全流程。已有剧本、大纲也可以输入工具做体检优化，不用从零开始。

3. 内置质量校验机制：每个skill内部自带自动化校验逻辑，输出支持中文、英文两套报告，方便校对、对外交付。

4. 投产包一键导出：分镜环节输出可直接对接AI视频模型的投产数据包，配套脚本可以把全部输出文档拼装成单页HTML导航报告，自带全局搜索、面板快捷键，方便团队查阅素材。

5. 自带本地自测脚本：每个模块提供selftest.mjs自测脚本，无需调用大模型API，快速校验本地环境逻辑是否正常。

6. 时长可控剧本生成：剧本模块会依据语速自动折算剧集实际时长，输出适配TTS合成的聚合台词本。

技术细节

• 运行环境：Node.js ≥18；项目本体无npm第三方依赖，仅图像生成环节需要codex CLI工具。项目完整验证环境为macOS+Node24；Linux、低版本Node理论兼容，未做完整测试。

• 授权协议：Apache‑2.0开源许可。

• 运行载体：面向AI Agent（Claude Code、codex）的技能库，复用Agent会话的模型额度，技能本身不需要单独申请API Key。

• 目录规范：产出强制划分 outline、characters、art、script、storyboard 目录；git版本管理仅保存md/json源文件，HTML报告、图片资源加入gitignore不予提交。

• 安装逻辑：提供install.sh脚本，支持批量安装、安装单个技能、卸载技能；底层使用软链接方式挂载到Agent技能目录，也支持手动软链接部署。

• 输出格式：Markdown、JSON结构化数据，可编译生成单文件HTML可视化报告；分镜输出适配MiniMax H3提示词格式。

应用场景

1. AI短剧工作室批量生产：输入小说原文，快速产出分集大纲、人物设定、剧本、分镜初稿，减少人工前期文案工作量，输出素材对接后续AI生视频工作流。

2. 个人短剧创作者：无专业编剧、分镜经验，借助标准化技能库完成小说改编，产出可直接交给剪辑、AI视频工具使用的素材。

3. 短剧团队内部协作：HTML导航报告统一管理全部设定文档，方便编剧、美术、剪辑人员统一查阅人物、场景、分镜，减少信息偏差。

4. 已有素材校验优化：对已经写好的大纲、剧本做体检校验，修正人物矛盾、节奏失衡等问题，不需要重新全部改写。

5. 本地AI视频工作台ReelBench配套使用：shuohao‑skills输出的投产包，可直接对接ReelBench完成后续视频批次生成。

使用方法

1. 获取源码：git clone拉取GitHub仓库到本地电脑。

2. 环境准备：确认本机 Node.js 版本 ≥18；如需生图功能，准备codex CLI工具。

3. 安装技能：执行仓库内install.sh脚本，可选择全部安装、安装单个技能，也可以手动创建软链接挂载至Agent技能目录。

4. 环境自测：运行每个skill目录内selftest.mjs自测脚本，不调用大模型，验证本地逻辑正常。

5. 执行创作流程：在Claude Code / codex环境，依次调用技能：novel‑outline → novel‑characters → novel‑art → novel‑script → novel‑storyboard；也可以单独调用其中某一个模块。

6. 查看产出：产出文件自动归类到对应业务目录；运行拼装脚本生成单页HTML导航报告，浏览全部改编成果。

7. 投产使用：storyboard目录下的投产包，对接AI视频模型，批量生成短剧镜头素材。

竞品对比

常见问题解答

shuohao‑skills可以直接生成视频吗？

不可以。shuohao‑skills只负责文本链路，输出大纲、角色、剧本、分镜提示词等素材，图像、视频生成需要交给外部模型或ReelBench工作台完成。

必须搭配ReelBench才可以使用吗？

不需要。两者是互相独立项目，shuohao‑skills产出的投产包可以对接其他AI视频工具，ReelBench只是适配的工作台之一。

运行需要额外API Key吗？

技能库本身不需要独立API Key，复用Claude Code、codex会话的模型额度；只有codex CLI生图环节，需要对应模型接口权限。

Windows系统可以完整运行吗？

项目完整验证环境为macOS+Node24，Linux、低版本Node理论兼容但没有完整测试，Windows没有做适配验证，可能出现软链接脚本异常。

可以只使用其中某一个技能，不跑完整流程吗？

可以。五个技能模块全部支持独立拷贝运行，比如只调用novel‑script做剧本改写，无需执行前面大纲、人物模块。

HTML报告是必须的输出吗？

不是。JSON、Markdown是原始源文件；HTML报告是附加拼装产物，用于团队浏览，版本控制中建议忽略HTML与图片文件。

相关链接

• GitHub项目地址：https://github.com/eternityspring/shuohao‑skills

总结

shuohao‑skills作为一套开源AI短剧Agent技能集合，聚焦小说改编短剧前期全链路文案与分镜提示词生产，以模块化的设计降低AI短剧创作的设定冲突、节奏把控难题，支持本地部署与独立模块调用，产出标准化投产素材，适合个人创作者、短剧工作室做前期内容加工，同时可以和外部AI视频工作台配合完成完整短剧生产链路。