前言¶

用大模型寫劇本時，常見問題是輸出格式混雜（小說體、英文場記、分集邏輯各說各話），以及流程斷裂：大綱寫完就停、沒有會診和臺詞層修訂。單靠一段長提示詞很難把「框架 → 初稿 → 醫生會診 → 臺詞 → 整合」串成可復現的工序。

「劇本創作全流程」是 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