前言¶
做品牌片、广告或短视频时，很多人一上来就让 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
