screenwriting-skills

概览

GitHubGitHub

screenwriting-skills 是一组面向 AI 编程助手（Claude Code 与 OpenAI Codex）的 Agent 技能包，专注于影视编剧、电视剧写作与戏剧学。它从 47 本创作类书籍以及 23 卷已出版的剧本、乐谱和戏剧文本（涵盖中、美、英、日、韩）中提炼出 26 个 SKILL.md 文件，遵循开放的 agentskills.io 标准，安装一次即可在两个 Agent 平台中使用。 ### 解决什么问题 编剧工作涉及大量结构化知识：故事节拍、人物弧光、对白技巧、不同媒介的格式规范等。该技能包将这些分散的创作理论整合为可被 AI Agent 直接调用的指令集，帮助创作者在写作过程中随时获取专业参考，减少手动查阅资料的成本。 ### 主要能力 技能按四个层次组织： - **通用戏剧学**：包括项目工作流编排（sw-workflow）、故事结构（sw-story-structure）、前提与主题（sw-premise-theme）、人物与冲突（sw-character-conflict）、对白（sw-dialogue）等，不依赖特定媒介。 - **媒介层**：针对剧集（分季/分集结构、引擎与圣经文档、编剧室流程、半小时喜剧）和舞台剧（含中国戏曲板腔体与曲牌体方法）提供专门技能。 - **传统与行业**：覆盖美国、日本、韩国、法国及中国大陆的创作传统与行业实践。 - **大师语料库**：包含契诃夫、小津安二郎、Succession 等案例研究。 ### 多语言支持 技能源文件以中文编写，但输出语言跟随用户提问的语言。用英文、日文、韩文或法文提问，Agent 即以对应语言回答。专业术语通过术语表映射回原始英文词汇（如 logline、act out、beat sheet），无对应词的概念保留原文并附释义。 ### 适合谁 使用 Claude Code 或 OpenAI Codex 进行剧本创作的编剧、电视剧写作者、戏剧研究者，以及希望将 AI 辅助引入创作流程的个人或团队。

Q&A

这些技能可以在哪些平台上使用？由 AI 生成

支持 Claude Code 和 OpenAI Codex（包括 CLI、ChatGPT 桌面应用和 IDE 扩展）。SKILL.md 文件遵循 agentskills.io 标准，安装一次即可在两个平台共用。

技能文件是中文的，可以用其他语言提问吗？由 AI 生成

可以。技能源文件以中文编写，但输出语言跟随用户的提问语言。用英文、日文、韩文或法文提问，Agent 会以对应语言回答。

如何安装到 Claude Code？由 AI 生成

推荐通过插件市场安装：运行 /plugin marketplace add jtydhr88/screenwriting-skills，然后 /plugin install screenwriting@screenwriting-skills。也可以 git clone 后手动复制到 ~/.claude/skills/ 或项目的 .claude/skills/ 目录。

如何安装到 Codex？由 AI 生成

推荐运行 codex plugin marketplace add jtydhr88/screenwriting-skills，然后在 ChatGPT 桌面应用或 Codex CLI 的 Plugins 中选择安装。也可手动复制到 ~/.agents/skills/ 或项目的 .agents/skills/ 目录。

技能是如何分层的？由 AI 生成

分为四层：1. 通用戏剧学（前提、结构、人物、对白等）；2. 媒介层（剧集、舞台剧）；3. 传统与行业（美、日、韩、法、中国大陆）；4. 大师语料库（契诃夫、小津等案例）。

为什么只提供中文源文件而不维护多语言版本？由 AI 生成

项目曾有过英文版，但维护多个语言分支会导致文件独立漂移且难以判断哪个过期。因此决定只维护单一中文源树，由运行时负责翻译输出。