drama-skills

1. 基本信息

项目	内容	数据来源
名称	drama-skills	—
作者/维护者	worldwonderer（pitechen）	GitHub API
来源链接	https://github.com/worldwonderer/drama-skills	—
许可证	MIT	GitHub API
GitHub Stars / Forks	383★ / 160 forks	GitHub API
最新版本	v0.2.0（2026-07-27，语义化版本）	GitHub Releases
安装方式	让 Claude Code / Codex 等支持仓库导入的 Agent 直接安装，或克隆后手动软链接 8 个技能目录	仓库 README

2. 功能介绍与亮点

drama-skills 是一套面向竖屏短剧/漫剧创作的技能组合，把一个点子或一份长篇小说材料，沿着“故事开发 → 分集剧本 → 资产决策 → 图片提示词/分镜 → 视频提示词 → 独立审查”六个阶段推进，最终打包成文本交付包。核心设计：

八个技能同级安装、各自自包含：入口路由技能 short-drama 负责初始化、状态管理与任务分派，其余七个技能各自处理一个制作环节，互不读取对方文件，共享规则按阶段切片内联到各自的参考文档中。
规则体系分四级：87 条规则区分“结构不变式”“需证据判断”“通常有帮助的做法”“创作者选择”，配 10 张题材手册（按压力来源、人物策略、观众回报选写法）与 6 张制作形态卡（实拍、2D 动态漫、风格化 3D、水墨等），把同一故事意图翻译成不同制作形态下的形、层、材质、光、动作与声音。
跨环节连续性契约：资产、分镜、视频提示词三处各自维护同一套连续性规则（CON-*），测试强制三份定义完全一致，避免跨环节口径漂移。
确定性脚本校验结构，不评价创作质量：本地 Python 脚本核对结构化引用 hash、单集时长算术、镜头容器归属等可机器判定项；台词读起来顺不顺、镜头拆得对不对仍由人工审查负责。
独立审查机制：审查阶段要求切换到全新上下文（fresh reviewer），避免“自己写、自己审”；运行环境不支持时会透明降级为 PROVISIONAL 自检，而不是静默当作已审查通过。
明确边界：当前版本只产出剧本、资产说明、分镜、提示词与审查记录等结构化文本，不调用真正的图片、视频或音频生成服务，产物中也不出现供应商与模型产品名。

3. 适用场景

固定分类：内容创作与知识管理

面向短剧编剧、漫剧工作室与编导：把一个故事点子或改编自小说的长篇材料，系统化推进为可执行的分集剧本、角色/场景/道具资产设定、分镜与关键帧描述、视频生成提示词，并附带独立审查记录。也适合需要在多集之间统一连续性规则、多人协作交接的短剧制作团队。

4. 跨 Agent 兼容性

Claude Code：✅ 原生支持——README 提供软链接到 ~/.claude/skills/ 的具体步骤，调用语法为 /short-drama 等斜杠命令，也可直接用自然语言描述任务。
Codex：✅ 原生支持——README 提供软链接到 ${CODEX_HOME:-~/.codex}/skills/ 的具体步骤，调用语法为 $short-drama 等。
OpenClaw：❓ 未验证——README 仅笼统提及“其他支持 Agent Skill 规范的运行环境”，未点名验证。
Hermes Agent：❓ 未验证——同上。

5. 推荐理由

多数短剧/内容创作类技能只覆盖单一环节——要么写剧本，要么生成图片提示词——drama-skills 把短剧全制作链路（故事开发、分集剧本、资产、图片与视频提示词、独立审查）串成一套共享连续性契约的技能组合，并用确定性脚本而非模型判断守住结构一致性（时长算术、连续性引用 hash、镜头容器归属），审查阶段刻意引入“新鲜上下文”机制防止自审自过。作者同时维护多个高星内容创作类仓库，工程规范成熟（语义化版本、详尽 CHANGELOG、测试目录），适合需要批量产出竖屏短剧/漫剧文本资产、且希望保持跨集连续性的创作者或团队。

6. 评分

维度	分数	说明
受欢迎程度	6	383 stars / 160 forks，fork 占比约 42%（短剧类项目里少见的高参与度信号）；仓库创建于 2026-07-16，两周多内积累当前热度，属近期快速增长
可用性	8	需要 Python 3.10+ 环境；提供“让 Agent 直接导入 GitHub 仓库”与“手动软链接 8 个技能目录”两种安装路径；README、CHANGELOG、CONTRIBUTING、demo 示例齐全，遵循语义化版本（当前 v0.2.0）；发布前一天仍有提交，维护活跃
安全性	9	检查清单详见下表

安全检查清单：

① shell 命令及权限范围：抽查的本地 Python 脚本（project_tool.py、screenplay_index.py、storyboard_check.py 等）仅做结构化校验（引用 hash 格式、路径命名、时长算术），未见网络请求、subprocess、eval/exec 等高危调用
② 运行时是否联网外发数据：无。仓库 README 与正式 Release 说明均明确声明当前版本不调用任何图片/视频/音频生成服务或供应商接口
③ API key/凭据：不需要
④ 可疑指令：抽查脚本与 SKILL.md 全文未见混淆代码或 prompt injection 迹象
⑤ 作者/组织信誉：worldwonderer（pitechen）GitHub 账号 2019 年注册，另维护多个内容创作类仓库（含一个近 5000 星的网文写作技能包），非小号刷量特征
⑥ License：MIT，明确
⑦ 最近维护：发布前一天仍有提交，v0.1.0/v0.2.0 两次正式版本发布均在近一周内完成

7. 跟同类 Skills 相比的优势

对比对象	定位	与本技能的差异
Pluviobyte/video-production-skills	面向单条视频的动效复刻与 HyperFrames/Remotion 组件库沉淀	只处理成片动效层面，不覆盖剧本、分集、资产连续性；是单点视频工具而非叙事内容全链路
worldwonderer/oh-story-claudecode（同作者姊妹项目）	面向长篇/短篇网络小说全流程：扫榜、拆文、写作、去 AI 味、封面图	产出对象是小说文本本身，不产出分镜与视频提示词，不面向影视化改编
iart-ai/motion-skills	50 个开源动效制作技能，覆盖数据可视化、解释视频、短视频动效	面向通用动效制作（如数据可视化动画），不针对短剧叙事的角色/场景/连续性设定

8. 用户评价

该技能目前在第三方平台尚无成篇的用户评价文本；可查证的社区互动是 GitHub 用户 rocke 在 Issue #5 中就“小说改编该用哪个技能初始化”提出的使用咨询，反映出已有真实用户在尝试小说改编场景。

9. 其他补充

README 提供中英双语版本（README.md / README_EN.md）。仓库另含一个面向贡献者的 maintainers/skills/short-drama-knowhow 技能，用于规范新增题材卡、形态卡或规则条目的提交格式，是社区扩展规则库的入口。当前仓库贡献记录仅作者本人，尚未形成多人协作的活跃维护团队。

10. 安装使用方式

方式一：Agent 直接导入

安装这个技能套件 https://github.com/worldwonderer/drama-skills

方式二：手动软链接

git clone https://github.com/worldwonderer/drama-skills.git && cd drama-skills

# Claude Code
mkdir -p "$HOME/.claude/skills"
for skill in skills/*; do
  ln -s "$PWD/$skill" "$HOME/.claude/skills/$(basename "$skill")"
done

# Codex
mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
for skill in skills/*; do
  ln -s "$PWD/$skill" "${CODEX_HOME:-$HOME/.codex}/skills/$(basename "$skill")"
done

前置要求 Python 3.10 及以上版本。安装后从入口路由技能开始（Claude Code 用 /short-drama，Codex 用 $short-drama），也可直接调用具体阶段技能；已存在同名技能时应先移除旧链接，避免新旧版本混装。

11. 注意事项

当前版本只产出文本与结构化提示词，不调用真正的图片、视频、音频生成服务，需要自行对接生成工具才能落地成片
需要 Python 3.10 及以上版本，macOS 自带的 3.9 不满足要求
OpenClaw、Hermes Agent 暂无官方兼容性验证
独立审查阶段在不支持“新鲜上下文”的运行环境中会降级为 PROVISIONAL 自检，不等同于真正的独立审查，产出前建议人工复核
8 个技能目录需保持同级安装，混装不同版本会被安装校验拒绝
目前仅作者本人贡献代码，尚未形成多人协作的活跃社区