前言¶

用大模型写剧本时，常见问题是输出格式混杂（小说体、英文场记、分集逻辑各说各话），以及流程断裂：大纲写完就停、没有会诊和台词层修订。单靠一段长提示词很难把「框架 → 初稿 → 医生会诊 → 台词 → 整合」串成可复现的工序。

「剧本创作全流程」是 SkillHub 社区 Skill（坐标 @user_5cb34834/script-master），采用单入口总控 + 多份专家参考文档的内部调用方式，把创作拆成 S0–S9 阶段，并统一在华语剧本标准格式（中文短剧拍摄稿格式）下产出。系统内文档标注的统一版本号为 v2.2（更新日期 2026-07-18）；SkillHub 上架包版本为 1.0.0。

这是什么¶

一句话定位：以 SKILL.md 为总控编排器、按阶段读取 references/ 下专家文档的剧本创作 Skill。

官方页面：SkillHub - 剧本创作全流程
API 地址：https://api.skillhub.cn/user_5cb34834/script-master

核心功能¶

五层知识库¶

总控在 S1–S8 各阶段按需调用下列蒸馏库，而不是让用户直接翻阅全部文件：

1. pattern-library：宏观规律（优秀剧本规律蒸馏）
2. writing-craft-library：中观场景（写作技法）
3. lines-library：微观台词（机制、模板、对照）
4. martial-arts-library：打戏层（招式与场面）
5. sound-design-library：声音叙事层

单入口目录结构¶

安装后典型布局如下（资料中以 TRAE SOLO 的 .trae/skills/ 为例；其他 Agent 的 skills 目录见下文安装一节）：

.trae/skills/
└── script-master/              ← 用户唯一交互入口
    ├── SKILL.md                ← 总控编排器
    └── references/
        ├── framework.md        ← 剧本框架（S1-S3）
        ├── writing.md          ← 剧本写作（S4/S6/S8）
        ├── doctor.md           ← 剧本医生（S5）
        ├── dialogue.md         ← 台词专家（S7）
        ├── visual-director.md  ← 导演画面版（用户触发型）
        ├── pattern-library.md
        ├── lines-library.md
        ├── writing-craft-library.md
        ├── martial-arts-library.md
        └── sound-design-library.md

SKILL.md 负责阶段判断与编排；references/ 由总控内部读取，不面向用户逐文件操作。

S0–S9 总体流程¶

用户灵感
  ↓
剧本总控判断阶段（S0）
  ↓
framework.md → 项目档案和大纲（S1-S3）
  ↓
writing.md → 初稿（S4）
  ↓
doctor.md → 会诊（S5）
  ↓
writing.md → 修订（S6）
  ↓
dialogue.md → 台词逐句诊断（S7）
  ↓
writing.md → 整合台词（S8）
  ↓
总控输出最终可执行剧本包（S9）

v2.2 与格式治理（资料已写明部分）¶

• 格式统一：全系统使用华语剧本标准格式；废弃 M1 标准影视格式、M2 小说化叙事、M3 分集开关，以及 FADE IN / CUT TO 等旧写法。
• 短剧前 20 集结构：短剧/漫剧/爽剧/喜剧默认按前 20 集规律设计（每集四要素：冲突、反转、卡点、作用；前 10 集含第 9 集钩子与第 10 集第一次付费卡点；第 11–20 集含第 18 集小型大爆炸与第 20 集第二次付费卡点）。
• 强制调用声明：SKILL.md 开头增加禁止/强制行为，减少模型跳过 Skill 直接输出的情况。
• 格式锁：framework.md 项目档案含【剧本格式】格式锁字段。
• 格式规范诊断：doctor.md 含 §2.12b 格式规范诊断及投流操盘手付费卡点检查依据。
• v2.1 规则分级：五个知识库的「使用规则（强制）」改为「使用规则（分级）」，硬性的字数/次数/秒数等改为倾向提醒。

交付与扩展输出¶

• 输入「交付剧本」「给甲方看」「交付模式」「对外版本」「干净版」等，总控进入交付模式，输出两个独立文档（参考 juben.pro 剧本网与飞书项目书格式，资料未展开模板字段）。
• 导演画面版：通过 visual-director.md 做用户触发型输出。
• 试跑：输入 压测 或 test mode，用最小样例跑完 S0–S9，用于熟悉流水线。

安装与启用¶

SkillHub 页面给出的安装指引是：按 SkillHub 安装文档 操作，并安装坐标 @user_5cb34834/script-master。

1、安装 SkillHub CLI（若尚未安装）¶

command -v skillhub && skillhub --version

未安装时可执行完整安装（CLI + 默认 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅安装 CLI：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

2、安装本 Skill 到当前 Agent 的 skills 目录¶

安装时必须用 --dir 指向当前环境会被识别的 skills 目录；否则默认落在 ./skills/ 可能无法被 Agent 加载。

skillhub install @user_5cb34834/script-master --dir <skills 目录>

常用路径（来自 SkillHub 安装文档）：

• Cursor：~/.cursor/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/
• Claude Code：~/.claude/skills/

资料中总控由 TRAE SOLO 自动发现 SKILL.md，对应目录示例为项目或环境下的 .trae/skills/。若你在 TRAE 生态使用，将 --dir 指向该环境的 skills 根目录即可。

安装后按所用客户端要求重启或刷新 Skill 索引。本 Skill 标注 requires_api_key=false，不依赖额外 API Key 配置。

典型用法¶

与总控对话时，按你手头材料选一条路径即可；总控会判断阶段并内部读取对应 references/ 文件。

路径一：已知项目类型¶

直接说明类型，总控套用快速启动模板：

示例（短剧）：

短剧。题材：都市逆袭。主角：外卖员，嘴硬心软。核心爽点：身份反转当众打脸。

路径二：只有一个灵感¶

把灵感发给总控。总控会：判断 S0、询问 5 项基础信息、推荐模式与节奏、读取 framework.md 生成项目档案。

路径三：已有部分材料¶

粘贴灵感、项目档案、大纲、初稿、会诊报告或台词诊断报告中的任意组合。总控会识别阶段、推荐下一步并调用对应专家文档。

路径四：先熟悉全流程¶

压测

或：

test mode

路径五：对外交付¶

剧本阶段性完成后，可使用例如：

交付模式

总控输出对外可用的干净版文档组合。

适用场景与注意¶

适合谁

• 写短剧、漫剧、AI 微电影或长篇电影剧本，需要统一拍摄稿格式和分阶段质检的团队或个人。
• 希望把「会诊」和「台词层」纳入固定工序，而不是一次性生成终稿的用户。
• 使用 TRAE SOLO、Cursor 等支持 SkillHub 安装的 Agent 环境。

限制与注意

• 专家文档在 references/ 内由总控调用；若模型未加载 Skill 或未遵守 SKILL.md 强制调用章节，仍可能跳过流水线直接输出——v2.2 已针对该问题增加约束，使用时以总控阶段提示为准。
• v2.2 已废弃多种旧格式与 M3 分集开关；老项目迁移需接受统一华语短剧拍摄稿格式。
• 短剧前 20 集结构与付费卡点规则是默认结构规律，题材差异下 v2.1 起知识库规则为「分级」而非一律硬性达标。
• SkillHub 统计（评分、下载量等）以页面实时数据为准；撰写时页面可见包版本为 1.0.0，与系统文档 v2.2 并存，含义不同（上架包 vs 技能体系版本）。

结尾¶

「剧本创作全流程」把剧本生产拆成可重复的 S0–S9 工序，用五层知识库和统一格式锁降低格式漂移，并支持短剧启动模板、压测试跑与交付模式。若要在本地 Agent 中启用，按 SkillHub 指引安装 @user_5cb34834/script-master 即可。

官方 Skill 页：https://www.skillhub.cn/skills/user_5cb34834/script-master