AI 短剧编剧
以繁体中文完成短篇/竖屏短剧的选题、结构、角色、分场、台词、冲突、反转、格式与修改。
GitHub Release v0.1.0 · MIT License
ai-short-drama-screenwriter 是一个可供 ChatGPT 桌面版 Codex、Codex CLI 与 IDE extension 使用的 standalone skill。它把故事前提与制作限制整理成可见、可听、可拍摄,且有明确戏剧推进的短剧内容。
项目解决什么问题
一般 AI 短剧草稿常见以下问题:
- 故事只有概念,缺乏可持续推进的角色目标、阻力与代价。
- 角色转变没有前置事件,人物动机在场次间跳跃。
- 台词只解说背景,缺少试探、回避、反应与潜台词。
- 反转没有前文线索,集尾只中断事件而没有下一步问题。
- 场次缺少内外景、地点或时间,难以直接进入制作。
- 使用者只要求剧本,输出却越界加入分镜或影片模型提示词。
本技能用明确的任务路由、八阶段编剧流程、标准短剧格式与修改清单,让输出保持可拍性、叙事推进与交付范围一致。
主要功能
- 完整编剧流程:创作简报、题材定位、全剧与单集结构、角色关系、分场、台词、冲突/情绪/反转/钩子、初稿与修改。
- 单点创作:只处理指定的选题、结构、角色、分场、台词、冲突、反转或格式,不强制重做完整项目。
- 标准短剧格式:支持场次、内景/外景、地点、时间、动作、角色名称、台词及画面文字。
- 剧本审阅与修改:按影响程度提供问题、段落证据、造成的影响与可执行修正方向。
- 限制保持:保留使用者指定的集数、时长、观众、类型、平台、预算、场景与交付形式。
- 繁体中文输出:预设使用繁体中文;其他语言可在提示中指定。
- 跨技能衔接:混合需求先完成剧本,再衔接环境中已安装且适用的分镜或影片提示词技能。
安装方法
前置条件
- 已安装 Git。
- 已安装支持 standalone skills 的 ChatGPT 桌面版 Codex、Codex CLI 或 IDE extension。
Codex 的个人技能位置为 $HOME/.agents/skills。每个技能都必须是独立资料夹,且资料夹内直接包含 SKILL.md。详见 OpenAI 官方技能文件。
Windows PowerShell
git clone --depth 1 https://github.com/POUND0423/AI-drama-pound.git
$repoPath = Join-Path (Get-Location) 'AI-drama-pound'
$skillPath = Join-Path ([Environment]::GetFolderPath('UserProfile')) '.agents\skills\ai-short-drama-screenwriter'
New-Item -ItemType Directory -Force -Path $skillPath | Out-Null
Copy-Item -Path (Join-Path $repoPath 'skill-src\ai-short-drama-screenwriter\*') -Destination $skillPath -Recurse -Force
Test-Path (Join-Path $skillPath 'SKILL.md')
最后一行应输出 True。
macOS/Linux
git clone --depth 1 https://github.com/POUND0423/AI-drama-pound.git
mkdir -p "$HOME/.agents/skills/ai-short-drama-screenwriter"
cp -R "AI-drama-pound/skill-src/ai-short-drama-screenwriter/." \
"$HOME/.agents/skills/ai-short-drama-screenwriter/"
test -f "$HOME/.agents/skills/ai-short-drama-screenwriter/SKILL.md" \
&& echo "Skill installed"
成功时会输出 Skill installed。Codex 通常会自动侦测技能;若没有出现,请重新启动 Codex。
使用方法
显式呼叫
在提示中直接加入技能名称:
使用 $ai-short-drama-screenwriter,把以下故事前提规划成 8 集、每集 90 秒的都市悬疑短剧。主要场景不超过 3 个;先提供创作简报、角色关系、全剧节拍与第一集剧本。
故事前提:外送员每天替一位失忆老人送餐,最后发现老人可能是失踪多年的外公。
隐式呼叫
也可以直接提出符合技能范围的需求,例如:
只修改这段短剧重逢戏的台词,增加潜台词,不要重做人物设定或全剧大纲。
技能允许隐式启动;是否启动取决于请求是否符合 SKILL.md 的使用范围。
输入输出示例
输入
使用 $ai-short-drama-screenwriter,将「外送员替失忆老人送餐,逐渐发现老人是失踪多年的外公」发展成 8 集都市悬疑短剧。每集 90 秒,主要场景不超过 3 个。请提供必要假设、创作简报、角色关系、全剧节拍与第一集剧本。
输出节录
必要假设
- 观众:偏好都市情感悬疑的短剧观众
- 制作限制:主要场景为外送站、老公寓与主角家
创作简报
- 类型:都市温情悬疑
- 主角目标:确认老人身份,同时查明家人隐瞒的往事
- 主要阻力:老人记忆破碎,主角母亲阻止他继续调查
角色关系
- 阿泽:外送员;从同情老人转为追查自己的家族秘密
- 陈伯:失忆老人;保留与阿泽童年有关的零碎记忆
- 美玲:阿泽母亲;知道老人身份,但害怕旧事再次伤害家人
全剧节拍(节录)
- 第 1 集:阿泽在老人门口捡到自己童年的照片;母亲要求他停止送餐。
- 第 4 集:老人短暂恢复记忆,叫出阿泽父亲的名字。
- 第 8 集:阿泽确认血缘真相,必须决定公开秘密或保护母亲。
第 1 集
1. 内景・老公寓走廊・夜
阿泽提着餐袋停在 302 室门前。门缝下压着一张泛黄照片。
照片里,五岁的阿泽坐在一名男子肩上。男子的脸被撕掉一半。
阿泽
陈伯,您的晚餐到了。
门内传来老人颤抖的声音。
陈伯(OS)
小泽,你终于回来了。
阿泽僵住。他从未告诉老人自己的小名。
切黑。
实际输出会依故事前提、限制与指定交付形式改变,不保证与示例逐字相同。
功能边界
- 只要求剧本时,不输出逐镜分镜、景别、运镜或 AI 影片模型参数。
- 本仓库不包含分镜或影片提示词技能;混合交付需要环境中另有适用技能。
- 涉及当前平台偏好、算法或市场趋势时,必须先查证,不能把旧信息当成现况。
项目结构
AI-drama-pound/
├── skill-src/ai-short-drama-screenwriter/
│ ├── SKILL.md
│ ├── agents/openai.yaml
│ └── references/
│ ├── workflow.md
│ ├── format.md
│ └── checklists.md
├── validation/ai-short-drama-screenwriter/
├── docs/superpowers/
├── LICENSE
└── README.md
验证状态
- RED 基线测试:记录没有技能时的格式缺口。
- GREEN 行为测试:四个情境最终全部通过。
- 触发边界微测试:A–F 最终各为 5/5。
- 官方技能结构验证:通过。
常见问题
安装后找不到技能
确认以下文件直接存在:
$HOME/.agents/skills/ai-short-drama-screenwriter/SKILL.md
若路径正确但技能仍未出现,重新启动 Codex。
可以直接产生分镜或影片提示词吗?
此技能本身负责短剧编剧。若同时要求剧本与分镜或影片提示词,它会先完成剧本,再尝试衔接环境中已安装的适用技能。
授权
本项目采用 MIT License。