SKILL.md 9.26 KB

description: 从素材(新闻、故事、段子等)自动生成 classic 互动剧本(含角色图、场景图)并写入数据库

create-drama — 从素材自动生成完整 classic 互动剧本

根据用户提供的内容素材(新闻、故事、段子、历史事件等),生成一个完整的 classic 类型互动剧本,包括:

  • 剧本数据(角色、台词、表情、动作)
  • 角色立绘图(AI 生图 → 去背景 → 上传 OSS)
  • 背景图和封面图(AI 生图 → 上传 OSS)
  • 写入数据库

输入

用户会在 $ARGUMENTS 中提供内容素材。素材可能是:

  • 一段新闻报道
  • 一个故事/段子
  • 一个历史事件描述
  • 一个创意想法
  • 一个文件路径(需要先读取文件内容)

执行步骤

第 1 步:分析素材

仔细阅读用户提供的素材内容。如果是文件路径,先用 Read 工具读取文件。

第 2 步:生成完整剧本 JSON

根据素材内容,你自己(Claude)直接生成剧本数据 JSON。不要调用任何外部 LLM API。

生成的 JSON 必须严格遵循以下格式:

{
  "name": "剧本名称(简短,2-6个字)",
  "title": "显示标题(可以带 emoji,稍微长一点)",
  "subtitle": "— 副标题 —",
  "description": "剧本简介(一句话概括)",
  "systemPrompt": "用于后续 AI 续写的系统提示词(详见下方规则)",
  "isPublic": false,
  "userId": 1,
  "tags": "标签1,标签2,标签3",
  "language": "内容语言:en / zh / multi",
  "characters": [
    {
      "name": "角色名",
      "gender": "male 或 female",
      "voiceId": "从音色列表选择",
      "imagePrompt": "角色立绘生图 prompt(详见下方规则)"
    }
  ],
  "script": [
    {
      "character": "角色名(必须在 characters 中定义过)",
      "dialogue": "台词内容",
      "avatar": "表情文件名",
      "instruction": "(可选)语音情感指令,如 '用愤怒的语气说'、'ASMR 低语'、'质问的语气' 等",
      "action": "动画效果",
      "position": "left 或 right"
    }
  ],
  "backgroundPrompt": "背景图生图 prompt",
  "coverPrompt": "封面图生图 prompt"
}

生成规则

角色 (characters)

  • 数量:2-5 个
  • 每个角色必须有 name、gender、voiceId、imagePrompt
  • voiceId 选择:参考 reference.md 中的完整音色列表
    • 所有 2.0 音色统一支持 9 种情感(happy/sad/angry/surprised/fear/hate/excited/coldness/neutral)
    • 根据角色性格、年龄、性别匹配合适的音色
    • 常用推荐:
    • 男主角: zh_male_m191_uranus_bigtts(云舟)或 zh_male_ruyayichen_uranus_bigtts(儒雅逸辰)
    • 女主角: zh_female_cancan_uranus_bigtts(知性灿灿)或 zh_female_meilinvyou_uranus_bigtts(魅力女友)
    • 少年/年轻男: zh_male_shaonianzixin_uranus_bigtts(少年梓辛)或 saturn_zh_male_shuanglangshaonian_tob(爽朗少年)
    • 甜美/撒娇女: zh_female_sajiaoxuemei_uranus_bigtts(撒娇学妹)或 zh_female_tianmeitaozi_uranus_bigtts(甜美桃子)
    • 成熟男: zh_male_dayi_uranus_bigtts(大壹)或 zh_male_sophie_uranus_bigtts(魅力苏菲)
    • 搞笑/IP: zh_male_sunwukong_uranus_bigtts(猴哥)或 zh_female_peiqi_uranus_bigtts(佩奇猪)
    • 英文男: en_male_tim_uranus_bigtts(Tim)
    • 英文女: en_female_dacey_uranus_bigtts(Dacey)或 en_female_stokie_uranus_bigtts(Stokie)

角色立绘 imagePrompt

每个角色必须生成 imagePrompt,遵循以下模板:

生成一张**[人物名字或身份]**的全身站立画像。
核心风格:沙雕动漫风格(meme style),2D简笔画,线条清晰粗犷,色彩平涂,带有幽默滑稽感,略微的大头小身体比例。
脸部要求(最重要):脸部必须是纯肉色的完全空白,绝对不要画眼睛、鼻子、嘴巴或眉毛等任何五官,保留一个干净完整的面部轮廓,方便后期添加表情包。
服装与动作:角色穿着**[根据角色描述填写服装特征],手里拿着[根据角色身份推断合适的道具],[一个有趣的站姿或动作]**。
背景要求:纯色干净背景(如浅蓝灰色),不要任何环境元素或杂物,边缘清晰,方便直接抠图。

根据角色具体描述,在 [] 处填入合适内容。

背景图 backgroundPrompt

横版宽屏场景背景图,卡通风格,适合互动剧背景。场景:[根据剧本内容描述场景]。不要人物,色彩鲜明,气氛感强。

封面图 coverPrompt

剧目封面海报。标题:[剧本标题]。展示[角色名]等角色的剪影轮廓,色彩鲜明,有标题感,卡通风格。

台词 (script)

  • 数量:10-20 句(根据素材丰富度调整,尽量多一些,让剧情完整)
  • avatar 可选值:normal.png, happy.png, very_happy.png, angry.png, sad.png, cry.png, shock.png, smirk.png, speechless.png
  • action 可选值:
    • none — 默认,无动画
    • shake — 震动,适合愤怒/惊吓/强调
    • jump — 跳跃,适合惊喜/激动
    • spin — 旋转,适合混乱/搞笑
    • zoom-in — 放大,适合重要台词/特写
  • instruction(可选):语音情感指令,用自然语言描述这句台词的语气/情绪/表达方式
    • 如:"用愤怒的语气说"、"ASMR 低语"、"质问的语气"、"开心地大喊"
    • 会传给 TTS 引擎的 seed-tts-2.0-expressive 模型,增强语音表现力
    • 对于情绪强烈的台词建议添加此字段
  • position: 每个角色应该有固定站位(left/right),2个角色时一左一右,3个以上轮替
  • 台词要生动有趣,符合互动剧的沙雕风格
  • 对话要有戏剧冲突和反转
  • 每句台词不要太长,控制在 30 字以内

systemPrompt

  • 要详细描述世界观和角色设定
  • 包含语言风格指导(用于后续 AI 续写对话)
  • 至少 200 字

tags

  • 1-3 个标签,逗号分隔
  • 如:搞笑,职场,反转

language

  • 内容语言标识:en(英文)、zh(中文)、multi(混合)
  • 根据素材语言自动设置

第 3 步:写入临时 JSON 文件

将生成的 JSON 写入临时文件 /tmp/drama_<timestamp>.json

第 4 步:生成图片并上传 OSS

找到本 skill 的目录路径(即本文件 SKILL.md 所在目录),执行图片生成脚本:

node <skill目录>/generate-images.js /tmp/drama_<timestamp>.json

该脚本会:

  1. 为每个角色生成立绘图(Jimeng → fallback Nano Banana Pro)
  2. 自动去背景(rembg)
  3. 为剧本生成背景图和封面图
  4. 全部上传到阿里云 OSS
  5. 将 URL 写回 JSON 文件(更新 characters[].bodyUrl, coverUrl, backgroundUrl)

注意:该脚本需要 ali-oss, sharp npm 包以及 rembg Python 工具。如果 rembg 未安装,会跳过去背景步骤。

第 5 步:写入数据库

执行入库脚本:

node <skill目录>/insert-drama.js /tmp/drama_<timestamp>.json

脚本会在事务中创建:

  • dramas 表记录(剧本元数据)
  • drama_characters 表记录(角色配置 + 身体图 URL + 音色)
  • drama_emotions 表记录(默认表情映射)
  • drama_scripts 表记录(台词序列)

第 6 步:清理并输出结果

  1. 删除临时 JSON 文件
  2. 告知用户:
    • 剧本名称和 dramaKey
    • 角色列表及音色
    • 台词数量
    • 图片生成结果(成功/失败)
    • 简要剧情概述

配置说明

脚本会自动从以下位置加载配置(按优先级):

  1. --env <path> 参数指定的 .env 文件
  2. 环境变量 DRAMA_ENV_PATH 指定的 .env 文件
  3. skill 目录下的 .env 文件
  4. 已有的环境变量

所需配置项:

# 数据库
DB_HOST=127.0.0.1
DB_PORT=3306
DB_USER=root
DB_PASSWORD=xxx
DB_NAME=shadiao_drama

# 阿里云 OSS(图片上传)
OSS_REGION=oss-cn-beijing
OSS_ACCESS_KEY_ID=xxx
OSS_ACCESS_KEY_SECRET=xxx
OSS_BUCKET=xxx
OSS_ENDPOINT=https://oss-cn-beijing.aliyuncs.com

# 万界生图 API
WANJIE_API_KEY=xxx

注意事项

  • 自动检测语言:根据素材的语言自动决定输出语言。中文素材生成中文内容,英文素材生成英文内容,并在 JSON 中设置对应的 language 字段(zh/en/multi)
  • 英文内容必须使用英文音色(Tim, Dacey, Stokie)
  • 风格偏沙雕搞笑,但要保留素材的核心信息
  • 如果素材是严肃新闻,可以用吐槽/解说风格改编
  • 角色名字要有趣,符合素材主题

复用到其他项目

整个 create-drama/ 目录是自包含的,复制到其他项目的 .claude/skills/ 即可使用。

前置条件:

  1. Node.js 依赖:npm i -g sequelize mysql2 ali-oss sharp
  2. Python 工具:pip install rembg(可选,用于角色图去背景)
  3. 在 create-drama/ 目录下修改 .env 配置

目录结构:

.claude/skills/create-drama/
├── SKILL.md              # Skill 定义(本文件)
├── reference.md          # 完整音色参考文档
├── insert-drama.js       # 数据库入库脚本
├── generate-images.js    # 图片生成 + 去背景 + OSS 上传脚本
└── .env                  # 数据库 + OSS + 生图 API 配置

Additional Resources