Communitygithub.com

Guion (劇本)

將創意簡報轉化為 Reel 或廣告的完整劇本,可用於錄製或生成。包含 3 秒鉤子、逐句結構、每句對應的鏡頭表格、行動呼籲與發文文案,並產出可直接用於提詞機的單一生產劇本。

Guion (劇本) 是什麼?

這個 AI Agent 技能(適合用於 Claude Code、Cursor 或其他開發工具)可以將一個行銷或內容創意簡報,轉化為一個 ready-to-produce 的影片劇本。它的核心價值在於,它不只是一個文字草稿,而是一個**單一文件**,整合了導演、錄製、提詞機閱讀和剪輯所需的所有元素。技能會自動引導使用者提供必要的資訊(如目標受眾、表現形式、允許的數據),然後遵循一個高度結構化的流程:先找出 3 秒鉤子以抓住注意力,再逐句撰寫旁白,並為每一句旁白建立精確的鏡頭指示(語言 → 鏡頭表格)。它強調「所見即所說」,嚴禁虛構數據、名稱或案例,確保內容的真實性。最後,它會產出包含拍攝順序、鏡頭清單、提詞機旁白文字以及社群媒體發文文案的完整生產腳本。這個技能特別適合處理如「幫我寫個 Reel 劇本」、「做一支廣告」、「我需要一個鉤子」等常見任務,並且明確支援 Reel、影片廣告和教學影片三種格式。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Guion (劇本) 是做什麼的?

一個好的影片在錄製前就決定了:在前 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
  • 每一行都必須通過「這是否 literal 地對應旁白?」的檢驗。 如果說「不會生鏽」,就要看到生鏽的東西;如果說「無化學成分」,就要看到被劃掉的化學成分,而不是產品本身。
  • 如果客戶提供腳本已指定使用哪個鏡頭,就使用那個鏡頭。 「literal」不授權你更改它。
  • 尋找鏡頭的順序: 客戶的原始素材,然後是他們已挑選的片段和剪輯,最後是被棄用的素材。如果沒有真實鏡頭,則使用有授權的庫存素材。如果仍沒有,則生成(使用 generacion-ia 技能,該技能會先經過 presupuesto 技能)。
  • 作品中的任何鏡頭都不能重複使用,包含在同帳戶其他近期作品中已出現過的鏡頭。
  • 閱讀鏡頭內顯示的文字。 一個標題、標籤或螢幕上的文字可能與訊息矛盾。
  • 專業術語: 在選擇鏡頭前,確認每個技術術語的含義。一個被誤解的詞會導致錯誤的鏡頭。
  • 每個鏡頭 3 到 4 秒。 一個較長的句子需要兩個鏡頭。聊天訊息內容的變化不算一個新鏡頭;不同的比例、角度或概念才算是。
  • 在劇本中,「看到的畫面」是描述。在剪輯前,需使用每個鏡頭的實際影格重新製作表格並展示,確認通過後才進行剪輯。

5 · 不可違反的規則

  • 鉤子在前 3 秒。 一個 Reel 的成敗在於留存率:一個完全符合清單但未能抓住注意力的案例,最終必須重做。
  • 最長 40 秒,在錄製前加總。 如果旁白和展示畫面超時,應主動刪減訊息、停頓或句子,不要等待要求:只告知「時間太長」是不夠的。
  • 看到的畫面必須 literal 地對應旁白。 否則,觀眾看到的和聽到的會不一致。
  • 不虛構任何數據: 數字、價格、期限、人物、客戶、案例或見證。若要聽起來像「量身定制」,請使用所有格代詞(「你的目錄」、「你的聲音」)。螢幕上出現的虛構名稱會被視為真實人物,導致需要解釋「那是誰?」。
  • 模擬聊天記錄中的示範姓名是道具。 但被解讀為真實結果的數字,則必須詢問確認。
  • 生成的見證必須是明顯的動畫角色。 一個逼真但虛構的人物講述其購買經歷,會被解讀為真實見證。
  • 數字必須基於相同基準。 「我們的客戶成交金額在 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 轉錄音檔,並以音訊中每個單詞的實際結束時間為準,而非轉錄文字。
  • 同一劇本的三個版本(導演、技術、提詞機)會不同步。 只使用一個版本;提詞機的內容直接取自旁白行。
  • 產品文件可能落後於產品本身。 如果出現矛盾,以客戶所說的為準;記錄在「數據與來源」中。
  • 其他工具的內容計畫也可能延遲。 在認為劇本「可錄製」前,先向客戶確認實際狀態。
  • 參考資料中有效的數字不能直接抄襲: 使用客戶的真實數字,或更換鉤子。
  • 「類似」的鏡頭不是真正的鏡頭。 如果存疑,就無法通過 literal 檢驗。

10 · 交付與驗證事項

交付內容為生產劇本 (.md):核心理念、準備事項、拍攝順序、鏡頭及其對應的逐字旁白、旁白→鏡頭表格、剪輯備註、發文文案、投放用劇本的替代鉤子、數據與來源,以及相較於前一版本的變更。提詞機的內容直接使用其旁白行,不得修改。

驗證事項(並於交付時說明):

  • 計時長度(旁白加展示畫面)是否在最大時限內。
  • 鉤子已標記且時長為 3 秒或以下。
  • 每個數字、價格、期限和名稱在「數據與來源」中皆有來源。
  • 每一句旁白都有對應的鏡頭,且每個鏡頭都通過 literal 檢驗。
  • 行動呼籲包含 理由 + 命令 + 利益,並導向簡報中指定的渠道。
  • 提詞機的內容與旁白行逐字吻合。
  • 如果劇本由客戶提供,則連一個逗號都未被更改。

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».

相關技能