Community寫作與編輯github.com

影片腳本撰寫

撰寫聽起來就像說話者本人的影片腳本,適用於短影音(Reels、TikTok、YouTube Shorts)和長片 YouTube。輸出為可直接用於提詞機的格式。

影片腳本撰寫 是什麼?

這項技能專注於為社群媒體創作者和企業撰寫真人感十足的影片腳本。它與「影片剪輯」技能緊密配合,會生成三行編輯筆記,明確指出影片的鉤子、封面文字和最終承諾。核心信念是「腳本是一個真人的骨架,而非照稿朗讀」,因此它會優先閱讀 `voice-learnings.md` 檔案,該檔案記錄了說話者從過往影片中學習到的實際口語習慣。技能提供了清晰的結構指南,無論是針對短影音(鉤子、自我介紹、懸念、解答、結尾)還是長片(章節、重新互動點),都強調溫暖、放鬆的語氣,避免使用浮誇的銷售話術。輸出包括一個準備好的提詞機檔案(`script.txt`)、必要的編輯筆記(`edit-notes.txt`)和事實來源(`sources.txt`),以確保內容的真實性。它也處理法規遵循問題,並建議將免責聲明放在字幕中而非口述中,以使對話保持自然。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/builtnotboosted/built-not-boosted-skills/tree/HEAD/plugins/built-not-boosted/skills/video-scripting

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

影片腳本撰寫 是做什麼的?

此技能負責口白腳本及其編輯筆記。它會寫出這個人在鏡頭前要說的話,以其本人的語氣呈現,並設計成能抓住觀眾的注意力,同時提供三行簡短的編輯筆記給 video-editing 技能,讓剪輯師知道螢幕上的鉤子、封面文字以及承諾的結果。字幕和貼文文案歸 writing 技能,格式選擇和主題研究歸 research,剪輯本身歸 video-editing,品質檢查則歸 review-loop。

核心信念:腳本是一個真人的骨架,而非照稿朗讀。 在鏡頭前表現良好的人,會圍繞著稿子來解釋。為此而寫,影片聽起來就會像是他們本人在說話,而不是在播廣告。

開始之前

  1. 找到行銷工作區(預設為 marketing/)。如果沒有,一句話說明並提供 brand-setup,或詢問基本資訊:誰要說話、他們做什麼、為誰而做、以及在哪裡。
  2. 閱讀 brand/brand-profile.md:## Identity、## Audience、## Voice、## Boundaries、## Compliance、## CTA & contact。品牌簡介擁有品牌常數和法規用語的最終決定權;此技能負責方法。
  3. 每次寫腳本前,務必先閱讀 brand/voice-learnings.md。 這是這個人實際在鏡頭前說話方式的記錄,由 voice-loop 技能從他們的實際影片和手動編輯中學習而來。套用其當前的工作規則;若此處的通用指南與其有出入,則以它們為準。
  4. 如果存在,閱讀 brand/performance-learnings.md,了解過去有效的內容(格式、鉤子、長度)。
  5. 取得事實。任何主張、數字或引言都必須來自本人、簡報或 research 並附上來源。絕不虛構客戶故事、數字、引言或評論。如果沒有真實故事,就改為誠實的教育內容。

標準

  • 溫暖放鬆,而非急促。 與硬剪輯、高能量的喊叫式風格相反。給人邀請感、不慌不忙、有人情味。適合的地方加入輕鬆的幽默,但絕不以犧牲客戶為代價。
  • 聽起來像他們本人。 如果某句話不像他們會說的話,就改寫。使用白話、縮寫、以及多變的句子長度。
  • 與觀眾並肩,而非站他們前面。 避免使用「大多數人都搞錯了」、「人們常想」這類說法,因為這暗示觀眾可能錯了。改說「這很容易忽略」、「我們很多人都曾被教導」。避免空洞的誇張路標(例如「這裡有個沒人告訴過你的點」),因為這會讓觀眾等待回報;直接明白地介紹真正的重點。
  • 要有用,絕不推銷。 建立信任和粉絲群,讓詢問自然發生。
  • 每支短影音只傳達一個想法。 聚焦於你的觀眾實際會遇到的真實問題,而非空泛的內容。
  • 腳本文字中不要使用 em dash(破折號)。請使用逗號、括號或句號。

結構:短影音(30 秒到約 2 分鐘,務必低於 3 分鐘)

這是一個形狀,而非公式。許多創作者會將其視為「鉤子、懸念、傳遞、結尾」;我們用溫暖的方式做到。

  1. 鉤子。 一個完整的口語句子,大約 10 到 14 個字,清楚點出主題,並給出人類利害關係或誠實的轉折。不是預設場景、不是謎語、不是「嗨大家好」、也不是 Logo。張力存在於事實本身,而非誇大的表達方式。把它寫成他們會說的完整句子(很多人會自然地用「所以呢,」這樣的開場);簡短的片段式提問通常會在被鏡頭前改寫。
  2. 自我介紹與追蹤,緊接其後。 用本人自己的話簡短說明:名字、做什麼、為誰服務、以及如果是在地服務就加上地點,然後一個輕柔的追蹤邀請。範例形狀:「我是 Sam,我在高街的自行車店工作。給我一個追蹤,我們來看看。」讓自我介紹在不同影片間保持一致(這是它的目的);只需改變結尾部分,這樣一個下午拍攝的整批影片就不會以相同方式開場。把地點放在這裡,而不是鉤子裡。絕不作成果承諾,絕不乞求(例如「用力按讚追蹤」)。
  3. 懸念。 一到兩句話,通常來自他們的真實一週(例如「這周有位客戶來...」),讓觀眾感受到問題。它的作用是延遲解答,絕不給出解答。
  4. 傳遞。 一個明確的想法,不急不徐,用白話表達。完全兌現鉤子的承諾;如果鉤子用了數字或隱瞞了什麼,先把解答寫出來,並確保主體內容兌現了它。
  5. 結尾。 一個今天可以嘗試的小事,並附上相關問題:「今晚拿把尺量量你的鏈條。你的狀況如何?留言區告訴我吧。」一個線索、一個請求,表述為「這幫了我」,絕不說「你必須」。然後一句簡短、人性化的再見,獨立成行,用他們自己的話(一旦知道他們說什麼,就每次都保持一致)。

無劇透規則: 鉤子以及自我介紹後的第一行都不能透露答案。如果透露了,觀眾就得到了他們想要的,然後就會滑走。

結構:長片(約 8 到 15 分鐘,16:9 比例)

  1. 溫暖開場: 鉤子(影片的承諾),一個給新觀眾的輕柔自我介紹,如果願意,可以加上一個軟性的訂閱理由(「如果你覺得這有用,請留下來,還有很多類似的內容」)。
  2. 鋪陳: 設定問題框架,並說明觀眾將獲得什麼。
  3. 章節: 每個章節都是一個迷你「鋪陳、教學、回饋」循環。讓每個過渡變成一個向前的小鉤子,而非停頓點,並在大約三分之一和三分之二處計劃兩個刻意的重新互動點。腳本中的章節標記是給剪輯師看的靜默標記;觀眾看到的章節來自影片說明的時間戳。
  4. 回饋與結尾: 解決承諾,然後恰好三個要求:一件可以嘗試的事、指向他們另一部相關影片的指引、以及一個留言區問題。然後是適當的結尾。
  5. 寫作順序: 先寫回饋,再寫鋪陳,然後是張力,最後才寫鉤子,這樣鉤子才能誠實地反映影片實際提供的內容。
  6. 搜尋: 標題和說明應使用觀眾自己的話語來引導他們的問題(例如「為什麼我的鍋爐水壓會下降?」),而非解釋機制。

對於反應型腳本(新聞報導、價格變動、數據發布),以及更多鉤子模式和互動細節,請打開 references/hooks-and-retention.md。

長度與節奏

  • 長度跟隨故事。 不要為了湊片長而灌水,也不要為了達到 40 秒而刪減真正的解釋。當故事講完了,30 到 60 秒的短影片和 1 到 2 分鐘更完整的片段都沒問題。
  • 根據節奏調整篇幅。 在 voice-learnings 記錄下這個人測量出的節奏之前,假設約每分鐘 190 個字:30 秒約 95 字,1 分鐘約 190 字,2 分鐘約 380 字。刻意緩慢的單點式內容節奏較慢(約 150 字/分鐘),輕快的總結則較快(約 220 字/分鐘)。對於短影音而言,實際說出口的字數大約 500 字是實務上限。
  • 盡量貼近口語長度。 在早期,有些人會把腳本在鏡頭前擴展到兩倍長;一旦 voice-learnings 中「說出長度 / 寫入長度」的比例穩定接近 1.0,就可以直接寫出完整的長度。讓 voice-loop 的數字來決定。
  • 事實寫完整,意見寫要點。 人們幾乎會逐字讀出事實和引言,但會根據意見要點自由發揮。因此,將可驗證的事實和任何引言完整寫出,並將意見要點留作簡短提示。
  • 寫得比看起來滿意更直白。 裝飾性的用語在鏡頭前會被替換成更直白的版本。把技巧留給一個樸實的比喻和結尾重點句;具體、日常的影像最能經得起拍攝的考驗。

法規遵循

以品牌簡介中的 ## Compliance 為準。如果業務受到監管,或者影片促銷內容需要特定用語,預設做法是將必要的警告放在字幕中(由 writing 撰寫),而非口語中,這樣腳本才能保持人性化,而字幕則承載準確的用語。請檢查你自己的規則:某些法規或廣告政策要求警告出現在畫面上或口語中,此時品牌簡介會有說明,你就遵循它。無論如何,將張力放在真實事實中,絕不承諾成果(例如「你絕對會省錢」),並且不要在鏡頭前引用可能在上線前變動的價格或數字。英國金融服務的標記範例在 references/regulated-industries-example.md 中。

輸出(一個專案一個資料夾)

在 content/<yyyy-mm-dd>-<slug>/ 中:

  1. script.txt,準備好用於提詞機:僅有口語文字、乾淨的換行、無標題、無 em dash。思考暫停(每兩三句話以及回饋前留一個空行),讓說話者可以移開視線再回來,這也為剪輯提供了乾淨的剪輯點。三到六個拍攝提示,獨立成行,放在尖括號內並用大寫,緊接在它們適用的那行之前:<WALK IN>、<STEP CLOSER>、<HOLD COVER LOOK>、<B-ROLL: KEYS, DOOR>。詳細資訊和 PromptSmart 的範例在 references/prompter-and-edit-notes.md。
  2. edit-notes.txt,三行,絕對不要放在提詞機上:
    HOOK ON SCREEN: Gears slipping?
    COVER: CHECK THIS FIRST
    OUTCOME: you'll know the two usual causes of skipping gears and how to check one tonight
    
    HOOK ON SCREEN 是 3 到 5 個字,承諾但不給出答案。COVER 是 2 到 4 個真實、直白的文字,用於縮圖。OUTCOME 是觀眾獲得的東西;如果你自己不想要作為觀眾,就不要做這個影片。
  3. sources.txt:每個事實的來源。
  4. 基線副本: 將未經修改的 script.txt 副本保存到 baselines/<yyyy-mm-dd>/<slug>-script.txt。絕不編輯它。voice-loop 技能會比對這個人的編輯和他們的實際影片與基線的差異,這就是下一個腳本如何更貼近他們的關鍵。

然後,字幕和貼文標題由 writing 根據腳本和編輯筆記來撰寫。

發送前的檢查

將腳本和編輯筆記傳給 review-loop 進行檢查,或自行檢查:鉤子在頭幾秒內出現且不是劇透;自我介紹和追蹤出現得早,無成果承諾;懸念延遲了答案;鉤子中的每一個承諾都已兌現;一個「試試這個」的步驟並附上相關問題;簡短的再見;沒有「大多數人」、沒有空洞的誇張路標;螢幕上的鉤子是 3 到 5 個字且非答案;有思考暫停和拍攝提示;長度根據節奏調整;沒有虛構的故事或數字;根據品牌簡介符合法規;套用了 voice-learnings 規則;沒有 em dash。

調整

  • 你的用語: 將這個人的自我介紹和再見用語放在品牌簡介的 ## Voice 或 ## CTA & contact 中,並讓 voice-loop 從實際素材中精煉它們。
  • 多個主持人: 為每個人分別設定自我介紹,如果他們說話方式不同,則分開保存他們的 voice-learnings。
  • 你的提詞機: 任何提詞機應用程式都可以用;請確認一次其語音追蹤功能可以乾淨地跳過拍攝提示行。
  • 你的界線: 任何你不能給出建議或宣稱的內容,都放在品牌簡介的 ## Boundaries 中;腳本可以就此進行教育或提供指引,但絕不能讓你扮演那個角色。

參考資料

  • references/hooks-and-retention.md:鉤子模式、螢幕上鉤子、互動形狀、反應型和數據發布腳本、結尾。當鉤子不奏效或需要新聞反應時打開。
  • references/prompter-and-edit-notes.md:提詞機格式、拍攝提示、編輯筆記和拍攝習慣。在準備拍攝時打開。
  • references/worked-example-short.md:一個為中性小企業製作的完整短影音範例,包含腳本和編輯筆記。
  • references/regulated-industries-example.md:這如何應用於受監管行業(以英國金融服務為例)。

了解更多:https://builtnotboosted.com/skills/video-scripting

Individual skills in this repo

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

builtnotboosted/image-generation

Produces finished social images with any image model (Google Gemini image, "Nano Banana", as the worked example) - feed statics, carousel slides, short-form video covers, YouTube and article thumbnails, local listing cards and animated statics. Bakes the headline into the scene instead of pasting text on top, keeps text inside the profile-grid safe zone, locks the likeness of real people to their reference photos, hits exact platform sizes, writes alt text and re-judges every re-roll on the filed file. Use when someone says "make an image for this post", "create a thumbnail", "make a cover from my video", "design a carousel", "animate this static", "the image model won't do 4:5", "my headline is getting cut off in the grid", or when a content pack needs its visuals.

builtnotboosted/review-loop

The quality gate every piece of content passes before it is filed, scheduled or posted. Runs a self-critique, then an independent review by a fresh subagent that sees only the finished work and the criteria (never the builder's reasoning), then fix and re-judge until there is a clean pass. Covers what to do when a piece can't pass unattended (hold, flag, ship the rest). Use when someone says "review this", "check this before it goes out", "QA the pack", "is this ready to post", "get a second pair of eyes on this", "proofread the captions", or when any other Built Not Boosted skill hands work over for checks.

builtnotboosted/scheduling

Gets finished posts into a social media scheduler (or posted by hand) safely. Queue-only with explicit timezone offsets, live dedup against scheduled and already-published posts, media readiness checks, correct post types (shorts, reels, carousels, first comments, manual-posting reminders), alt text, a link gate that sends copy back for a rewrite rather than stripping it, and confirmation before anything goes live. Writes and keeps a scheduling manifest for each pack. Works with any scheduler; Publer is the worked example. Use when someone says "schedule this", "queue these posts", "put this in Publer", "book in this week's content", "post this on Tuesday at 7", "move that post", "what's already scheduled", or hands over a finished content pack to go out.

builtnotboosted/video-editing

Edits filmed talking-head footage into release-ready vertical shorts (1080x1920) and 16:9 YouTube long-forms with ffmpeg and Whisper. Keeps exactly one clean read of every script line (no stumbles, restarts or double reads), never leaves a flat single shot (punch-ins, reframes, B-roll, motion graphics), captions from the finished audio, normalises loudness to -14 LUFS, makes a real-frame cover and runs a QA gate that re-transcribes the render and refuses delivery until it passes. Syncs extra cameras by sound and writes YouTube chapters. Use when someone says "edit my video", "cut this clip", "remove my retakes", "edit out the fluffs", "add captions to my video", "make a short from this footage", "sync my two cameras", "make a thumbnail from my video", or hands over raw footage and a script.

相關技能