mcpField
P
papercut-script

papercut-script

github.com/0xs4n4tg创意与媒体9951 次安装2 周前更新
代码仓库

关于 papercut-script

papercut-script 是用于调研并编写纸艺风格短视频的技能,将有来源的事实、口播、事实横幅、视觉调度和笑点统筹起来,使各条内容轨相互配合。

主要功能

  1. 01收集带来源的事实
  2. 02三轨节拍设计
  3. 03脚本与横幅撰写
  4. 04UI 与场景调度表
  5. 05视觉笑点与呼应设计

适用场景

  1. 01撰写有事实来源的短视频脚本
  2. 02将产品界面改编为纸艺演示
  3. 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 个节拍:

  1. Hook(0-3 s),已由 papercut-hook 固定
  2. 证据或悬念
  3. 重新构建视角(“所以,不必……,你可以……”)
  4. 揭示名称(“它叫……”;绝不能放在 Hook 之前)
  5. 运作方式,用一个具体演示说明
  6. 递进(“而 X 还只是开始,因为……”后接恰好三项的功能组合)
  7. 高潮(“还有一点:”后接最大的数字)
  8. 注意事项(坦诚指出反面情况)
  9. 结果(“这意味着……”)
  10. 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. 幽默润色(脚本完成后、分镜定稿前)

添加“笑点”列。画外音保持严肃,只有画面可以搞笑。

  1. 整条短片采用一种表现形式。
  2. 每条横幅字幕配一个演绎其要点的笑点,参考 references/comedy.md。
  3. 每个创意配一个服装道具。吉祥物自身的物品保持穿戴,再加一个道具。
  4. 在点题句处安排一个吉祥物努力挣扎的桥段。
  5. 在第 0 帧放置一个道具,并在 CTA 场景中让它以改变后的状态回归(I'M OUT 变成 FREE)。
  6. 安排一个荒诞且不作解释的背景情节。
  7. 最多使用一个梗,并以系列自身的风格重新制作;绝不使用真实片段、静帧或音频。

笑点不得遮挡横幅字幕、字幕或关键数字,且每个笑点都必须在 1 秒内看懂。

检查关卡

  • 75–95 个词,22–30 秒,一条坦诚的限制,以及恰好三项的组合。
  • 每个数字和横幅字幕都能追溯到 facts.md;单独阅读横幅字幕时,应当是一份事实清单。
  • 最后一行重复开场钩子的关键词或数字。
  • 已完成幽默润色:每个创意都有服装道具、一个挣扎桥段、一个回归道具、一个荒诞情节,且最多一个梗。

交接

下一步是 papercut-storyboard。它会读取 narration/script.json,以及 episodes/NN-slug/papercut/STORYBOARD.md 中的 HOOK 区块和分镜表。如果只运行脚本,到此为止,并将这些文件交给用户。供其他工具使用的故事叙述提示词复制文本见 references/storytelling.md 第 7 节。

评论

支持 Markdown