专业编剧技能包：screenwriting-skills

这是什么

screenwriting-skills 是一个面向专业编剧和影视创作者的开源 AI 技能集合，由作者 jtydhr88 维护。它从 47 本创作书籍和 23 卷已出版的剧本、乐谱和戏剧（涵盖中、美、英、日、韩）中提炼出 26 个 agent skills，用于 Claude Code 和 OpenAI Codex 两个平台。这些技能文件遵循开放的 agentskills.io 标准，一次安装即可在两个代理中同时使用。

技能本体以中文编写（因为大多数原始资料为中文或中文翻译），但您可以用任何语言提问，Agent 会自动以您提问的语言回复——例如用英语提问会得到英语回答，用日语提问则得到日语回答。该项目强调单一来源树，避免多语言维护负担。

适合谁

专业编剧：无论是电影、电视剧、舞台剧还是戏曲创作者，都可以从中获得结构化的创作指导。
编剧新手：希望通过 AI 辅助学习经典叙事技巧，快速掌握故事结构、人物塑造、对白设计等核心方法。
影视行业从业者：制片人、导演、编剧室成员，需要评估项目、搭建故事圣经、规划剧集结构。
跨文化创作者：对中、美、英、日、韩、法等国创作传统感兴趣的人。

能做什么

这套技能集合按四层组织，覆盖从故事构思到提交的完整创作流程：

通用戏剧学：前提/主题、故事结构、人物/对白/场景、剧本格式、Truby 有机结构、类型解剖、项目工作流。
媒介层：剧集结构、单集与季结构、剧集引擎与圣经、编剧室、半小时情景喜剧、舞台剧与中国戏曲（板腔体/曲牌体）。
传统与行业：美国、日本、韩国与法国、中国大陆的创作实践，以及编剧行业的商业规则。
大师语料库：契诃夫、小津安二郎、继承之战等具体案例研究。

例如，您可以直接对 Agent 说：

"把这部 12 集剧集按幕划分并安放幕落点" → 调用 sw-series-structure
"我的对白太直白，修一下这个场景" → 调用 sw-dialogue + sw-scene-craft
"把这部 40 万字小说改编成 40 集国产剧大纲" → 调用 sw-chinese-series-practice + sw-series-engine-bible

使用前准备

安装 Claude Code（Anthropic 官方文档有安装指南）或 OpenAI Codex（CLI / ChatGPT 桌面应用 / IDE 扩展）。
确保有可用的 Git 环境（用于克隆仓库）或支持插件市场的环境。
无需 API Key（技能本身免费），但需要相应的 Agent 订阅或本地运行环境。

安装方法

Claude Code 推荐方式（插件市场）

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

安装后即可通过 /screenwriting: 调用，例如 /screenwriting:sw-dialogue。

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 plugin marketplace add jtydhr88/screenwriting-skills
# 然后在 ChatGPT 桌面应用或 Codex CLI 中：Plugins → 选择 "Screenwriting Skills" → Install

Codex 个人技能（所有项目）

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

Codex 项目专属

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

使用示例

“把这部 12 集剧集按幕划分并放置幕落点” → Agent 使用 sw-series-structure
“我的对白太直白，修一下这个场景” → Agent 使用 sw-dialogue + sw-scene-craft
“把这部 40 万字小说改编成 40 集国产剧大纲” → Agent 使用 sw-chinese-series-practice + sw-series-engine-bible
“建立项目并跟踪进度” → Agent 使用 sw-workflow

多语言支持

项目采用单一来源树设计，技能文件用中文编写一次，运行时代理根据您的提问语言输出对应语言的结果。术语表将专业词汇（如 logline、act out、beat sheet、showrunner）映射回英文原词，确保跨语言一致性。中文独有术语如“戏眼”“扣子”会保留原形式并附注释。

风险与注意事项

技能文件本身仅提供中文版本，如果您需要直接阅读指令文件，需要具备中文阅读能力（代理会解释内容，但无法直接审阅源码）。
项目采用 MIT 许可证，可自由使用和修改，但请遵循开源协议要求。
该技能集重点面向专业创作，可能不适合以娱乐为目的的简单提问。
由于技能文件较多（26 个），安装后可能占用一定空间，但均在合理范围内。
请注意备份自己的项目文件，避免因技能调用冲突导致数据丢失（建议使用 sw-workflow 中的 story bible 惯例管理项目状态）。