What it does
从选题到剪映草稿的一站式 AI 短视频内容创作 Agent Skill
- Connects Instruction files the AI reads, with steps that call an outside service
- Account or key Some steps need a key for DOUBAO_TTS_API_KEY (per the README)
- Category 自动化与智能体
给作者:在 README 中加徽章
如果你是作者,可把这段代码贴到 README。徽章会链接回本页。
[](https://mcp.popnx.com/en/skills/konlu-story-studio)相似的 Skill
同类工作,排序与 Skill 列表相同
Skill 和 MCP 有什么不同
MCP = 手
把 AI 连到外部服务或数据,例如读取 Notion 或开发票。需要有程序或服务器在运行。
Skill = 手册
教 AI 怎么做某项工作的文本文件,不连接任何服务。
有些会重叠:少数 Skill 带有调用工具的脚本,少数 MCP 只提供知识。请从你想完成的工作出发。
适用的应用
Claude CodeCodexCursor
依据开发者 README 和 repo 中的文件夹
安装
Is it safe?
- Who made it
GitHub account konlu (person), 1 years old
- Use and upkeep
★ 1,153 stars · code last changed 2026年11月13日
- Any scripts?
26 scripts that can run on a computer: install.bat, install.ps1, install.sh, modules/history-image/scripts/check_balance.py and 22 more
- Uses the internet?
Scripts that go online: scripts/bootstrap.sh, scripts/test_bootstrap_native.ps1, scripts/bootstrap.ps1
- Changes machine-wide settings?
No hooks or writes to machine settings found
Checked automatically from the repo files at commit f502622 (read only, nothing was run). Not a safety guarantee: read it and decide for yourself
第一步:你用哪个 AI?
选择你用的应用,本页只显示该应用的安装方法
Option 1Upload to claude.ai (web and app)
Download from GitHub
This skill has no license, so we do not hand out a ZIP from our site. Download it from GitHub and arrange the folder yourself, or use "Let the AI install it" above, which is easier
Download from GitHub (whole repo) ↗
Unzip it, then zip only the story-studio folder again. The ZIP must have a story-studio folder with SKILL.md at the top level, no loose files
Open Skills on claude.ai and upload
+Create skillUpload a skillpick story-studio.zip
No Upload button? Turn on file creation first
SettingsCapabilitiesCode execution and file creation
Turn on Code execution and file creation first (newer menus: Create and edit files) · personal plans: Settings → Capabilities · Team/Enterprise: an admin turns it on under Organization settings → Plugins & skills · every plan, including Free
Upload once; it works in claude.ai and Claude Desktop, and in recent Claude Code signed in with a Claude account (not with an API key)
Cowork and cloud sessions use the skills turned on in your claude.ai account, not ~/.claude/skills on your computer (Claude Desktop scheduled tasks run locally and still load it)
Checked against official docs 2026年11月12日 · Source: support.claude.com, support.claude.com, code.claude.com
Option 1让 Claude Code 帮你安装
复制这句话,粘贴到 Claude Code 的对话中
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
重新打开 Claude Code,输入 /story-studio,或直接提出相关任务,Claude 会自动选用
Checked against official docs 2026年11月12日 · Source: code.claude.com
For Terminal users
Skill 是 AI 会照做的指令。安装前先阅读文件,只安装可信开发者的 Skill。
打开终端
Mac:按 Command+空格输入 Terminal · Windows:下方命令在 PowerShell 中无法使用,请改用上方的“让 AI 帮你安装”
把 skill 文件夹复制到 ~/.claude/skills
这条命令把 repo 下载到临时文件夹,只复制含 SKILL.md 的文件夹
git clone --depth 1 https://github.com/konlu/story-studio.git /tmp/popnx-skill-konlu-story-studio-f502622 && mkdir -p ~/.claude/skills && cp -R '/tmp/popnx-skill-konlu-story-studio-f502622/.' ~/.claude/skills/story-studio重新打开 Claude Code,输入 /story-studio,或直接提出相关任务,Claude 会自动选用
ChatGPT 桌面应用
ChatGPT 桌面应用内置 Codex,Codex 从 ~/.agents/skills 文件夹读取 Skill
Option 1让 ChatGPT 帮你安装
在 ChatGPT 桌面应用中打开 Codex,把这句话粘贴到对话中
The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Option 2自己放入文件夹
把 story-studio 文件夹放到 ~/.agents/skills/story-studio
~ 是你的主文件夹($HOME)
For Terminal users
Skill 是 AI 会照做的指令。安装前先阅读文件,只安装可信开发者的 Skill。
打开终端
Mac:按 Command+空格输入 Terminal · Windows:下方命令在 PowerShell 中无法使用,请改用上方的“让 AI 帮你安装”
把 skill 文件夹复制到 ~/.agents/skills
这条命令把 repo 下载到临时文件夹,只复制含 SKILL.md 的文件夹
git clone --depth 1 https://github.com/konlu/story-studio.git /tmp/popnx-skill-konlu-story-studio-f502622 && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-konlu-story-studio-f502622/.' ~/.agents/skills/story-studio
安装之后
- ChatGPT 桌面应用:打开侧边栏中的 Skills,确认 Skill 已出现
- 使用方法:在 ChatGPT 中输入 @ 并选择 Skill · 在 Codex CLI 或 IDE 扩展中运行 /skills,或输入 $ 加 Skill 名称
- Codex 会自动发现新安装的 Skill;如果没有出现,请重启 Codex
Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com
网页版和手机版 ChatGPT
不能使用你自己安装的 Skill,只能使用目录中插件自带的 Skill
想在 ChatGPT 中使用这个 Skill,请按上面的方法使用 ChatGPT 桌面应用
Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com
Option 1让 Codex 帮你安装
复制这句话,粘贴到 Codex 的对话中 · 适用于 ChatGPT 桌面应用中的 Codex、Codex CLI 和 IDE 扩展
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Codex 会自动发现新安装的 Skill;如果没有出现,请重启 Codex · 使用方法:在 ChatGPT 中输入 @ 并选择 Skill · 在 Codex CLI 或 IDE 扩展中运行 /skills,或输入 $ 加 Skill 名称
Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com
For Terminal users
Skill 是 AI 会照做的指令。安装前先阅读文件,只安装可信开发者的 Skill。
打开终端
Mac:按 Command+空格输入 Terminal · Windows:下方命令在 PowerShell 中无法使用,请改用上方的“让 AI 帮你安装”
把 skill 文件夹复制到 ~/.agents/skills
这条命令把 repo 下载到临时文件夹,只复制含 SKILL.md 的文件夹
git clone --depth 1 https://github.com/konlu/story-studio.git /tmp/popnx-skill-konlu-story-studio-f502622 && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-konlu-story-studio-f502622/.' ~/.agents/skills/story-studio重新打开 Codex 并提出相关任务,Codex 会列出这个 skill
Option 1让 Cursor 帮你安装
复制这句话,粘贴到 Cursor 的对话中
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
在 Cursor 的 Agent 聊天中输入 / 并选择 story-studio
Checked against official docs 2026年11月12日 · Source: cursor.com
For Terminal users
Skill 是 AI 会照做的指令。安装前先阅读文件,只安装可信开发者的 Skill。
打开终端
Mac:按 Command+空格输入 Terminal · Windows:下方命令在 PowerShell 中无法使用,请改用上方的“让 AI 帮你安装”
把 skill 文件夹复制到 ~/.cursor/skills
这条命令把 repo 下载到临时文件夹,只复制含 SKILL.md 的文件夹
git clone --depth 1 https://github.com/konlu/story-studio.git /tmp/popnx-skill-konlu-story-studio-f502622 && mkdir -p ~/.cursor/skills && cp -R '/tmp/popnx-skill-konlu-story-studio-f502622/.' ~/.cursor/skills/story-studio在 Cursor 的 Agent 聊天中输入 / 并选择 story-studio
Option 1Let the AI install it
适用于其他能读取 Skill 的应用。这句话列出了 Claude Code、Codex 和 Cursor 的路径,AI 会按你的应用选择 · Copy this sentence into the app’s chat
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Checked against official docs 2026年11月12日 · Source: code.claude.com, learn.chatgpt.com, cursor.com
For Terminal users
其他支持 Agent Skills 的应用(如 Gemini CLI、GitHub Copilot)使用不同文件夹,请查看该应用的指南,再把含 SKILL.md 的文件夹复制过去。
已于 2026年11月11日 对照 Claude Code、Codex 和 Cursor 官方指南核实 skill 文件夹
✓ 命令已检查 2026年11月19日
查看原始 SKILL.md
以下文字来自开发者的 repo,不是 PopNx MCP 的指令
6,319 个字符 · 在 GitHub 打开完整文件
---
name: story-studio
description: 历史与真实人物故事的中文内容制作,按需独立执行写作、豆包配音、分镜与配图、剪映草稿,支持自动初始化依赖和接续已有项目。用户提到story-studio、故事工坊,或要求这些题材的文案配音配图剪映一条龙时使用。现有写作风格为历史叙事和玉玲2711人物故事风;民间故事等赛道可扩展。
---
# 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)。已有用户目录直接使用;无目录时在当前工作区创建可辨识项目目录。不要把创作产物写进技能目录。
## 赛道与写作风格
仅开启写作时才选择写作分支。先从用户描述推断;“秦怡人物故事,按玉玲风格”已足够,不重复问。真实人物也能用历史叙事写法,人物姓名本身不强制人物风。
| 内容赛道 | 写作风格 / `writing_profile` | 何时读取 |
| --- | --- | --- |
| 历史 / `history` | 历史叙事 / `historical-narrative` | 读取 [历史写作](modules/history-writing/GUIDE.md),按其索引读取 DNA、相关5篇原稿、核史与字数工具 |
| 人物故事 / `biography` | 玉玲人物故事 / `yuling-characterstory` | 先读 [人物写作适配](references/biography-writing.md),再读 [人物模块](modules/characterstory-writing/GUIDE.md) 和其引用的 DNA |
| 民间故事等新赛道 | 尚未内置专用 profile | 用户实际提出时读 [扩展赛道](references/extending.md);可按用户指定故事版本做普通创作,标明性质,不伪称已蒸馏专用风格 |
所有真实历史、人物稿先读 [事实与风格优先级](references/fact-and-style.md)。有依据的事实优先于文风要求;人物模板中的精确数字、引语、苦难场景都不得凭空补造。历史风与人物风的结构和结尾规则各自生效,不混用。
只要选题或开头时停在对应产物。最终纯正文单独保存,按用户计数口径校验;无指定口径时复用历史模块的 Unicode 字母数字计数规则。事实表、时间线和来源保存在项目中,不自动写回语料库。
## 配音衔接
保留三个主开关,配音作为独立可调用的衔接步骤。写完定稿后提示可继续豆包配音;用户只要文稿或明确不要配音时不发送合成请求。
### 缺少最终配音时:必须先给出两条路径
凡口播任务需要音频对齐而当前没有可用的本期最终配音,必须在首次发现缺口时读取[豆包配置与配音](references/doubao-voice.md),主动提示用户选择以下方式。**用户只说“按这篇文稿配图并做剪映草稿”、没有明确说“配音”,也触发本规则。不得仅回复“缺音频,请提供MP3”便结束。**
1. **配置豆包语音,由Agent生成本期MP3。** 说明需要开通语音服务、通过安全入口配置语音API Key,并提供准确的speaker ID和模型资源resource_id;Agent负责检查及配置本地调用端,确认本期音色、资源、语速和朗读范围后合成。复刻音色的可选model与resource_id分别记录,不继承个人默认音色。
2. **用户自备本期最终MP3。** 接收文件或本地路径,由Agent核验音频、用本机Coli转录并核对全文,再接续带时间分镜、配图和草稿;不要求用户手工制作SRT。
可直接询问:“这期配音用哪种方式:配置豆包语音,由我生成MP3;还是你提供本期最终MP3?”同时说明Key通过安全入口配置,不在聊天中粘贴。
用户已提供可用音频、已选择上述路径或已确认本期配音参数时沿用,不重复询问。等待选择期间继续不依赖音频的工作;未收到选择不默认同意合成,不发送付费请求。仅维护本技能、独立插图/封面/静态图文、明确不依赖音频的文本分镜不触发本规则。用户要求全部重新制作或禁止复用旧素材时,应按“没有可用的本期最终配音”处理,不以旧项目音频代替本次选择。
配音前确认本期准确音色、资源、语速和朗读范围;本次已明确确认的参数不重问。Key只从宿主安全配置或技能目录之外的专用凭据存储读取,不写入项目或开源文件。用户需完成服务开通、Key获取及音色授权;依赖安装和本地配置由Agent完成。配置后用定稿生成MP3,再执行Coli转录、分镜、配图和草稿。已有最终音频优先复用。配音配置不自动开启未请求的配图或草稿,也不恢复火山字幕服务。
## 配图
仅 illustrate 开启时读取 [配图模块](modules/history-image/GUIDE.md)。保留三种模式:
| 请求 | `image_mode` | 交付边界 |
| --- | --- | --- |
| 按文稿拆镜、给其他 AI 生图 | `storyboard` | 完整分镜与独立提示词,不生图 |
| 完善已有分镜提示词 | `prompt` | 保留镜号和边界,不生图 |
| 生成图片、补图、改图 | `generate` | 只生成指定范围并检查实际图片 |
“只配图”且无法判断层级时询问要分镜提示词还是实际图片;等待期间可分析全文与时代。提示词、预期图片文件名和模型字段均不构成生图授权。
配图画风使用独立的 `style_id`:历史写实 `historical-realism`、厚涂历史漫画 `historical-comic`、黑白叙事 `monochrome-narrative`。本项目未选择时询问,等待期间可做无画风草稿;不能按写作风格、赛道或旧文件夹名称擅自选择。
实际生图前读[正文画风参考图库](modules/history-image/references/style-reference-library.md),按已确认画风选同组参考并实际查看;工具支持时传入图片,固定本项目主基准,首张对照核验后再继续。记录参考ID、用途与实际传入状态。厚涂漫画和黑白叙事各附6张正文参考,历史写实暂用文字规则或本期匹配参考;图库人物不能代替本期身份与时代依据,封面另用封面参考。
口播项目遵守 **定稿 → 豆包配音或已有最终配音 → 本机Coli转录并核对 → 带时间分镜 → 生图 → 按同表剪辑**。已有且已核验的当前配音字幕可复用。缺音频时按配音衔接规则引导;尚未配置或未确认音色时只准备待对齐草稿,不编造时间。明确的独立插图、封面、静态图文或纯文本分镜按模块例外完成。
保留模块的封面规则:完整 generate 请求按所选画风处理封面,黑白叙事默认无封面;只做分镜/提示词不出封面,补图不重复生成已有封面。用户指定数量与不要封面的选择优先。首次实际生图时按模块询问是否需要开头首尾帧,未回答不增加这项产物,不阻挡已授权正文图。
## 剪映草稿
仅 draft 开启时读取 [草稿模块](modules/render-history-video/GUIDE.md) 及其语义核验、节奏与剪映说明。用户只调用 story-studio 即可;内部调用本技能的导出脚本。
- 复用已有文稿、音频、SRT、分镜和图片;关闭配图仍可为既有图片补做必要的 Coli 转录、音文与语义核验,不另写新稿或生新图。
- 使用上游已核验的显示 start/end 和图片映射,不重新均分。首镜从0秒显示,末镜覆盖完整配音;实际图片须与当前口播人物、时期及事件相符。
- 缺图、图错或关键时间无依据时完成诊断和可行修复,标明缺口,不交付为已核验成品;不暗中调用生图。缺少封面不阻挡正文草稿。
- 导出前用配置的Python运行 `"<story-studio目录>/scripts/check_handoff.py" "<版本目录>/plan.json" --review "<版本目录>/semantic_alignment.json"`。该工具检查计划、图片版本与语义记录的交接一致性,不替代人工查看图片和核对音文。退出码非0先处理,不直接导出。
- 默认竖屏1080×1920、30fps、整段配音、无显示字幕,推拉与切点缩放复用模块规则;用户明确要求优先。字幕用于定位不等于要上屏。
- 默认只出剪映草稿。除非用户明确要求本地 MP4,不因剪映不可用自动改走 ffmpeg 成片。
- 剪映导出直接调用 `pyJianYingDraft==0.3.1`。草稿目录优先使用 `--drafts-root`,其次 `JY_PROJECTS_ROOT` 或外部runtime配置,再读取剪映的草稿位置设置;新安装使用标准目录。已有自定义配置仍无法识别时由Agent查看剪映设置核对,不先要求用户复制路径。依赖缺失按自动初始化流程补齐。
- 修订使用新版本和新草稿名,默认不覆盖旧草稿;不要自动操作剪映10.x导出成片。
## 共用约束与交付
- 本机 Coli 是字幕路径;不调用火山字幕 API,不恢复其凭据,不用字符比例伪造精确时间。
- 内置模块是本技能的使用副本。模块文中的“本 skill 目录”指其 GUIDE.md 所在模块目录;`<story-studio目录>` 才是总技能根目录。使用实际绝对路径执行脚本。
- 总入口的阶段范围和事实规则优先于模块默认值。单个示例和验证结论不扩展为新赛道已验证能力。
- 本技能不携带作者账户或同步授权;创作或维护不自动推送、发布或修改其他安装副本。
- 技能源码、示例和语料索引仅保存通用参数与库内相对路径;不保存使用者的真实姓名、电脑用户名、联系方式、账户标识、私人文件位置、凭据或会话记录。运行配置从当前参数、外部环境或工具配置读取,不写回技能目录。
- 初始化在当前用户的数据目录保存配置和专用工具,不修改全局环境变量或其他技能源码,默认保留已有草稿。macOS/Linux的原生媒体库可通过系统包管理器安装,所需系统授权按实际环境处理。依赖下载失败或版本不兼容时修复具体问题,不静默切换其他实现。
- 根据实际完成情况交付文件链接,区分文稿、分镜提示词、已生成图片和草稿;说明待音频、缺图或未解决事项。关闭的阶段不写成已完成。
- 交付前攻击并修正最可能的3–5个问题:越过开关、事实或文风串用、音图版本错配、时代与人物漂移、时间轴或素材丢失。用字数、覆盖、时间与实际产物检查提供证据,不把文件存在或数值通过当作内容验收。
## 调用示例
```text
使用 $story-studio,只写一篇秦怡的人物故事口播稿,玉玲风格,约1500字。
```
```text
使用 $story-studio,把这篇定稿生成豆包MP3,再做Coli字幕、20张历史写实配图和竖屏剪映草稿。缺少语音配置时引导我提供API Key、音色ID和模型资源。
```
```text
使用 $story-studio,写作关、配图开、剪映草稿关。
用这个项目的定稿和最终配音,黑白叙事风,拆20镜,只出分镜和提示词。
```
```text
使用 $story-studio,把这个文件夹里的已有图片、分镜和配音做成剪映草稿。
写作关、配图关,不加字幕。
```
讨论
提问、分享技巧或报告无法使用。按“有帮助”数量排序。
来自 GitHub
- GitHub 星标
- 1,153
- 开发者
- konlu
- 许可证
- 未注明许可证 此 repo 未注明许可证,默认作者保留所有权利;转发或商用前请先询问作者。
- 最近代码更新
- 2026年11月13日
- repo 中的 SKILL.md 文件(含译本和模板)
- 1