编剧技能：24 项影视写作智能体技能

编程软件可以快速生成场景。要写出能够持续维持冲突、控制信息、遵守格式并经得起修改的剧本，则要困难得多。开源的 jtydhr88/screenwriting-skills 仓库通过一个结构化的 24 项智能体技能库，填补了编剧、电视剧写作、舞台戏剧和戏剧学领域的这一空白。

该项目将 45 本创作类书籍和 23 部已出版剧本、乐谱与戏剧中的理念，转化为可复用的 SKILL.md 文件。这些文件为 Claude Code 和 OpenAI Codex 设计，但遵循智能体中立的 openagentskills.io 格式，因此任何兼容的智能体都有可能使用它们。

它解决了什么问题？

通用语言模型可能知道剧本需要主人公、冲突、场景和对白。但它仍可能生成充满说明性内容的对话、薄弱的幕尾、前后不一致的人物动机，或没有可重复故事引擎的电视剧集。

这些技能提供了更有纪律性的工作流程。与其要求智能体“把剧本写得更好”，编剧不如调用针对具体问题的能力，例如：

• 找出控制性主题并检验前提
• 搭建设定电影或剧集的结构
• 设计能够产生冲突的人物关系网
• 将对白重写为行动，而不是信息传递
• 将一集拆分为多个幕及幕尾
• 创建剧集圣经和提案文件
• 将小说改编为多集电视剧
• 分析已出版剧本和戏剧传统
• 在多次写作会话之间维护项目状态

最终得到的更像是一名了解创作技艺的写作助手，而不是普通的文本生成器。

安装

Claude Code 市场安装

推荐通过插件市场安装 Claude Code：

/plugin marketplace add jtydhr88/screenwriting-skills
/plugin install screenwriting@screenwriting-skills

随后即可使用 /screenwriting:<skill> 命名空间调用技能。例如：

/screenwriting:sw-dialogue

要查看当前环境中已加载的技能，请运行：

/skills

Claude Code：为所有项目安装

git clone https://github.com/jtydhr88/screenwriting-skills.git
cp -r screenwriting-skills/plugins/screenwriting/skills/* ~/.claude/skills/

Claude Code：在单个项目中安装

mkdir -p .claude/skills
cp -r screenwriting-skills/plugins/screenwriting/skills/* .claude/skills/

Codex 安装

对于 Codex CLI、ChatGPT 桌面应用或 IDE 扩展，添加市场并安装插件：

codex plugin marketplace add jtydhr88/screenwriting-skills

然后选择 Plugins → Screenwriting Skills → Install。

同样的 24 个 SKILL.md 文件通过插件共享的 skills/ 目录提供。并不存在单独重写的 Codex 版本。

个人 Codex 安装：

git clone https://github.com/jtydhr88/screenwriting-skills.git
cp -r screenwriting-skills/plugins/screenwriting/skills/* ~/.agents/skills/

项目专用安装：

mkdir -p .agents/skills
cp -r screenwriting-skills/plugins/screenwriting/skills/* .agents/skills/

你可以使用 $sw-story-structure 这样的命令显式调用技能，也可以让智能体自动识别相关上下文。

四层架构

该仓库将技能组织为四层。这一点很重要，因为长篇电影剧本、流媒体剧集、舞台剧和中国戏曲可能共享某些戏剧原则，却需要完全不同的结构和写作规则。

1. 通用戏剧学

与媒介无关的一层，涵盖各类项目都会用到的基础知识：

• sw-workflow：项目编排、交付物、阶段关卡，以及持久化的 story-bible.md 文件
• sw-story-structure：情节点、结构范式、节拍、复杂化因素、危机、高潮、支线、开场和结尾
• sw-premise-theme：前提检验、控制性主题、故事梗概、主题冲突和故事核心
• sw-character-conflict：人物心理、对立、人物编排和不断升级的冲突
• sw-dialogue：作为行动的对白、潜台词、说明性对白、人物词汇和逐句问题
• sw-scene-craft：价值转变、场景分析、节奏、转场、道具，以及迟入早出
• sw-format-adaptation：剧本格式、Fountain 输出、中日剧本规范、改编和修改

一个实用的长篇电影剧本工作流程可能从前提开始，依次经过结构、人物、场景、初稿、修改和投稿。工作流技能会在每个阶段指出相关技能，并定义建议性的退出检查。

2. 特定媒介写作

第二层加入一般编剧书无法完全传授的规则：

• sw-series-structure：前导、冷开场、广播剧幕结构、流媒体幕结构测试、幕尾、悬念、A/B/C 故事交织、试播集节拍和季结构
• sw-series-engine-bible：可重复的剧集引擎、人物关系网、试播集类型、故事雷区和提案文件
• sw-writers-room：拆解故事、剧集主创职责、编剧团队角色、文档链、意见、日程和制作限制
• sw-sitcom-comedy：半小时喜剧、笑点机制、反复笑料、冷开场、片尾梗、多机位、单机位、动画和喜剧剧情
• sw-chinese-series-practice：中国电视剧格式、分集悬念、改编流程、制作关卡、合同和内容边界
• sw-chinese-opera-banqiang：用于包括京剧、豫剧、越剧、秦腔、评剧和沪剧等传统的板腔体声腔系统
• sw-chinese-opera-qupai：用于元杂剧、明清传奇、昆曲和川剧高腔等形式的曲牌体系统

剧集层包含具体的时间参考，包括围绕第 17–18、30、45 和 60 页的广播剧幕锚点，以及以分钟标记的试播集拆解。它还涵盖一次性有效的故事与能够持续生成更多剧集的剧集引擎之间的实际差异。

3. 传统与行业

第三层将技巧置于文化和商业语境中：

• 美国长篇电影案例研究
• 日本编剧方法
• 韩国和法国写作路径
• 中国电视剧制作实践
• 行业、提案、版权选择、署名、经纪人、WGA 背景、面向买方的开发

当智能体需要比较不同方法，而不是提供一种所谓普适的公式时，这一层尤其有用。仓库保留了不同来源之间的分歧，例如 Douglas 的四幕结构表格，以及 Oberg 关于幕间断点主要由故事压力和制作现实决定的观点。

4. 完整作品语料库

最后一层将完整作品视为工作材料，而不仅是启发性范例。它包括：

• 契诃夫的全部长篇剧作和独幕剧
• 小津安二郎的六部剧本
• 《继承之战》的全部四季，共 39 份拍摄剧本
• 《白宫风云》《黑道家族》《唐顿庄园》《伦敦生活》等剧集的案例研究

例如，succession-series-writing 技能会分析压力密室、以仪式为容器的单集、持续下坠的羞辱、承载潜台词的舞台指示、由一个词触发的反转、替代台词，以及当主要引擎失去压力后如何设计结尾的挑战。

实际使用示例

编剧可以用自然语言请求使用该库：

把我的 12 集剧集拆分成多个幕，并安排幕尾。

这应该会路由到 sw-series-structure。

我的对白全都太直白了。诊断问题并重写这一场戏。

这会结合使用 sw-dialogue 和 sw-scene-craft。

把这部 40 万字的小说改编成一部 40 集中国电视剧大纲。

这需要调用 sw-chinese-series-practice 和 sw-series-engine-bible，并明确说明改编决策，而不是悄悄压缩原作。

帮我建立一个项目，并持续记录我的进度。

这正是 sw-workflow 的职责。它使用故事圣经规范，在不同会话之间保留项目状态。

为什么多语言设计采用单一源代码树

技能正文使用中文编写，因为许多素材来自中文原著或中文译本。不过，智能体的回答语言会遵循编剧的请求。编剧可以用英语、日语、韩语或法语提问，并以相应语言获得回答。

这样可以避免维护多个独立的翻译技能树。该项目过去曾有英文版本，但维护并行树会造成长期同步问题：一旦存在一种翻译，用户自然会继续要求日语、韩语、法语、俄语等版本。五种语言的技能树意味着数百个可能彼此偏离的文件。

术语通过 sw-workflow/terms.md 中的映射处理。“logline”“act out”“beat sheet”“showrunner”和“staff writer”等概念仍然以其原始行业术语为锚点。没有清晰对应译法的术语可以保留原词并附加释义。

这种做法存在权衡：无法阅读中文的读者不能直接审核底层指令文件。翻译后的 README 提供安装、结构和政策信息，而完整的技能表格与书目仍保留在主文档和中文文档中。

详细参考资料，不让技能文件变得臃肿

每项技能都包含一个 SKILL.md，其中有原则、工作流程和检查清单。几乎每项技能还包含一个 reference.md，用于放置表格、示例、摘录和完整分析。

一些较大的领域会拆分为多个参考文件。例如，剧集案例研究将材料分为英语剧本合集、试播集拆解和亚洲文本。剧集引擎技能则分别提供引擎拆解、文档字段表和完整样例。

这种分离让操作性指令保持易于管理。仓库还力求将 SKILL.md 文件控制在约 40 KB 以下，并将技能描述控制在项目规范要求的 1,024 字符限制以内。

在不削弱核心的前提下加入新媒介

仓库采用一条严格规则来判断新类型是否值得拥有独立技能：它必须改变写作的结构、格式或语言规则。间谍惊悚片或家庭剧这类主题类别并不会自动满足条件。除非有完整且独特的语料库足以支持专门处理，否则它们应归入案例研究。

一种新的媒介应增加：

1. 一项新技能
2. 一张边界表，说明哪些通用方法可以迁移
3. 工作流路由表中的一条记录

每加入一种新媒介，都不应重写通用技能。正是这一架构让剧集层和中国戏曲层得以扩展，同时无需改变基本的前提、结构、对白和场景技能。

中国戏曲说明了这种分离为何重要。板腔体和曲牌体被视为两个系统，因为它们的声腔结构、唱词方法和舞台单位各不相同。一个系统内部的地域传统通常可以使用参考附录，而无需拆分成独立技能，从而避免为每种地域剧种创建数百个近似重复的技能。

素材基础与许可

该项目的素材来自 17 本编剧创作书、15 本电视剧写作书、已出版的剧本和戏剧，以及大量中国戏曲理论、剧本和曲谱。来源包括 Syd Field、Blake Snyder、Robert McKee、Lajos Egri、Lisa Cron、Neil Landau、Pamela Douglas、William Rabkin、Jesse Armstrong、Aaron Sorkin、Phoebe Waller-Bridge、契诃夫、小津安二郎，以及许多中国作家和理论家的作品。

该仓库仅授权个人学习使用。引用内容仍归原作者和译者所有，因此最好将其视为学习与开发工具，而不是获得授权的原始文本的替代品。

谁适合使用它？

这套合集非常适合：

• 开发长篇电影或试播集的编剧
• 构建剧集圣经的电视剧编剧
• 剧集主创和编剧室成员
• 比较不同戏剧传统的研究者
• 测试领域专用智能体技能的开发者
• 改编小说、戏剧或既有知识产权的编剧
• 设计结构化写作练习的教育工作者

它不太适合那些寻找一键式“给我写个剧本”提示词的用户。它的价值来自分阶段开发、明确的创作决策、基于来源的替代方案，以及反复修改。

GitHub 页面显示该仓库已有 1,000 个 star 和 118 个 fork，说明它作为“如何将专业知识封装给编程智能体”的案例，已经吸引了相当多关注。它最重要的理念在于架构：不要要求通用模型一次记住所有编剧规则，而应为它提供小型、可组合的技能，并根据当前的写作问题选择相应技能。

来源

jtydhr88/screenwriting-skills：面向编剧、电视剧写作和戏剧学的专业智能体技能