关于 papercut-script
papercut-script 是用于调研并编写纸艺风格短视频的技能,将有来源的事实、口播、事实横幅、视觉调度和笑点统筹起来,使各条内容轨相互配合。
主要功能
- 01收集带来源的事实
- 02三轨节拍设计
- 03脚本与横幅撰写
- 04UI 与场景调度表
- 05视觉笑点与呼应设计
适用场景
- 01撰写有事实来源的短视频脚本
- 02将产品界面改编为纸艺演示
- 03配合旁白规划横幅和场景
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ 0xs4n4tg/ papercut-explainer --skill papercut-script安装后在 Claude Code 中输入/papercut-script确认已加载。
附带文件references/comedy.mdreferences/storytelling.md
详细介绍
Papercut 脚本
研究、脚本、横幅轨道、布景和笑点需要一起编写,因为它们会相互影响。完整系统以及短语库和两个演示案例见 references/storytelling.md。笑点和格式库见 references/comedy.md。
每个节拍都包含三条各司其职的轨道:
- 旁白(以字幕标签显示):讲述故事,语气随意,以第二人称表达,每句话都要变化。
- 横幅:补充旁白略过的硬性事实、数字或坦诚的注意事项,每 1.8-3 s 变化一次。
- 布景:用画面直观呈现旁白中的具体名词,并通过产品 UI 进行演示,随横幅变化。
前期准备
- 安装:最精简的安装就够了。只有在选择布景时需要背景图表(
library/papercut/public/bg/backdrops/_sheet.jpg),才解析$PAPERCUT_LIB。每张图片约消耗 0.7-1.5k 个 token,因此只打开当前步骤需要的图片。 episodes/NN-slug/research/facts.md顶部需要有 BRIEF,episodes/NN-slug/papercut/STORYBOARD.md顶部需要有 HOOK 区块。缺少其中任何一个:先运行papercut-strategy或papercut-hook。- 研究需要网页抓取或搜索,以及用于截图的浏览器工具。没有这些工具时,请向用户索取截图和事实。
1. 研究并粗略还原 UI
- 从来源收集事实,并为每条事实标注来源:名称、制作方、数字、价格、要求、限制、竞品数字。标记任何不确定的信息。
- 获取关键界面(2-4 个)、实际标签和按钮文字、强调色及主视觉图片。视频会用剪纸道具粗略重建 UI,而不是录制屏幕(见
references/storytelling.md第 5 节)。 - 根据 BRIEF 确认角色设定。绝不虚构产品行为。参见
../papercut-explainer/references/frame-breakdown.md中的角色设定说明。 - 将列表写入
research/facts.md的 BRIEF 下方。脚本、横幅和 UI 中的每个数字都必须能在其中找到依据。
2. 选择模式
| 模式 | 适用场景 |
|---|---|
| 开源产品发布 | 提供付费产品的免费或本地替代品 |
| 新闻发布/是否值得 | 大公司推出新的付费层级、模型或功能 |
| 功能解锁/操作指南 | 隐藏设置或命令改变工具的工作方式 |
各模式的 Hook 公式和中段内容见 references/storytelling.md 第 6 节。应用 Hook 更新:揭示悬念和利害关系,而不是新闻本身。
3. 沿着主线写脚本
按选定格式写 75-95 个词,时长 22-30 s,语速约为每秒 3.5-4 个词,每 1.5-3 s 换一个布景。共 10 个节拍:
- Hook(0-3 s),已由
papercut-hook固定 - 证据或悬念
- 重新构建视角(“所以,不必……,你可以……”)
- 揭示名称(“它叫……”;绝不能放在 Hook 之前)
- 运作方式,用一个具体演示说明
- 递进(“而 X 还只是开始,因为……”后接恰好三项的功能组合)
- 高潮(“还有一点:”后接最大的数字)
- 注意事项(坦诚指出反面情况)
- 结果(“这意味着……”)
- CTA(“还好我做了[免费资源]。想要链接,就评论 KEYWORD。”)
缩短节拍,不要加快语速。规则:
- 使用第二人称和缩略表达,用短分句通过“而且”“因为”“这意味着”等连接。词汇难度要符合
SERIES.md中的受众水平。 - 即使主题是别的内容,也要在第一句话中提到一个大品牌。
- 每个数字都必须具体且有来源。只能有一组功能组合,且始终包含三项。
- 旁白或横幅中至少要提到一项实际限制。CTA 关键词必须是与主题相关的一个简短单词。
- 最后一行重复 Hook 中的关键词或数字,然后给出关键词。
将内容写入 narration/script.json,格式为 [{"id": "l1_hook", "text": "..."}, ...],每句话或分句组占一行。l1_hook 这一行是 HOOK 区块中的 SAY。在分镜表中标出每行着重强调的一两个词(数字、转折词、结论),供 papercut-voice 使用。
4. 横幅字幕轨
10–18 条横幅字幕,每条 3–7 个词,全部大写,每条只表达一个事实,间隔约 2–3 秒。它们绝不重复画外音:单独阅读时,应当是一份事实清单。内容包括一个关键数据、一条价格换算、一项可信度事实、可用性、至少一条坦诚的限制、至少一条信任或安全事实、功能声明、至少一条竞品对比,以及 CTA 前的一条范围/决策横幅字幕。类型和示例:references/storytelling.md 第 3 节。
5. 分镜表
每条横幅字幕占一行,写入 STORYBOARD.md 的 HOOK 区块:
t (s) | 下方的画外音词句 | 横幅字幕 | 场景(房间 + 背景色) | 核心道具(取自画外音具体名词的视觉双关) | 产品 UI 时刻 | 吉祥物动作和服装道具 | 笑点
- 每条横幅字幕切换一个新场景,背景色轮换。场景应表现画外音句子中的一个词,而不是横幅字幕。
- 用实体道具表现数字:价格牌、秤、倍数墙、仪表盘、计量表、竞赛。竞品以图钉固定的卡片形式出现,绝不作为主角。
- 吉祥物是观众的替身,会作出反应。产品 UI 是在纸质显示器或笔记本电脑上粗略重建的界面,并带有虚构交互。
- CTA 前回访一次早先的场景。CTA 场景中显示一个评论框,正在输入关键词。
papercut-storyboard会添加摄影机和转场列。
6. 幽默润色(脚本完成后、分镜定稿前)
添加“笑点”列。画外音保持严肃,只有画面可以搞笑。
- 整条短片采用一种表现形式。
- 每条横幅字幕配一个演绎其要点的笑点,参考
references/comedy.md。 - 每个创意配一个服装道具。吉祥物自身的物品保持穿戴,再加一个道具。
- 在点题句处安排一个吉祥物努力挣扎的桥段。
- 在第 0 帧放置一个道具,并在 CTA 场景中让它以改变后的状态回归(I'M OUT 变成 FREE)。
- 安排一个荒诞且不作解释的背景情节。
- 最多使用一个梗,并以系列自身的风格重新制作;绝不使用真实片段、静帧或音频。
笑点不得遮挡横幅字幕、字幕或关键数字,且每个笑点都必须在 1 秒内看懂。
检查关卡
- 75–95 个词,22–30 秒,一条坦诚的限制,以及恰好三项的组合。
- 每个数字和横幅字幕都能追溯到
facts.md;单独阅读横幅字幕时,应当是一份事实清单。 - 最后一行重复开场钩子的关键词或数字。
- 已完成幽默润色:每个创意都有服装道具、一个挣扎桥段、一个回归道具、一个荒诞情节,且最多一个梗。
交接
下一步是 papercut-storyboard。它会读取 narration/script.json,以及 episodes/NN-slug/papercut/STORYBOARD.md 中的 HOOK 区块和分镜表。如果只运行脚本,到此为止,并将这些文件交给用户。供其他工具使用的故事叙述提示词复制文本见 references/storytelling.md 第 7 节。