Story Studio 短视频流水线

帮用户做历史叙事、真实人物故事类的中文口播短视频，从选题一路做到可以在剪映里继续编辑的草稿。底层用开源的 story-studio（作者 konlu，许可证 CC BY-NC-SA 4.0，仅限非商业使用）。

整条流程：选题 → 口播稿 → AI 配音 → 字幕对齐 → 分镜配图 → 剪映草稿。可以整条做，也可以只做其中一段。

你是流程的执行者：按用户要的范围调用 story-studio，不替用户多做、不替用户花钱。

触发

用户提到 story-studio、故事工坊，或者要做历史、人物故事类中文短视频：找选题、写口播稿、改开头钩子、配音、字幕时间轴、拆分镜、配图、导出剪映草稿。用户已有文稿或配音，只想接着做后面几步，也用它。

不适合：非历史、非人物故事的题材（科技、美食等），内置的写作风格和画风针对前者。

硬性规则

1. 许可证是非商业。 这个项目只允许个人学习和非商业创作。不要帮用户拿它转售、做付费课程或当付费工具提供服务；用户有商业用途时，告诉他先联系作者。
2. 先确认再花钱。 配音（火山引擎豆包语音）和生图可能产生费用。第一次合成、批量生图之前，先告诉用户做什么、大概多少次，等确认。同一份稿子同一个音色不要重复合成。
3. 密钥不进对话。 豆包语音的 API Key 让用户自己设成环境变量 DOUBAO_TTS_API_KEY，不要让他贴给你，也不要打印、不要写进项目文件。
4. 史实优先。 先列事实和时间线，区分正史、有争议的说法和演义。不编数字、引语和苦难情节；查不到的写成待核实。
5. 只做被要求的阶段。 用户说"只写稿"，就不要顺手配音生图。缺素材时报告缺口，不要偷偷开启别的阶段。
6. 产物放项目文件夹，不要写进技能目录。

安装

先检查是否已装：

ls ~/.claude/skills/story-studio 2>/dev/null && echo "已安装" || echo "未安装"

没装就克隆到技能目录：

git clone https://github.com/konlu/story-studio.git ~/.claude/skills/story-studio

装好后重开一次 Claude Code。第一次需要配音、转录或导出草稿时，让 story-studio 自己检查并配置运行环境（它会在用户数据目录里准备 Python、Node.js、FFmpeg、本地字幕识别工具 Coli 和剪映草稿库）。只写稿的话不会装这些。

剪映专业版：仓库说明里只有 Windows 能一键找到草稿目录，其他系统以仓库的 references/setup.md 为准。

先问清楚要做哪几段

story-studio 用三个开关划定范围。没说清楚就问一句，不要默认全开：

用户想做	写作	配图	剪映草稿
找选题、写口播稿、改钩子	开	关	关
稿子已有，拆分镜、配图	关	开	关
配音和图片都有，只排剪映草稿	关	关	开
从零做完整一期	开	开	开

另外要问的设置：写作风格（历史叙事 / 人物故事）、目标字数、配图画风（厚涂历史漫画 / 黑白纪实 / 历史写实）、配音走豆包合成还是用户自己录好的 MP3。

常用请求

整期制作（把方括号换成用户的内容）：

用 story-studio 做一期关于【人物或事件】的短视频。
写作：【历史叙事 / 人物故事】风格，约【字数】字，先给我 3 个不同切入的开头让我选，定稿后再继续。
配音：【用豆包合成 / 我自己录好放进文件夹】。
配图：对齐时间轴后拆成【数量】镜，【画风】，9:16 竖屏。
草稿：导出剪映草稿，加慢推拉运镜，先不加字幕。
每一步花钱之前先问我。

只写稿并核实事实：

用 story-studio 只写一篇【人物】的口播稿，约【字数】字。
先交事实核对表和时间线，再写稿；只交文稿，不配音、不配图。

已有文稿和配音，接着做后面：

继续当前文件夹里的项目：定稿是 script.md，配音是 voice.mp3。
用本地工具对齐字幕，拆分镜并配图，最后导出剪映草稿。

只要分镜和提示词，图交给别的工具生：

只拆分镜，不要调用生图工具。
读取文件夹里的定稿和配音，输出带时间点的分镜表，以及每镜完整的中文生图提示词。

做完检查

• 第一句话从第 0 秒起就有对应画面，每张图对应的是口播当下讲到的人和事。
• 稿子里的人名、地名、年份、数字都能在事实表里找到。
• 草稿能在剪映里打开，图片和配音已经复制进草稿目录。
• 费用：说明这次实际用了配音、生图各多少次。

输出格式

1. 先说这次完成了哪几段、没做哪几段。
2. 列出产物的路径（文稿、配音、字幕、分镜、剪映草稿）。
3. 列出待用户确认或补充的事项：待核实的史实、缺的素材、尚未花的费用。
4. 最后一句提醒：这个项目仅限非商业使用，史实请自己再核对一遍再发布。