前言¶
做品牌片、廣告或短視頻時，很多人一上來就讓 Agent 出分鏡或畫面描述。創意還停在一句梗概，人物關係和場景要素沒對齊，後面改稿成本會堆在分鏡和後端環節。更穩妥的做法是先把「可讀、可討論」的劇本定下來，再交給分鏡導演。
下面介紹 SkillHub 上的社區 Skill「劇本」（@user_b7745ab7/scriptwrite）：它定位在視頻製作流程的最前端，和用戶協作寫出文學化劇本，確認後再銜接總分鏡類 Skill。
這是什麼¶
「劇本」是劇本生成 Agent，座標 @user_b7745ab7/scriptwrite，版本 1.0.0，來源爲 community，分類爲 content-creation，由發佈者 user_b7745ab7 維護。頁面標註 requires_api_key=false，安裝與使用不依賴額外 API Key。
它解決的是「從視頻創意到可執行敘事文本」這一步：用戶提出諸如「做一個廣告」「拍一支品牌片」「幫我寫個短視頻腳本」等需求時，Agent 先協作生成劇本，經用戶確認後再交給總分鏡導演（如 storyboard-master-agent）。
核心功能¶
協作式劇本生成¶
輸出目標是文學化、可讀的劇本，而不是直接跳到鏡頭表。流程強調與用戶反覆對齊，用戶點頭後再進入分鏡階段。
兩種擴寫方式¶
- 發散性擴寫：輸入是一句話或較模糊的創意時，向完整敘事方向展開。
- 補充性擴寫：輸入已是較完整文本時，在現有基礎上補全細節與結構。
具體段落風格由 Agent 按 Skill 內 SKILL.md 約定執行；官方簡介未給出固定模板字段，以安裝後的 Skill 說明爲準。
出場元素清單¶
劇本結果中會單獨列出人物、道具、場景等「出場元素」，便於後續分鏡、選角和製片對齊同一套實體列表。
觸發與編排順序¶
常見觸發表述包括：劇本、腳本、scriptwriter、writescript、視頻創意、視頻構思、寫一個視頻、品牌故事、廣告創意、短視頻構思、視頻立項等。
重要：本 Skill 應在 storyboard-master-agent 之前運行。僅當用戶明確表示「跳過劇本」「直接出分鏡」或「我已經有劇本」時，纔不觸發本 Skill。
安裝與啓用¶
SkillHub 頁面給出的安裝指引是：按 SkillHub 安裝文檔 安裝座標 @user_b7745ab7/scriptwrite。
1、檢查或安裝 SkillHub CLI¶
先確認本機是否已有 skillhub：
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、安裝到當前 Agent 的 skills 目錄¶
安裝時必須用 --dir 指向當前客戶端識別的 skills 目錄，否則默認落在 ./skills/ 可能不會被 Agent 加載。官方文檔列出的常見路徑包括：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
以 Cursor 爲例，安裝命令形如：
skillhub install user_b7745ab7/scriptwrite --dir ~/.cursor/skills/
（座標在頁面上寫作 @user_b7745ab7/scriptwrite；CLI 安裝時以 SkillHub 文檔與 skillhub install 實際接受的包名爲準。）
也可在對話中讓 AI 讀取 https://skillhub.cn/install/skillhub.md 並按同一座標完成安裝。
安裝或更新 Skill 後，按你所用客戶端的要求重啓或刷新 Agent，使 SKILL.md 生效。
典型用法¶
下面是一套與官方簡介一致、可復現的對話路徑。
- 發起需求：用自然語言說明視頻類型與創意，例如「幫我寫一個 30 秒品牌短視頻腳本，主題是……」。
- 選擇擴寫模式：只給一句話時，Agent 走發散性擴寫；已有大綱或初稿時，說明「在下面文本上補充」，走補充性擴寫。
- 審閱劇本與出場元素：檢查正文敘事，並覈對單獨列出的人物、道具、場景是否與預期一致；不滿意則繼續改稿。
- 確認後進入分鏡：用戶明確確認劇本後，再觸發總分鏡導演類 Skill（如
storyboard-master-agent）。若已有成稿劇本，可直接說明「我已經有劇本，跳過劇本 Skill」。
官方未提供固定示例劇本全文；成稿格式以 Skill 安裝後的行爲爲準。
適用場景與注意¶
適合誰：內容團隊、獨立創作者，以及用 Agent 串聯「創意 → 分鏡 → 製作」工作流的人；尤其適合需要先對齊故事再拆鏡頭的前期階段。
使用注意：
- 不要與分鏡 Skill 搶順序：默認先劇本、後分鏡，避免鏡頭設計與敘事脫節。
- 社區來源（community）Skill，升級與行爲以 SkillHub 上 v1.0.0 及後續版本爲準。
- SkillHub 頁面當前統計：評分 100000，下載 6022 次（數據來自 SkillHub 展示，會隨時間變化）。
結尾¶
「劇本」把視頻立項最前面的敘事對齊做成可確認的一步：兩種擴寫覆蓋從模糊創意到半成品文稿，出場元素清單爲後續分鏡打底。需要安裝或查看說明時，可打開 SkillHub 頁面：
- 展示頁：https://www.skillhub.cn/skills/user_b7745ab7/scriptwrite
- API 座標頁：https://api.skillhub.cn/user_b7745ab7/scriptwrite
