Communitygithub.com

Pedrovbm1/guion

撰寫簡短解說影片(Reels、TikTok、Shorts 或 3D 動畫解說)的腳本,包含有來源的研究資料、每句一個概念的口語對話風格,以及一輪 0 號審查員(A 留存率、B 資料、C 清晰度),在投入配音或動畫前設定門檻。最後停在「腳本完成」階段,供使用者確認。

guion 是什麼?

這個技能專為 AI 代理(如 Claude Code、Cursor、Codex)設計,用於撰寫簡短解說影片的腳本,涵蓋 Reels、TikTok、Shorts 或 3D 動畫解說。其核心價值在於「腳本是成本最低、也最容易被忽視的問題」——在影片完成後重寫腳本耗費數小時,但以文字審閱則只需幾分鐘。因此,技能會強制停在「腳本完成」階段,待使用者確認後才繼續。技能會建立一個專案資料夾,內含 `voz/frases.txt`(每行一句話)、`MAPA.md`(視覺腳本與資料來源)和 `DECISIONES.md`(決策記錄)。 流程包含:接收點子(如有參考影片則分析其主題與成功要素,但絕不抄襲)、以高努力度搜尋有來源的資料、依嚴格風格規則撰寫(每句一個概念、日常口語、前 3 秒鉤子、每 5-8 秒微鉤子、結尾循環與提問)。最後進行 0 號審查:三個平行子代理分別檢查留存率(A)、資料正確性(B)和對新觀眾的清晰度(C),分數達標(A≥9、C≥9、B 無高風險問題)後才輸出「腳本完成」訊息。此技能適合任何需要從零開始撰寫解說影片腳本的情境。

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

在你喜歡的 AI 中提問

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

說明文件

解說影片腳本

腳本是最便宜修復、卻最昂貴才發現問題的東西。當影片已經製作完成後重寫腳本要耗費數小時;以文字閱讀只需一分鐘。因此,這個技能永遠會在 腳本完成 處暫停。

輸出:一個專案資料夾,內含 voz/frases.txt(每行一句話)、MAPA.md(視覺腳本 + 有來源的資料)和 DECISIONES.md。若與 explicador 技能搭配使用,專案已由 nuevo.py 建立,MAPA 即是 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 要說明如何繪製以避免看起來像眼睛。

撰寫 voz/frases.txt 和 MAPA:一個表格,包含每一句話、它的關鍵字(決定畫面變化的字)、該關鍵字時畫面上顯示的內容、確切的標題文字(如果有的話)及其大約秒數。

4. 第 0 輪 MAPA 審查(僅文字,在配音與動畫之前)

同時啟動 3 個獨立的審查員(子代理,使用中等模型如 Sonnet,努力度 medium;B 審查員使用 high)。每位審查員閱讀 voz/frases.txt 和 MAPA.md,不閱讀其他人的審查結果,並提交 revision/REV_<字母>_mapa_v<N>.md,附上評分 /10 和確切的修改建議(哪一句、哪個詞、哪個標題)。任務說明在 RONDA0.md 中。

  • A · 留存率: 無音訊的第 0 畫面、鉤子 < 3 秒、承諾與兌現、微鉤子、超過 5 秒無變化的段落、循環、結尾提問、時長。
  • B · 資料: 每個數字對照其來源(由審查員驗證)、每個說出的數字都要有對應標題、畫面上不能有任何 MAPA 中沒有的內容。
  • C · 對陌生人的清晰度: 像 15 歲的人那樣複述腳本;列出每個未經解釋的詞語、名稱、縮寫或數字;標記含有多個概念或小字(「一般來說」、「一個情境,不是預測」)的句子。為每個句子提出改寫版本並確定時長。

套用修改,並重複直到 A ≥ 9 且 C ≥ 9 且 B 無高風險發現,最多 2 輪。如果第二輪仍未通過,就暫停並將腳本連同備註發送給使用者:不繼續製作。

5. 腳本完成(強制暫停)

在一次訊息中,在聊天視窗內(非檔案)發送給使用者:

  • 純文字腳本(10-12 行),
  • 估計時長和第 0 輪審查備註,
  • 資料及其來源,
  • 最多 4 個問題。

你的回合以 腳本完成 結束。在用戶回覆之前,不要產生配音或啟動動畫。即使使用者說「一次完成」,此步驟也不可跳過:那適用於研究與建構,而非此步驟。

Individual skills in this repo

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

相關技能