Kunka Screenwriting Master — Development skill for Claude Code

昆卡编剧大师

**Kunka Screenwriting Master** — 面向 Codex 与 Claude Code 的中文编剧技能包。

[English](README_EN.md) · [使用示例](examples/dialogue-workshop.md) · [安装管理](docs/installation.md) · [MIT License](LICENSE)

**从一个点子，到一份完整剧本。**

昆卡编剧大师通过 13 个专用技能，帮助你构思故事、塑造人物、编写场景、润色对白和修改初稿。适用于短片、短剧、长片与连续剧，在 Codex 或 Claude Code 中直接用自然语言开始创作。

你可以用它做什么

你手里的材料	可以交给昆卡的任务	得到什么
一句话、一个画面、一个人物	发展核心冲突，探索故事方向	一句话故事与创作方案
已经选定的故事方向	设计结构、人物关系和场景	大纲、人物表与剧本初稿
一段不满意的戏	调整动作、对白和潜台词	可直接替换的场景
一份完整初稿	检查动机、因果、时间线和信息冲突	有具体位置的改稿意见与修订
一部准备继续开发的剧集	安排本集故事与跨集变化	分集大纲与项目记录

可以按阶段开发，也可以直接要求写正文。你的题材、人物设定、结局和篇幅要求会作为本次创作的依据。

开始使用

Codex

需要 Git 和 Python 3.9+，运行安装不需要第三方 Python 包：

git clone https://github.com/geslie1/kunka-screenwriting-master.git
cd kunka-screenwriting-master
python3 scripts/install.py --dry-run
python3 scripts/install.py

默认安装到 `$CODEX_HOME/skills`；未设置 `CODEX_HOME` 时使用 `~/.codex/skills`。安装后在支持技能动态发现的 Codex 中从下一轮对话使用；若客户端尚未刷新，重新打开会话。

使用 $kunka-screenwriter，帮我开发一个十分钟悬疑短片。
要求两个演员、一个主要场景，先给两个故事方向。

单个任务可直接指定专用技能：

使用 $kunka-dialogue，润色下面的对白，保留最后一句和人物关系。
使用 $kunka-continuity，检查这份剧本的时间线和人物知情是否冲突。
使用 $kunka-revision，直接修改这份初稿中最影响因果的三处问题。

Claude Code

在 Claude Code 内执行：

/plugin marketplace add geslie1/kunka-screenwriting-master
/plugin install kunka-screenwriting@kunka-screenwriting-master

安装后可直接描述编剧任务，或调用 `/kunka-screenwriting:kunka-screenwriter`。

试着这样说

**从零写短片**

使用昆卡编剧大师，写一个约十分钟的现实悬疑短片。
三个主要人物，故事发生在一间深夜营业的便利店。
结尾要有反转，但前面要留下能回看的线索。直接给完整初稿。

**修改已有剧本**

使用 $kunka-revision，检查下面的初稿。
保留人物关系与结局，优先修复动机和因果问题，再调整对白。
请给出修改后的正文，并简要说明改动。

**继续上次的项目**

使用 $kunka-screenwriter，读取这个项目的 story-bible.md。
沿用已确认设定，继续写第三场，不重新讨论结局。

想先看具体效果，可以阅读 [对白修改示例：搬琴](examples/dialogue-workshop.md)。

13 个技能

技能	使用时机	典型结果
kunka-screenwriter	新项目、续写、不知道下一步	当前阶段的成果与项目状态
kunka-premise	点子与主题开发	故事方向、一句话故事
kunka-structure	大纲、