Communitygithub.com

影片腳本撰寫工具

用於撰寫產品示範、功能導覽、發表影片或社群媒體影片腳本,協助使用者規劃影片結構、節奏與時間長度。

影片腳本撰寫工具 是什麼?

此技能旨在自動化影片腳本撰寫流程,涵蓋從輸入解析到最終輸出的完整階段。它支援多種輸入類型,包括行銷簡報、部落格文章、更新日誌、PR 連結、Git 參考範圍或直接描述,並能自動提取關鍵資訊。技能會引導使用者設定影片長度(短影片或中長影片)、腳本類型(旁白、雙欄或談話頭)以及語氣,並根據輸入內容推斷行動呼籲。在撰寫前,它會產生結構化大綱並取得使用者核准,然後依照指定的節奏與格式產出腳本,最後在終端機顯示並可選擇儲存為 Markdown 檔案。此技能適用於 Claude Code、Cursor 等 AI 編碼代理,流程嚴謹,並包含敏感內容檢查與錯誤處理機制。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AlemTuzlak/skills/tree/HEAD/skills/video-script

在你喜歡的 AI 中提問

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

說明文件

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

撰寫產品示範、功能導覽與發表影片的腳本。負責掌握節奏、視覺指示、時間安排與符合平台長度。

輸入解析

依序解析提供的引數:

  1. 指向現有行銷簡報的路徑(包含「執行摘要」或「關鍵訊息」的 .md 檔案)-> 行銷簡報
  2. 指向現有部落格文章的路徑(具有部落格文章結構的 .md 檔案)-> 部落格文章
  3. 指向現有更新日誌的路徑 -> 更新日誌
  4. 指向現有電子報的路徑 -> 電子報
  5. 符合 GitHub URL 或 #\d+ 模式 -> PR
  6. 包含 ... 或 .. -> Git 參考範圍
  7. 解析為現有檔案/目錄 -> 程式碼庫功能
  8. 否則 -> 自由文字

若未提供引數,請詢問:「影片要關於什麼?你可以提供行銷簡報、部落格文章、更新日誌、PR 網址/編號、Git 參考範圍、檔案/目錄路徑,或直接描述功能。」

若有多種解讀相符,請與使用者確認。

流程圖

digraph video_script {
    rankdir=TB;
    "解析輸入" [shape=box];
    "第一階段:探索" [shape=box];
    "第二階段:設定" [shape=box];
    "第三階段:大綱" [shape=box];
    "大綱已核准?" [shape=diamond];
    "第四階段:撰寫" [shape=box];
    "第五階段:審查" [shape=box];
    "已核准?" [shape=diamond];
    "第六階段:輸出" [shape=box];

    "解析輸入" -> "第一階段:探索";
    "第一階段:探索" -> "第二階段:設定";
    "第二階段:設定" -> "第三階段:大綱";
    "第三階段:大綱" -> "大綱已核准?";
    "大綱已核准?" -> "第三階段:大綱" [label="否,修訂"];
    "大綱已核准?" -> "第四階段:撰寫" [label="是"];
    "第四階段:撰寫" -> "第五階段:審查";
    "第五階段:審查" -> "已核准?";
    "已核准?" -> "第四階段:撰寫" [label="修訂"];
    "已核准?" -> "第六階段:輸出" [label="是"];
}

請勿跳過任何階段。 以自然的節奏提問。如果使用者一次回答多個問題,接受打包的答案並跳過後續相關問題。

如果使用者說「直接使用預設值」或類似內容,選擇合理的預設值,說明你的選擇,並要求一次確認。

第一階段:探索

步驟 1 - 分析輸入

輸入類型需讀取內容
行銷簡報提取問題陳述、價值主張、受眾、關鍵訊息。跳至步驟 3。若簡報缺乏產品背景,仍執行步驟 2。
部落格文章提取標題、關鍵重點、受眾、行動呼籲。跳至步驟 3。
更新日誌提取關鍵條目,聚焦於影響最大的變更。跳至步驟 3。
電子報提取主旨、重點更新、行動呼籲。跳至步驟 3。
PRdiff、PR 描述、審查評論、提交訊息。對於大型 PR(20 個以上檔案),聚焦於面向使用者的變更。
Git 參考範圍參考範圍間的 git diff 與 git log。優先處理面向使用者的變更。
程式碼庫功能讀取指定的檔案/目錄。
自由文字解析使用者的描述。若缺乏細節,請使用者提供更多資訊或指向特定檔案/PR。

面向使用者的變更包括:新功能、UI 變更、API 變更、效能改善、錯誤修正與文件更新。內部變更包括:重構、測試新增、CI 變更與相依性更新。

錯誤處理:

  • gh 不可用 -> 告知使用者,提供替代輸入
  • 無效的 PR/參考 -> 請使用者確認
  • 找不到檔案 -> 要求提供正確路徑

步驟 2 - 閱讀更廣泛的產品背景

讀取以下項目(若存在):README、docs/、package.json(或同等檔案)。

若找不到任何內容,請詢問:「你能簡單描述一下這個產品以及它的目標使用者嗎?」

步驟 3 - 呈現理解

「以下是我將據以撰寫影片腳本的內容:」

  • 功能 A - 簡短描述
  • 功能 B - 簡短描述

「有什麼要新增、移除或修正的嗎?」

在使用者確認範圍之前,請勿繼續。

步驟 4 - 敏感內容檢查

在繼續之前,掃描潛在的敏感內容:安全修補程式、內部定價、憑證、未發布的路線圖項目,或標記為機密的內容。向使用者標記任何可疑內容。

第二階段:設定

詢問以下問題:

Q1 - 影片長度:

  • 短影片(30-90 秒) - 社群媒體(Reels、Shorts、TikTok)
  • 中長影片(3-5 分鐘) - YouTube、產品示範、導覽

Q2 - 腳本類型:

  • 旁白 - 在螢幕錄影/素材上朗讀的敘述文字
  • 雙欄 - 左欄:視覺指示/螢幕動作,右欄:旁白
  • 談話頭 - 演講者對鏡頭,對話式表達

Q3 - 語氣: 閱讀現有儲存庫內容以偵測語氣。確認:

「根據你現有的內容,語氣似乎是 [例如:對話式且對開發者友善]。我應該沿用這種語氣,還是換個方向?」

若無內容可分析,直接詢問。

Q4 - 行動呼籲(CTA): 從上下文推斷:

  • 開源 -> 「為專案加星」、「試用看看」
  • SaaS -> 「免費註冊」、「開始試用」
  • 功能更新 -> 「立即嘗試」、「查看文件」

「我建議行動呼籲為:[推斷的 CTA]。想用這個還是換一個?」

第三階段:大綱

產生結構化大綱並附上時間安排。根據影片長度使用適當範本:

短影片(30-90 秒)- 3-4 個章節:

## [暫定標題] - [總時長]

1. **鉤子** (0:00-0:05) - [手法]
   - 關鍵要點
   - 視覺: [顯示內容]

2. **問題** (0:05-0:15) - [需建立的痛點]
   - 視覺: [顯示內容]

3. **解決方案** (0:15-0:45) - [功能導覽]
   - 關鍵要點 A
   - 視覺: [顯示內容]
   - 關鍵要點 B
   - 視覺: [顯示內容]

4. **行動呼籲** (0:45-0:60) - [要採取的行動]
   - 視覺: [結束畫面]

預估總計:約 X 字(約 Y 秒,以 135 WPM 計算)

中長影片(3-5 分鐘)- 5-8 個章節:

## [暫定標題] - [總時長]

1. **鉤子** (0:00-0:10) - [手法]
   - 視覺: [顯示內容]

2. **問題** (0:10-0:30) - [痛點、背景、為何重要]
   - 視覺: [顯示內容]

3. **解決方案概述** (0:30-1:00) - [高層級說明你所建置的內容]
   - 視覺: [顯示內容]

4. **深入探討:[功能 A]** (1:00-2:00) - [導覽]
   - 關鍵要點
   - 視覺: [螢幕錄影步驟]

5. **深入探討:[功能 B]** (2:00-3:00) - [導覽]
   - 關鍵要點
   - 視覺: [螢幕錄影步驟]

6. **深入探討:[功能 C]** (3:00-3:45) - [導覽]
   - 關鍵要點
   - 視覺: [螢幕錄影步驟]

7. **回顧** (3:45-4:30) - [總結主要優點]
   - 視覺: [摘要投影片或並排比較]

8. **行動呼籲** (4:30-5:00) - [要採取的行動]
   - 視覺: [結束畫面]

預估總計:約 X 字(約 Y 秒,以 135 WPM 計算)

根據所涵蓋的功能調整深入探討章節的數量。

呈現大綱,並在撰寫前等待核准。

第四階段:撰寫

節奏參考

影片長度目標字數WPM
30 秒~65 字130
60 秒~135 字135
90 秒~200 字135
3 分鐘~400 字135
5 分鐘~675 字135

對話式表達的目標 WPM 為 130-145。標記任何超過分配時間的章節。

依類型的腳本格式

旁白腳本:

## [標題]

### 鉤子 (0:00-0:05) - ~15 字
視覺: [螢幕上顯示內容的描述]

[旁白文字。]

### 章節名稱 (0:05-0:20) - ~30 字
視覺: [螢幕上顯示內容的描述]

[旁白文字。]

雙欄腳本:

| 時間 | 視覺 | 旁白 |
|---|---|---|
| 0:00-0:05 | [螢幕:登陸頁面載入] | [旁白文字] |
| 0:05-0:15 | [螢幕:點選設定選單] | [旁白文字] |
| 0:15-0:30 | [螢幕:切換深色模式] | [旁白文字] |

談話頭腳本:

## [標題]

### 鉤子 (0:00-0:05) - ~15 字
攝影機: [演講者對鏡頭,中景]

[演講者文字。對話式,直接對著鏡頭。]

### 章節名稱 (0:05-0:20) - ~30 字
攝影機: [切換到螢幕錄影]
旁白: [在螢幕錄影上朗讀的旁白]

攝影機: [回到演講者]
[演講者文字。]

鉤子

前 3-5 秒決定觀眾是否繼續觀看。鉤子必須:

  • 針對痛點或提出挑釁性問題
  • 不要以你的公司/產品名稱開頭
  • 不要以「在這支影片中,我將向你展示...」開頭
  • 立即引發好奇心或情感共鳴

視覺指示

無論腳本類型為何,務必內嵌視覺指示:

  • 視覺: / 螢幕: 用於螢幕錄影和素材
  • 攝影機: 用於談話頭的鏡頭指示
  • 要具體:「螢幕:點選匯出按鈕,顯示 PDF 下載」而不是「螢幕:展示功能」
  • 在場景之間包含轉場備註

每個章節的時間安排

為每個章節包含預估時長和字數:

  • ### 章節名稱 (0:15-0:30) - ~30 字
  • 若任何章節超出時間預算,請標記
  • 總腳本字數必須符合以 135 WPM 為基準的目標時長

撰寫規則

  • 對話式,聽起來不像照本宣科。按照人們實際說話的方式撰寫。
  • 短句。每個句子最多 10-15 字。
  • 每個句子一個想法。
  • 始終使用主動語態。
  • 在生成的內容中永遠不要使用破折號。不要出現「---」字元。改用逗號、冒號、句號或括號。
  • 展示,不要只是說明。「看看這個載入速度有多快」優於「它載入得很快」
  • 對於中長影片,使用三的法則:三個優點、三個功能、三個例子。對於短影片,專注於單一關鍵優點。

行動呼籲

  • 影片的最後 5-10 秒
  • 單一、明確的行動
  • 包含結束畫面的視覺指示(訂閱按鈕、連結覆蓋層、QR 碼)

第五階段:審查

呈現完整腳本並附上時間分解:

「這是腳本:」

[完整腳本]

時間分解:

  • 鉤子:5 秒(~15 字)
  • 問題:10 秒(~25 字)
  • 解決方案:30 秒(~70 字)
  • 行動呼籲:10 秒(~20 字)
  • 總計:55 秒(~130 字,以 135 WPM 計算)

「需要任何修改嗎?」

等待核准。只有在使用者確認後才能進入輸出階段。

第六階段:輸出

始終在終端機中列印最終核准的腳本。

然後詢問:「要我將它儲存到 scripts/<slug>.md 嗎?還是其他路徑?」

若目錄不存在則建立。若檔案已存在,詢問是要覆寫還是建立版本化副本。

錯誤處理

  • gh 不可用 -> 告知使用者,提供替代輸入
  • 無效的 PR/參考 -> 請使用者確認
  • 無產品背景 -> 請使用者描述產品
  • 腳本超出目標時長 -> 標記並在審查前建議刪減

此技能不做的事

  • 錄製或編輯影片
  • 產生縮圖或視覺素材
  • 建立動畫或動態圖形
  • 撰寫部落格文章或社群文案(請使用 /blog-post 或 /social-copy)

Individual skills in this repo

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

AlemTuzlak/skills

Use when the user wants to write a blog post about a feature, product change, PR, git diff, or any technical topic - accepts marketing briefs, PRs, git refs, codebase paths, or freeform descriptions as input

AlemTuzlak/skills

Use when the user wants to generate a changelog, release notes, or document what changed between versions, tags, or PRs

AlemTuzlak/skills

Use when writing, editing, or organizing documentation, when planning what docs a feature needs, and whenever planning or implementing a new feature or change in a repo (docs ship with the code). Also use when tempted to write docs without showing the discovered readers to the user, without asking for tone, or without loading simple-english and i-have-adhd. Triggers on "write docs for X", "document this feature", "add a guide", "update the docs", "reorganize the docs", "plan feature X", "implement X", or /docs.

AlemTuzlak/skills

Use when a bug is in play: a test fails, CI is red, an API returns the wrong result, a stack trace appears, or the user says it is broken or fix this. Don't use for a new feature with no failure, for types-only work, or for docs.

AlemTuzlak/skills

Use when the user invokes /i-have-adhd, says they have ADHD, or asks for ADHD-friendly output. Also used as a required writing filter by the docs skill. Don't use for marketing copy or after the user says "stop adhd mode" or "normal mode".

AlemTuzlak/skills

Use when a settled change must be turned into an ordered stack of small blocks before anyone implements. Don't use for unsettled intent, typos, comments, formatting, docs-only work, or writing the implementation itself.

AlemTuzlak/skills

Use when the user wants to write a product update email, feature announcement newsletter, or digest email for users or subscribers

AlemTuzlak/skills

Use when the user wants to turn a raw talking-head / screen-share recording into a finished, edited, annotated video plus a full content package. Removes silences, flags mistakes for the user to cut, transcribes, adds transcript-synced overlays (code, on-screen code highlights, word highlights, lists, comparisons, diagrams, section labels, punch-in zooms), renders with original audio, then generates blog/socials/YouTube content. Triggers on "produce a video", "edit my video", "annotate my recording", "/produce-video".

AlemTuzlak/skills

Use when the user runs /prove-it or says prove it, prove the changes, show me in the browser, or asks to prove a UI or API change. Don't use only because the agent is about to say done, for types-only work, or for docs with no behavior to prove.

AlemTuzlak/skills

Use when the user wants to write, draft, or author an RFC (Request for Comments) / technical design doc for a feature, change, or architectural decision. Interactively interviews the user, grounds the proposal in the actual codebase, presents 2-3 concrete API/code-snippet approaches to choose from, then writes a review-ready RFC. Triggers on "write an RFC", "draft an RFC", "RFC for X", "design doc for X", or /rfc.

AlemTuzlak/skills

Use when the user wants to deeply learn a new topic from scratch. Runs a pre-interview (current knowledge, end-goal proficiency, depth, practice load, background, scope), researches online (articles, niche-influencer blogs, canonical docs, subtopic landscape), then produces a structured markdown course with mandatory visual diagrams, evidence-based learning-science features (retrieval practice, spaced callbacks, worked-example fading, concept ledger, jargon gate, analogy hygiene), and a self-contained interactive HTML mini-course. Triggers on /teach-me, "teach me about X", "I want to learn X", "deep dive on X", "create a course on X", "study X with me".

AlemTuzlak/skills

Use when the change intent is already settled and the agent must map what a behavior change touches before an implementation plan or any code. Use for new features, bug fixes, and refactors that move a boundary. Don't use for typos, comments, formatting, lockfile-only diffs, docs with no code, or while the user is still deciding what they want.

AlemTuzlak/skills

Use when the user wants to transcribe a video or audio file to text with word-level timestamps — spins up a self-contained local Whisper (whisper.cpp) Docker service bundled in this skill and returns transcript.txt, transcript.srt, and word-level transcript.words.json. Also used as a building block by /produce-video. Triggers on "transcribe this video", "get a transcript", "transcribe-video".

AlemTuzlak/skills

Use when the user wants YouTube metadata for a video — a click-worthy title, an SEO/above-the-fold description, tags, and timestamped chapters. Accepts a transcript (ideally timestamped SRT), a topic, a PR, or a freeform description. Used standalone and by /produce-video. Triggers on "youtube title", "youtube description", "youtube chapters", "youtube tags", "youtube metadata", "youtube-copy".

相關技能