Communitygithub.com

Pedrovbm1/guion

为短视频(Reel、TikTok、Shorts 或 3D 动画解说)撰写带有调研数据和来源的脚本,每句一个想法,用日常口语表达,并在投入配音或动画前设置三轮审查(A 留存率、B 数据、C 清晰度)。最终停在“脚本就绪”状态,等待用户确认。

guion 是什么?

该技能用于创建高度优化的解说视频脚本,特别适合短视频或 3D 动画科普。它首先接收用户想法或参考视频链接,然后进行有来源的数据调研,确保每条可验证信息都附有来源。撰写时严格遵循“一句一想法”和日常口语规则,并内置视觉映射(MAPA)将每句话与画面、文字提示和时间对应起来。最关键的特色是“第 0 轮审查”:由三个独立子智能体分别从留存率、数据准确性和对陌生人的清晰度三个维度评分,达到阈值(留存率≥9、清晰度≥9、数据无高等级问题)后才输出。整个过程强制在“脚本就绪”状态停下,等待用户明确许可,避免在错误脚本上浪费制作成本。该技能可在 Claude Code、Cursor、Codex 等平台上运行,通过 SKILL.md 中定义的子智能体和文件结构实现。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Pedrovbm1/explicadores-3d/tree/main/skills/guion

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

解说脚本

脚本是最便宜修改、最昂贵才发现出错的东西。视频已经制作完成再去重写脚本要花费数小时;而阅读文本只需一分钟。因此,本技能始终停在 GUION LISTO。

输出:一个项目文件夹,包含 voz/frases.txt(每行一句)、MAPA.md(视觉脚本 + 带来源的数据)和 DECISIONES.md。如果与 explicador 技能配合使用,项目已由 nuevo.py 创建,MAPA.md 就是 escena/CONTRATO.md 的草稿。

1. 接收想法

  • 如果收到视频链接,请使用 ver-video 技能进行分析。对于他人的视频,只取主题和使之有效的因素(钩子、节奏、结构),绝不使用其脚本、句子、图像或音乐。
  • 将你不知道的问题一次性提出(最多 4 个问题):观众、时长、是独立视频还是系列的一部分、语气。用户决定的内容写入 DECISIONES.md 并标注日期(压缩上下文后重新阅读)。

2. 调研并附来源

  • 每个数字、日期或可验证的陈述都必须有来源(链接 + 具体说明)。没有可靠来源则不包含。如果来源不一致,要模糊表述(“介于 10 和 15 之间”、“据估计”)。
  • 对属于理论或假设的“原因”解释要标明(“据推测”、“一种想法是”)。
  • 虚构的“例如”要明确说明是举例(“假设它长 8 厘米”)。
  • 可以委派搜索给具有 high 努力级别网络搜索能力的子智能体(一个错误的数据会损害信任),但你需复核关键来源。
  • 将所有内容记入 MAPA.md → “已验证数据”部分:数据 · 来源 · 简短引用。

3. 撰写

风格规则(最能提高留存率和清晰度):

  1. 每句只表达一个想法。 如果一个句子包含“而且”、“虽然”或叠加的条件,请将其拆开。
  2. 日常口语,就像对朋友讲述那样:使用日常词汇,举家庭或工作中的例子。每个技术术语要么在首次出现时解释,要么不使用。
  3. 钩子出现在前 3 秒(最晚 4.5 秒):提出一个好奇心问题或与观众认知相悖的内容。第 0 帧必须在无音频时也能被理解:清晰的图像 + 文字问题。
  4. 承诺与兑现: 钩子所做的承诺必须兑现,并且要用可见的方式兑现。
  5. 每 5-8 秒设置一个微钩子(“但是注意”、“接下来奇怪的事情来了”)。
  6. 结尾回到开头(循环)并提出一个非通用性的评论问题。
  7. 时长: 语音每秒约 16 个字符(≈ 每秒 3 个词)。独立视频在 15-30 秒效果最佳;超过 60 秒仅适用于有名称和编号的系列视频。
  8. 不得抄袭其他创作者的语句或套话。
  9. 对于 3D 动画:避免任何像眼睛的物体或成对等圆(带环的球体、并排窗户、上方有弧线的圆盘)。如果物体是圆形的,MAPA.md 要说明其绘制方式以避免被误认为眼睛。

写入 voz/frases.txt 和 MAPA:一个表格,包含每句话、其关键词(决定画面切换的词)、在该词上的画面内容、确切的文字标题(如有)及其近似时间点。

4. 在 MAPA 上进行第 0 轮审查(仅文本,在配音和动画之前)

并行启动 3 个独立的审查员(子智能体,使用中等模型如 Sonnet,努力级别 medium;B 为 high)。每个审查员读取 voz/frases.txt 和 MAPA.md,不读取其他审查员的输出,并提交 revision/REV_<字母>_mapa_v<编号>.md,包含十分制评分及确切修改建议(哪句话、哪个词、哪个标题)。任务说明在 RONDA0.md 中。

  • A · 留存率: 第 0 帧无音频、钩子 < 3 秒、承诺与兑现、微钩子、超过 5 秒无画面切换的段落、循环、结尾问题、时长。
  • B · 数据: 每个数字与来源核对(验证其正确性),确保每个提到的数字都有文字标题,确保屏幕上没有 MAPA 中未出现的内容。
  • C · 对陌生人的清晰度: 像 15 岁孩子那样复述脚本;列出每个未解释的单词、名称、缩写或数字;标记包含多个想法或小字内容(“一般来说”、“一种场景,而非预测”)的句子。提出每句话的重写版本并确定时长。

应用修改并重复直到 A ≥ 9 且 C ≥ 9 且 B 无高等级发现,最多 2 轮。如果第二轮仍未通过,则停止并向用户提供带有备注的脚本:不得进入制作阶段。

5. 脚本就绪(强制停止)

以单一消息发送给用户(在聊天中,不作为文件):

  • 纯文本脚本(10-12 行),
  • 预估时长和第 0 轮审查的备注,
  • 带有来源的数据,
  • 最多 4 个问题。

以 GUION LISTO 结束您的回合。在用户回复之前不要生成语音或启动动画。即使用户说“连续工作”,此步骤也不可跳过:那适用于调研和构建,不适用于此。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

相关技能