guion-video-corto 是做什麼的？
依原型與認知層級製作的短影片
這項技能不是寫「一支通用的影片」。它首先辨別該影片需要什麼類型，亦即其意圖與受眾的認知層級。接著載入對應的劇本，並建立在一個通用於所有類型的留存引擎之上。外部數據僅作為假設處理。真正有價值的，是帳戶本身的數據。
產出物： 逐拍腳本（說什麼 + 螢幕文字 + 畫面） + 各平台說明文字 + 所使用的原型與認知層級。不負責產出影片：影片需另外拍攝或剪輯。
1. 主幹：認知層級（Eugene Schwartz）
這決定了腳本可以有多強烈的攻擊性。這不是風格問題，而是取決於觀看者是誰。
- 無意識： 不知道自己有問題。
- 意識到問題： 感受到痛苦，但不知道有解決方案。
- 意識到解決方案： 知道有解決方案存在，但不認識你的。
- 意識到產品： 認識你，但尚未被說服。
- 最有意識： 準備好了，只差一個優惠。
黃金法則： 只對已經感興趣的人（第 4–5 級）採取強烈攻勢。對冷門受眾（第 1–2 級）進行強烈推銷只會把他們嚇跑。這就是為什麼有機的發現影片不賣東西，而再行銷廣告則直接推向優惠。
2. 最重要的指標
決定分發的是早期留存率，而不是觀看次數。依此順序觀察：
- 3 秒留存率，即掛鉤之後還有多少人繼續觀看。這是鉤子的分數。
- 平均觀看時間，了解影片中間部分是否能維持住觀眾。
- 分享次數 ÷ 觸及人數，所能獲得的最強訊號。
- 非粉絲觸及人數，了解影片是否傳播出去。
- 粉絲增長 ÷ 觸及人數，了解個人檔案是否將注意力轉換為追蹤。
沒有神奇數字。 像「3 秒留存率 70%」這樣的目標四處流傳，卻沒有可驗證的來源：只能把它們當作假設。真正的參考點是帳戶本身的中位數。 一支影片若超過該中位數 3 倍，便是一個訊號。低於 1.5 倍則是普通的一天。
可節省數月的診斷：
- 有觀看次數卻沒增加粉絲的影片，問題出在個人檔案，而不是鉤子。
- 沒有觀看次數的影片，問題出在鉤子。
在重寫任何東西之前，先區分這兩種情況。
3. 路由器
辨別該影片屬於哪個原型，並載入其劇本。如果用戶沒有說明，請詢問或從目標推斷。
| 原型 | 認知層級 | 腳本的任務 | 攻擊性 | 典型 CTA | 渠道 | 劇本 |
|---|---|---|---|---|---|---|
| 發現 | 無意識 → 問題 | 讓自己被找到 | 零銷售 | 追蹤 / 儲存 | 有機 | playbooks/發現.md |
| 權威 | 問題 → 解決方案 | 讓別人相信自己 | 柔和 | 追蹤 / 留言 | 有機 | playbooks/權威.md |
| 養成 | 解決方案 → 產品 | 讓別人偏愛自己 | 中等 | 關鍵字 → DM | 有機 + 柔和再行銷 | playbooks/養成.md |
| 收單 / 廣告 | 產品 → 更有意識 | 讓別人現在就選擇自己 | 高 / 直接 | 預約 / 購買 / 申請 | 廣告（再行銷） | playbooks/收單-廣告.md |
| 見證 | 考慮 → 收單 | 驗證優惠 | 柔和 - 中等 | 關鍵字 → DM | 有機 + 廣告 | playbooks/見證.md |
每部影片有一個主導意圖。如果用戶想要「一支影片包含多種意圖」，請將它們分開成為不同的影片。
4. 工作流程
- 品牌 → 個人檔案。 如果
perfiles/<品牌>.md存在，載入它。如果不存在，使用perfiles/品牌-模板.md並在聊天中詢問最低限度的背景資訊。切勿虛構品牌數據。 - 原型 → 劇本。 使用第 3 節的路由器，並讀取對應的劇本。那裡有結構、鉤子的角度、攻擊性與 CTA。
- 通用引擎。 讀取
references/鉤子留存引擎.md和references/鉤子公式.md。選擇 3 種不同的公式，而不是同一公式的三個版本。分別為每個公式寫出口白與螢幕文字。 - 通過檢查器。 如果有終端機，執行
scripts/guion_check.py（第 8 節）並修正每個警告。如果沒有終端機，手動套用相同的規則。 - 建構腳本，依據劇本的結構與引擎。一拍一個想法，並串聯開放式循環。
- 平台。 根據
references/平台.md調整剪輯版本。不要在所有平台上發布相同的剪輯。 - 說明文字 + CTA 針對指定的平台，並使用劇本與個人檔案所指定的 CTA。
- 大聲朗讀。 「寫出來」的句子，一旦有人說出來就會被察覺。改寫所有聽起來不像真人在說話的內容。
如果用戶只想要鉤子，或只需要結構，則提供該部分。
5. 留存引擎（摘要）
基礎骨架，由各劇本調整：鉤子（0–3 秒） → 張力 → 帶有小循環的價值拍 → 證明 → 回報 → CTA。 詳細內容在 references/鉤子留存引擎.md。
適用於所有意圖的規則：
- 從動作中間或回報開始。不要用「哈囉，在這支影片中…」開頭。
- 不要在開頭放標誌或品牌。
- 第一幀要承諾影片會提供的內容。
- 每隔幾秒就進行剪輯或變化，如果影片超過 30 秒，在中間再加一個鉤子。
- 永遠要有字幕：影片必須能在無聲狀態下被理解。
- 螢幕文字是另一份腳本。
- 每張卡片最多 6 個字，鉤子的卡片必須出現在第一幀。
- 在 1080×1920 解析度下，遵守安全區域：不要高於 y=230，不要低於 y=1440，右側保留 230 像素的空白。請在每個平台的預覽中檢查。
- 每個拍子都要換畫面。 在一個 8 秒的固定畫面中，觀眾就會流失。
- 一支影片只講一個想法。 如果腳本有兩個想法，那就是兩支影片：請告知用戶。
- 數字優於形容詞。 如果缺少真實數字，請留
{{你的數字}}並告知用戶。切勿虛構。 - 見證與案例只有在真實且獲得使用許可時才能使用。
- 一部影片只用一種語言： 口白、螢幕文字與說明文字都使用同一種語言。
受監管的利基市場（健康、金融、法律…）
- 不要承諾結果或提出品牌無法證明的聲明。
- 在付費推廣的影片中，不要提及觀眾的個人屬性，例如「你過重嗎？」或「你有負債嗎？」。請談論服務與結果。
- 前後對比，只有在真實、獲得同意且平台允許的情況下才能使用。
6. 品牌個人檔案
品牌不會改變引擎：它只是為引擎「穿上衣服」。
perfiles/品牌-模板.md是一個空白模板。每個品牌填寫一次，並儲存為perfiles/<品牌>.md。- 如果未指定影片是為哪個品牌製作，請在寫作前詢問。
- 缺少的資訊（價格、期限、保證、數字）請標記為
[COMPLETAR]並告知用戶。
7. 交付格式
| # | 時間 | 口白（語音） | 螢幕文字 | 視覺 / 畫面 |
- 上方提供 3 種鉤子變體，用於 A/B 測試。
- 下方提供各平台的說明文字。第一行要短，帶有好奇心，在「…更多」之前。
- 最後加上標籤：原型 + 認知層級 + 平台。
8. 檢查器（scripts/guion_check.py）
使用 Python 3 編寫，無需依賴套件，並支援西班牙語與英語。
python scripts/guion_check.py hooks.txt # 每行一個鉤子 → 排名 0–100
python scripts/guion_check.py --hook "我因為一個沒人回覆的表單失去了 40 個客戶。"
python scripts/guion_check.py guion.txt --beats --objetivo 30 --ppm 160 # 每拍一行
它對鉤子進行五項檢查：
- 持續時間： 能在 3 秒內說完。
- 具體性： 包含數字、名稱或期限。
- 利害關係： 提及成本、損失或錯誤。
- 前置負載： 重要的部分放在最前面幾個字。
- 對誰說話： 使用「你」或指名特定受眾。
低於 50 分，還不算鉤子。
使用 --beats 時，它會檢查整個腳本並標記：
- 超過 3.5 秒的鉤子；
- 超過 4.5 秒的拍子；
- 連續三個拍子都沒有具體內容；
- 缺乏循環，當最後一行沒有回到鉤子的任何詞語時。
它不預測觀看次數：它會偵測問候語、開場白、空鉤子和冗長的腳本。
鉤子有 5 層，而這個腳本只測量語音與文字。在交付之前，請手動檢查這些層是否傳達相同訊息，並且都在前 3 秒內出現：
- 螢幕文字；
- 視覺，亦即第一幀看到的內容；
- 語音，第一句口白；
- 音效：音樂、效果音或刻意留白；
- 說明文字，其第一行。
如果有兩層互相競爭，請移除一層。
每分鐘字數： 透過測量已拍攝影片（字數 ÷ 分鐘數）來校準實際的人聲。在實際測量之前，西班牙語以 160 字/分鐘、英語以 170 字/分鐘作為起點，並請告知用戶。
9. 試播 Reels 與「語音 + 動態圖形」格式
試播 Reels 是 Instagram 先只向非粉絲顯示的 Reels。它們是免費測試鉤子的實驗室。
- 每個 Reels 都可以有一個使用另一個鉤子的試播版本，以便進行真正的 A/B 測試。
- 觀察 3 秒留存率、非粉絲觸及人數、分享次數與粉絲增長 ÷ 觸及人數。表現較好的版本再以一般方式發布或付費推廣。
- 建議維持可持續的產量，而不是一次大量發布。
語音 + 動態圖形格式不需要相機，適合大量產出：
- 真人語音另行錄製，動畫則在 After Effects 或其他工具中製作。
- 結構遵循引擎：第一幀的視覺鉤子 + 文字 → 4–7 個 2–4 秒的拍子，每個都有視覺變化 → 回報 → CTA。
- 此外，需交付一份動畫表，說明每個拍子的螢幕文字、視覺元素、動作與持續時間。
10. 檔案
playbooks/：每個意圖的結構。在第 2 步驟讀取。perfiles/：每個品牌的語調與身份。在第 1 步驟讀取。references/鉤子留存引擎.md：鉤子模式、留存、字幕、A/B 測試與一份已解決的腳本。在第 3 步驟讀取。references/鉤子公式.md：26 種西班牙語與英語的鉤子公式。在第 3 步驟讀取。references/平台.md：如何調整剪輯以適應 Reels、Shorts 與 TikTok。在第 6 步驟讀取。scripts/guion_check.py：本機檢查器。