源码系统概览
文章正文
drama-skills 是一套面向编剧、漫剧工作室与编导的 AI 短剧创作技能套件，作者 worldwonderer。
它把一个点子或长篇原著，沿着可被智能体执行的工作流，逐步发展成结构化的分集剧本、资产设定、图片参考提示词、分镜关键帧、视频生成提示词以及独立的审查记录。
整套工具以 Markdown 技能文档加 Python 校验脚本的形式交付，适配 Claude Code、Codex 以及其他支持 Agent Skill 规范的运行环境，本身不调用任何真实的图像、视频或音频生成服务，只产出可被人工或下游工具消费的文本成果。
源码简介
该仓库包含八个同级安装的技能目录，彼此互不读取对方文件，依靠一套阶段切片内联的契约保持协同。
入口路由技能 short-drama 负责项目的初始化、继续、异常恢复、接受与审查生命周期以及最终交付；
short-drama-develop 处理小说或长材料的改编、故事引擎、分集地图与导演阐述；
short-drama-write 产出单集目标、因果节拍与可拍摄剧本；
short-drama-assets 做人物造型、地点视图与道具状态的连续性决策；
short-drama-image-prompts 与 short-drama-storyboard 分别负责资产参考图提示词与本镜关键帧提示词；
short-drama-video-prompts 把分镜逐镜翻译成视频提示词；
short-drama-review 执行结构校验、带证据的内容审查与独立结论。
仓库另含 tools 目录下的确定性脚本与一整套 tests，强制多条连续性规则在资产、分镜、视频提示词三处保持一致。
适用场景
这套技能套件适合需要把创意稳定落地的短剧与漫剧生产团队。
编剧可以用它把长篇小说或大纲拆成带因果节拍的分集剧本；
导演与美术可以用它沉淀人物、场景、道具的资产设定，并统一参考图与分镜的视觉锚点；
视频团队可以拿到逐镜的动作、表演、摄影、声音与起止状态提示词，直接喂给图像或视频生成工具；
独立创作者也能仅凭自然语言在智能体里完成从点子到可交付文本包的全过程。
它尤其适合需要多人协作、强调剧情连续性与来源引用的中短篇影视内容生产。
功能亮点
其一，全链路贯通：从故事开发、分集剧本、资产、图片提示词、分镜、视频提示词到独立审查，每个环节都有明确的交付物与契约。
其二，连续性契约：精确记录相邻镜头的已确认边界，提示词只重复当前执行必需的局部锚点，以项目记录作为跨环节协作依据。
其三，自包含与解耦：八个技能同级安装但互不越权读取，路由技能只按技能名分派任务，确定性由测试守护。
其四，质量门禁：结构校验、带证据的内容审查与独立审查结论三道防线，配合 shipping boundaries 测试限制私有产物不外泄。
其五，题材与形态手册：按压力来源、人物策略与观众回报选择写法，并把实拍、2D 动态漫、风格化 3D、水墨等方向翻译成形、层、材质、光、动作与声音。
技术架构与部署指南
| 维度 | 本套源码 | 同类通用方案 |
|---|---|---|
| 技术栈 | 前端：Markdown 文档与提示词模板驱动，无独立前端界面，运行于 Claude Code、Codex 等智能体客户端 | 依具体方案选型，需自行搭建与维护 |
| 部署方式 | 运行确定性脚本需要 Python 3.10 或更新版本，版本过低时脚本会直接给出清晰提示而不会抛出晦涩的导入错误。 | 多托管于第三方平台或订阅云服务 |
| 功能侧重 | 其一，全链路贯通：从故事开发、分集剧本、资产、图片提示词、分镜、视频提示词到独立审查，每个环节都有明确的交付物与契约。 | 功能通用，定制深度有限 |
| 数据归属 | 数据自持，部署在自有服务器，不出站 | 数据通常留存于服务商侧 |
| 成本模式 | 获取后自主部署，无持续授权费用 | 通常按订阅或调用量计费 |
技术栈与运行环境
前端：Markdown 文档与提示词模板驱动，无独立前端界面，运行于 Claude Code、Codex 等智能体客户端。
后端：Python 3.10+ 确定性校验脚本，包括 project_tool、suite_verify、verify_suite、update_suite_manifest 等。
数据库：项目以本地 JSON 与 JSONL 文件存储剧本、资产、分镜与提示词，无外部数据库依赖。
运行环境：macOS、Linux 或 Windows，需 Python 3.10 及以上解释器，通过软链接安装到 ~/.claude/skills 或 ~/.codex/skills。
其他依赖：仅标准库与少量 PyYAML，无第三方重量级框架，无需联网即可完成文本交付。
安装与部署提示
运行确定性脚本需要 Python 3.10 或更新版本，版本过低时脚本会直接给出清晰提示而不会抛出晦涩的导入错误。
最简安装方式是直接告诉 Claude Code 或 Codex 等智能体「安装这个技能套件 https://github.com/worldwonderer/drama-skills」，由其自动导入；
也可以手动把仓库克隆后，将 skills 下的八个目录分别软链接到 ~/.claude/skills 或 ~/.codex/skills，注意八个技能目录必须保持同级、不要混装版本。
安装完成后从主路由技能 short-drama 开始，也可以按任务直接调用对应子技能；
Claude Code 用 /short-drama 写法，Codex 用 $short-drama 写法，或直接用自然语言描述需求。
截图与演示说明
本仓库以文本交付为主，没有传统后台界面，其「页面」就是技能文档与 demo 示例。
仓库 demo 目录下提供了完整的一集样例：EP001-剧本.md 展示可拍摄的分集剧本格式，EP001-资产设定.md 展示人物、场景与道具的资产决策，EP001-分镜.md 展示带镜头目的与连续性边界的分镜，EP001-视频提示词.md 展示逐镜视频生成提示词。
每个子技能目录下都有 SKILL.md 作为入口说明，references 存放阶段契约与规则表，scripts 存放对应的 Python 校验脚本，例如 short-drama/scripts/project_tool.py 负责项目初始化与交付包构建，short-drama-write/scripts/screenplay_index.py 负责剧本索引，short-drama-storyboard/scripts/storyboard_check.py 负责分镜结构校验。
创作者可对照 demo 与 SKILL.md 快速理解每个环节的产物形态。
常见问题
问：这套技能会直接帮我生成视频或图片吗？
不会。drama-skills 当前版本只交付剧本、资产说明、分镜、提示词、审查记录等结构化文本，不调用真实的图片、视频或音频生成服务；生成的提示词需要你自己交给相应的生成工具使用。
问：八个技能必须全部安装吗？
八个技能目录需要保持同级安装，路由技能 short-drama 会按技能名把任务分派给对应子技能；如果只安装部分技能，跨环节协作会不完整，建议在 ~/.claude/skills 或 ~/.codex/skills 下完整软链接 skills 目录。
问：对 Python 版本有什么要求？
运行仓库里的确定性校验脚本需要 Python 3.10 及以上；macOS 自带的 3.9 不满足要求，需要另行安装较新的解释器，否则脚本会在启动阶段就明确提示而非中途报错。
安全风险提示
特别提示：本源码未检测安全风险文件，下载后请务必进行安全审计，删除恶意代码后再部署使用！
下载说明
源码仅供学习研究、测试部署和二次开发参考，商用前请自行确认授权、版权和安全风险。
本仓库为 MIT 协议开源的 AI 短剧创作技能套件，所有交付物均为文本，不涉及用户数据采集、支付或对外服务，请在使用前自行确认所用智能体运行环境的安全配置。
下载后建议先阅读 README.md 与 demo 目录，再从主路由技能 short-drama 开始体验完整生产链路。
GitHub项目开源地址：https://github.com/worldwonderer/drama-skills