# Story Studio

历史与真实人物故事的中文内容制作，按需独立执行写作、豆包配音、分镜与配图、剪映草稿，支持自动初始化依赖和接续已有项目。用户提到story-studio、故事工坊，或要求这些题材...

- Repository: https://github.com/konlu/story-studio (624 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-29
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add konlu/story-studio --skill story-studio -g -a claude-code -y`
Codex: `npx skills add konlu/story-studio --skill story-studio -g -a codex -y`
Cursor: `npx skills add konlu/story-studio --skill story-studio -g -a cursor -y`
Gemini CLI: `npx skills add konlu/story-studio --skill story-studio -g -a gemini-cli -y`

## Description

历史与真实人物故事的中文内容制作，按需独立执行写作、豆包配音、分镜与配图、剪映草稿，支持自动初始化依赖和接续已有项目。用户提到story-studio、故事工坊，或要求这些题材的文案配音配图剪映一条龙时使用。现有写作风格为历史叙事和玉玲2711人物故事风；民间故事等赛道可扩展。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Story Studio · 故事工坊

一个入口，按本次请求开启写作、配图、剪映草稿。三个开关控制交付范围；内容赛道、写作风格和配图画风分别设置。内置所需语料、参考图、规则和脚本，按需读取。

## 安装与首次使用

首次使用或依赖报错时，先读 [依赖初始化](references/setup.md)。Agent按本次阶段执行原生启动器check：Windows用 `scripts/bootstrap.ps1`，macOS/Linux用 `scripts/bootstrap.sh`，均以实际技能绝对路径调用，不假设电脑已有Python。只写作或纯文本分镜可先完成不依赖脚本的工作，不安装媒体组件。

需要安装而用户尚未授权时，集中展示缺少的组件，提供一次“自动配置并继续 / 暂不配置”的选择，不让用户运行命令、复制路径或逐项安装。用户已经明确要求初始化、一键配置或自动安装时，直接执行相应install，不重复询问。Agent完成下载、安装、草稿目录发现和复查，再继续原任务；已有可用组件复用。依赖安装与创作开关分别处理，不因初始化生成作品。

启动器支持缺Python时配置用户专用Python，再按需安装Node.js、FFmpeg、媒体库及Coli；Windows草稿用户可一并安装缺少的剪映。安装失败由Agent查看原因并修复，实际缺少操作系统授权、账户登录或工具权限时才向用户说明所需操作，不能把失败转换成一串手动命令。生图工具授权单独验证，不把说明文件存在当作工具可用。复制目录本身不会执行安装，首次调用才触发检查。

草稿导出直接使用Python库 `pyJianYingDraft==0.3.1`，无需安装额外草稿技能。实际生图可用宿主图像工具，`imagegen` 是可选指导技能；Coli是本地转录CLI。依赖与作者见 [README](README.md)。

初始化后，所有模块示例中的python、python3或py -3.11均替换为外部runtime.json记录的python可执行程序绝对路径；不能假设便携安装已加入全局PATH或存在py启动器。

## 解析本次请求

接受自然语言和中文开关，不要求用户填写 JSON。明确要求开启的阶段才开启，未请求的阶段关闭；最新明确开关优先。只点名技能、未说明任务时简短询问要做哪一项，不默认全开。

| 开关 / 内部键 | 工作范围 | 关闭时可接收 |
| --- | --- | --- |
| 写作 / `write` | 选题、核实资料、写稿、改稿、钩子、字数检查 | 用户已有文稿 |
| 配图 / `illustrate` | 分镜、提示词或实际生图，由下方模式决定 | 已有分镜和图片 |
| 剪映草稿 / `draft` | 素材核对、必要音文对齐、时间轴、运镜、导出草稿 | 已有或本次上游产物 |

- “只写稿” → 仅 write；“只做配图” → 仅 illustrate；“现有素材做剪映草稿” → 仅 draft。
- “写稿并生成20张图” → write、illustrate；“写稿、配图、做剪映草稿一条龙” → 三项开启，但仍检查最终配音等前置素材。
- “配图并做草稿”包含实际图片产物，可进入 generate；“只出分镜/提示词，再做草稿”不授权生图，缺图时交付已完成部分和缺口。
- “继续配图”“只重做第8镜”只开启这次要求的阶段；继承当前项目已确认设置和可用产物，不沿用上次全开的操作范围。
- 开关与自然语言明显矛盾时澄清冲突；能独立推进的部分先做。非必要设置从当前项目或模块默认值取得，不逐阶段要求确认。
- 阶段关闭不代表它的已有素材不可用。缺必要素材时不暗中开启写作、生图、配音或本地 MP4；已开启且不依赖缺口的工作继续完成。

新项目或跨阶段接续时读取 [项目记录与版本](references/project-state.md)。已有用户目录直接使用；无目录时在当前工作区创建可辨识项目目录。不要把创作产物写进技能目录。

## 赛道与写作风格

仅开启写作时才选择写作分支。先从用户描述推断；“秦怡人物故事，按玉玲风格”已足够，不重复问。真实人物也能用历史叙事写法，人物姓名本身不强制人物风。

The rest: https://github.com/konlu/story-studio/blob/HEAD//SKILL.md