Communitygithub.com

robinfernandez2016-create/guion

将创意简报转化为可直接录制或生成短视频的脚本,包含3秒钩子、逐句结构、镜头对照表、行动号召和发布文案,形成一份完整的制作和提词器脚本。

guion 是什么?

这是一个专门用于将创意简报(brief)转化为生产就绪脚本的专业技能,特别适合短视频(reel)、广告和教程类内容。它通过严格的8步流程确保脚本质量:从明确简报缺失信息开始,设计3秒内抓住注意力的钩子,逐句构建带有语速标记和动作描述的旁白,然后创建旁白与镜头的一一对应表格,最终整合成包含时长、提词器行和发布文案的完整制作文档。该技能支持Claude Code等代码驱动的AI代理平台,其核心优势在于严格遵守“数据不虚构”原则——所有数字、价格、名称必须来自用户提供的来源,避免AI幻觉;同时提供经过验证的叙事结构(钩子-证据-对比-转折-行动号召)来替代通用的“你-你们”式独白,显著提升转化效果。技能还内置了防错机制,包括对竞品名称、承诺性语言和桥段复用的检查,以及交付前的10项验证清单,确保输出可直接用于拍摄或后期制作。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/robinfernandez2016-create/claqueta/tree/HEAD/skills/guion

在你喜欢的 AI 中提问

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

文档

脚本

一个好视频在录制之前就已决定:什么在前3秒停住手指,每一句台词对应什么画面,结尾引导观众去哪里。此技能将这一切整合到一份文档中,用于指导、录制、提词器和剪辑。

它是配方 reel、anuncio 和 tutorial 的“脚本”阶段(位于包根目录的 recetas/ 文件夹)。

1 · 简报

无需猜测字段,只询问缺失且会影响结果的信息。

字段询问内容
一句话核心创意观众必须理解什么
目标受众对谁说话,他们的痛点是什么
出镜方式真人出镜、画外音、动画角色;真实或合成语音
时长与格式Reel 最长40秒;视频广告5-15秒;竖屏或横屏
允许使用的数据每个数字、价格、期限或名称,均需注明来源
行动号召渠道用户通过什么渠道下单:WhatsApp、网站、店铺
禁忌禁止的词汇、主题、语气或格式
是否自带脚本如有,则按原文一字不差使用

如果用户提供了参考视频,请先使用 referencia 技能。

2 · 流程

  1. 寻找新思路。 指出这个视频相比该账号之前的作品有什么不同。
  2. 先设计前3秒: 0.5秒时看到什么,直到第3秒听到什么。
  3. 按句子编写,遵循第3节的结构。用“…”表示停顿。手势和眼神写在括号内,置于对应台词旁。
  4. 制作句子→镜头对照表(第4节)。
  5. 计时: 以自然语速大声朗读并计时,包括静默画面(如聊天记录、演示)的时长。不要通过字数估算。
  6. 构建生产脚本: 使用模板 referencias/guion-de-produccion.md。
  7. 展示并等待确认。 提供一份带有你建议的脚本,而非多个选项;如果是用于广告投放,附带一个备选钩子。最多提1-2个问题,仅限于数据或范围。用户回复“OK”即表示脚本通过,不代表后续阶段通过。

3 · 有效的结构

源自一份手写并最终获批的通用配方:以具体人物和提前告知结果作为钩子,战胜了以“你”为主语加列表理由的独白。

  1. 钩子 = 一句故事: 具体的人(“她”、“他”),发生了什么,以及提前告知的结果。留下悬念。格式:“[某人] [做或说了某件困难的事]… 但仍然 [结果](手势指向手机)。看看我们做了什么。”
  2. 证据可见: 聊天记录、演示、产品实际运行。旁白不读。
  3. 对比: 与过去的做法或客户当前的习惯对比,并用一句话点明论点(“这不是X。这是Y。”)。
  4. 转折: 一个行业的真实情感点,品牌作为短句主语(“[品牌] 保持…”),而不是其他事物的附属词(“[品牌] 的一项服务”)。
  5. 行动号召: 原因 + 命令 + 利益,命令前有停顿。

其他有效的钩子形式:问题、真实数字、动画角色或真实证言。绝对不要使用Logo或问候语。

示例结尾(虚构,用于一家鞋店;事实由用户提供):

“不试穿就买运动鞋很可怕… 给我们发WhatsApp,我们帮你选对尺码。”

已验证有效的格式:

  • 主持人 + 穿插B-roll(特写、B-roll、特写、B-roll)。钩子部分主持人在其手机上展示证据。
  • 两位朋友: 两位业内人士交谈;一位正受问题困扰,另一位已经解决。品牌名称只提一次,在最终推荐中且不带数据,以免显得像广告。
  • 动画角色 + 镜头: 仅当每个镜头精确对应句子时才有效。

有效的情感杠杆(在脚本中注明以便审查):开放循环、自豪感、恐惧、损失厌恶、共同敌人。绝对不要使用虚构的紧迫感、虚假名额或虚假案例。

4 · 句子→镜头对照表

每句台词一行。这是最常被修改的部分:一个画面精美且“相似”的剪辑会因“没有展示你说的内容”而被整体否决。

#台词(原文)画面来源~秒
1“又是尺码不对?”有人打开鞋盒,鞋子穿不进去实拍2.5
  • 每一行都要通过“这字面上相符吗?”测试。 如果说“不生锈”,就展示生锈的;如果说“无化学物质”,就展示被划掉的化学物质,而不是产品。
  • 如果客户的材料已经指定了镜头,就用那个。 “字面” 不允许更改。
  • 素材搜索顺序: 客户原始素材,然后是客户已筛选的素材和剪辑,最后是废弃素材。如果没有真实素材,使用有版权的素材库。如果没有,则生成(使用 generacion-ia 技能,之前经过 presupuesto 技能)。
  • 同一视频中不得出现重复镜头,包括该账号近期其他作品已用过的镜头。
  • 读取镜头内出现的文字。 一个图标、标签或屏幕可能自相矛盾。
  • 行业术语: 在选定镜头前先确认每个技术术语的含义。一个误解的术语会导致镜头错误。
  • 每个镜头持续3-4秒。 长句应拆分为两个镜头。聊天中消息的变化不算新镜头;不同的景别、角度或内容才算。
  • 在脚本中,“画面”部分只是描述。在剪辑前,重新制作包含每个镜头实际帧的表格,进行展示,通过后才进行剪辑。

5 · 不可违反的原则

  • 钩子必须在3秒内出现。 Reel的成败在于留存率:一个满足所有其他条件但钩子不强的脚本需要重写。
  • 录制前计时不超过40秒。 如果台词和证据超时,自行剪短消息、静默或句子,不要等待要求:仅仅告知“超时了”是不够的。
  • 画面必须字面匹配台词。 否则,观众会看到一件事,听到另一件事。
  • 禁止虚构数据: 数字、价格、期限、人物、客户、案例、证言。为了让内容听起来“量身定制”,使用所有格(“你的目录”、“你的声音”)。屏幕上出现的虚构名字会被当作真人姓名,迫使解释“这是谁?”。
  • 演示聊天中的名字是道具。 而被当作真实结果显示的数字则需要核实。
  • 生成的证言必须是明显的动画角色。 一个逼真的虚构人物讲述购物经历会被当作真实证言。
  • 数字必须基于相同基准。 “我们的客户成交额在X到Y之间”,不要用“你的业务将从A增长到B”如果A和B不是同一度量。价格比较必须基于相同数量,如使用了不确定的上限,必须加“最高”。混淆基准等于做出无法兑现的承诺。
  • 推导数字(如从每日数据推算年度总额)必须标注用户提供的假设。假设是你的,不是你的。
  • 听起来很小的数字应放在注脚,而非台词中。在话中提及小数字会削弱说服力。
  • 已确认的事实不要用弱化语气的填充词(“到今天为止”听起来不确定)。未经确认的事实不得使用。
  • 禁止承诺: 不保证结果、不限定名额、不精确时间(“几天内”而非几小时范围)。台词中的精确数字听起来像合同。
  • 行动号召必须包含 原因 + 命令 + 利益,并指向用户提供渠道。如果是WhatsApp,不要说“评论X”、“关注我们”或“个人资料链接”:目标是对话,而非粉丝。单独的命令句听感“太突然”。挑战性问题(“不信吗?”)也应导向私信。
  • 用户提供的封闭脚本必须一字不差: 即使是一个逗号也不能改。不要擅自加上行动号召或其他内容;将其作为单独一行提出。曾有一次擅自添加导致了撤回。
  • 标题要简洁。 避免陈词滥调(“寻找X。不是随便谁。”、“下一个病毒式传播”):听起来像模板,降低档次。最好直接陈述事实。
  • 提竞品名称时,必须经用户书面批准。
  • 结果是奖励。 脚本应为其分配专属镜头和音效,且在此处镜头不能拉开:恰好在支付时刻的拉远镜头破坏了情感。
  • 时间跳跃是镜头间的过渡,不超过1秒,带有音效;禁止使用静止字幕卡。

6 · 如果脚本包含聊天或演示

  • 回复方是品牌方,以第一人称说话:绝不能说“客服会确认”或“我转给你”。在演示中,这种措辞曾出卖过系统并得到纠正:回复的人就是客服本人。
  • 画外音可以对所有者说话(“你的团队”);聊天则对最终客户说话。
  • 聊天包含视觉元素: 产品图片、一条语音消息、文档(目录、付款信息)。绝不能只有文本气泡。
  • 头像使用人脸,而非缩写或Logo。
  • 只使用聊天或简报中已有的数据。
  • 外观应像真实应用(状态栏、气泡、时间戳、系统字体),而非虚构版本。
  • 如果主持人展示手机,屏幕上的聊天应与后续B-roll中的一致:这样才感觉真实。

7 · 发布文案

  • 使用与视频相同的行动号召,指向同一渠道。
  • 只包含视频中出现的、来源相同的数据。
  • 标题简洁。如果品牌指南禁止某些词汇,则不使用。
  • 交付;仅在用户要求时才发布。

8 · 数字

项目数值
Reel最多40秒
视频广告5至15秒
钩子0至3秒;第0.5秒必须停住手指
每个镜头3至4秒;除非别无他法,否则不超
新内容出现最多每4秒一次
时间跳跃最多1秒过渡
提交后提问1-2个,限于数据或范围
备选钩子每个广告投放脚本1个

9 · 已知陷阱

  • 录音稿不等于脚本: 录音时总是会有改动。在剪辑或动画前,使用Whisper转写录音,并按音频中每个词的结束时间而非转写文件来测量。
  • 同一脚本的三个版本会导致不同步(导演版、技术版、提词器版)。只用一个版本;提词器直接使用脚本中的台词行。
  • 产品文档可能落后于产品。 如果出现矛盾,以用户说的为准;记录在“数据与来源”中。
  • 其他工具的内容计划也可能滞后。 在标记脚本“准备就绪”前,向用户确认实际状态。
  • 参考视频中有效的数字不能照抄: 要么使用用户的真实数字,要么更换钩子。
  • “相似”的镜头不是所需的镜头。 如有疑问,则未通过字面测试。

10 · 交付内容及验证清单

交付生产脚本(.md 格式):创意、准备工作、拍摄顺序、镜头及其字面对应台词、句子→镜头对照表、剪辑备注、发布文案、备选钩子(如用于广告投放)、数据与来源、以及相较于上一版的变更。提词器直接使用脚本中的台词行,不做任何修改。

验证并在交付时说明:

  • 计时时长(台词加证据画面)在规定的最大值内。
  • 钩子已标记,时长不超过3秒。
  • 每个数字、价格、期限和名称均在“数据与来源”中有对应来源。
  • 每句台词都有对应镜头,且每个镜头通过字面测试。
  • 行动号召包含 原因 + 命令 + 利益,并指向简报中指定的渠道。
  • 提词器内容与脚本中的台词行逐字一致。
  • 如果脚本是用户提供的,未做任何改动(连一个逗号都没改)。

Individual skills in this repo

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

robinfernandez2016-create/color

Corrige e iguala el color de material real antes de montarlo o entregarlo. Detecta midiendo si un clip es S-Log3 o HLG de celular y lo pasa a Rec.709 (SDR), coloriza cada clip de apoyo antes de usarlo, iguala tomas con una LUT por toma, separa persona y fondo en dos capas, etalona en Premiere con Lumetri por script y revela fotos RAW. Úsalo cuando alguien diga «igualar el color», «corrige el color», «coloriza estos clips», «que todas las tomas se vean iguales», «se ve lavado», «se ve oscuro / amarillo / verdoso», «está muy frío», «la piel sale rara», «el celular sale naranja», «esto está en log», «en QuickTime se ve distinto», «revela estas fotos» o «la foto sale tumbada».

robinfernandez2016-create/control-calidad

El filtro por el que pasa todo render antes de que lo vea la persona. Mide duración y fps, escala y bordes, zonas seguras, negros, vídeo congelado, último fotograma, volumen y picos, siseo y alfa real; repasa la lista de errores que ya salieron; mide el ritmo con `referencia.py`; compara cada corrección con la versión anterior para no romper lo aprobado, y deja que un supervisor con veto firme «aprobado» o «cambios». Úsalo antes de cada entrega y cuando digan «revisa el render antes de mandármelo», «¿está listo para entregar?», «pásalo por control», «¿se rompió algo con el cambio?», «compáralo con la versión anterior» o «apunta esta corrección para la próxima».

robinfernandez2016-create/generacion-ia

Genera imágenes, vídeo y voz con IA (Higgsfield, Kling, Seedance, GPT Image, HeyGen, ElevenLabs y otros) sin desperdiciar créditos y sin que el resultado mienta. Elige el modelo según lo que haya en el plano, mantiene el mismo personaje dentro de la pieza, hace presentadores con voz clonada y lip-sync, compone croma sobre foto, protege el producto real del cliente (que se reproduce, no se recrea) y corrige editando lo aprobado en vez de regenerar. Siempre pasa antes por la skill `presupuesto`. Úsalo cuando digan «genérame una imagen», «hazme un vídeo con IA», «anima esta foto», «clona mi voz», «que hable sin grabarlo», «haz un 360 del producto», «mete este croma en la foto», «ponle otro fondo» o «no me gusta, hazlo otra vez».

robinfernandez2016-create/motion

Hace motion graphics como código con Remotion (gráficos animados, brolls, alfas sobre el vídeo o por detrás de una persona, pop-ups, subtítulos, simulacros de chat, 3D y la portada del reel) con la marca en un archivo de tokens, bocetos de 2 o 3 fotogramas antes del render y salida con fondo o con transparencia. Úsalo cuando digan «hazme un gráfico animado», «anima este dato», «hazme un broll», «un pop-up aquí», «ponle subtítulos», «subtítulos con palabras clave», «simula un chat de WhatsApp», «que salga detrás de mí», «hazlo en 3D», «con fondo transparente», «la portada del reel» o «renderiza el MG».

相关技能