Communitygithub.com

從逐字稿產生字幕

根據影片或腳本,產出準確且時間軸正確的字幕檔(SRT 或 WebVTT)。

從逐字稿產生字幕 是什麼?

這項技能專門用於從影片或敘述腳本中產生高品質、時間軸精準的字幕檔(SRT 或 WebVTT)。它的主要用途是確保字幕對所有觀眾(特別是聽障人士)友善,並在教學影片中強化重要的 UI 術語。技能優先使用現有的敘述腳本作為「正確文本」,因為腳本在技術名詞和 UI 標籤上已經正確無誤;若無腳本,則使用語音辨識(ASR)後再人工校正,避免 ASR 常犯的產品名稱、程式碼和縮寫錯誤。時間軸對齊上,字幕提示要對應語音,每則提示至少顯示 1 秒、最長 7 秒,每行 32-42 個字元,閱讀速度不超過每秒 17 個字元。輸出格式支援通用的 SRT 和適合網頁播放器的 WebVTT,並且會進行 QA 檢查,確保時間軸沒有漂移。這項技能不處理字幕的樣式、顏色、位置或動畫,這些會交由後續的社群影片格式工具處理。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SkillMedev/tutorial-video-studio/tree/main/skills/captions-from-transcript

在你喜歡的 AI 中提問

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

說明文件

從逐字稿產生字幕 是做什麼的?

字幕不是選擇性的修飾,而是無障礙設計的必要元素。它能讓觀眾在靜音狀態下繼續觀看,對於教學影片更能強化特定的 UI 術語。這項技能能產出乾淨、時間軸精準的字幕檔。樣式設定與燒錄到畫面上的工作則留給後續步驟。

先取得最準確的文字

準確度取決於你的起點:

  • 如果有敘述腳本,直接用它作為正確文本。 腳本在技術名詞和 UI 標籤上已經正確無誤。只需將它對齊音訊,而不是從頭重新轉錄。
  • 否則,先轉錄音訊(使用 Whisper、平台內建的自動字幕或其他 ASR),然後根據影片進行校正。ASR 經常搞錯產品名稱、程式碼和縮寫——請逐一修正,確保與螢幕上顯示的內容完全一致。

永遠不要直接使用未經校正的 ASR 輸出。錯誤總是集中在最重要的詞彙上。

將提示對齊語音

  • 每則提示應該在台詞開始說話時出現,並在台詞結束時消失——對齊語音,而不是任意時間間隔。
  • 最短顯示時間約 1 秒(即使是很短的提示),最長約 7 秒。超過這個時間就要拆分提示。
  • 句子中間不要有間隔;句子之間可以有短暫間隔,這有助於閱讀。

行數與閱讀規則

  • 每則提示 1-2 行,絕不超過 3 行。
  • 每行約 32-42 個字元。超過這個長度會讓字幕佔據畫面太多空間,超出安全區域。
  • 閱讀速度 ≤ 約每秒 17 個字元(大約每分鐘 160-180 字)。如果一則提示的閱讀速度超過這個上限,文字會閃得太快——請拆分提示或延長其顯示時間。
  • 在子句邊界處斷行,不要在片語中間斷行。像「開啟設定頁面」這樣的片語要保持完整;不要把「開啟」單獨放在一行。

選擇格式

  • SRT - 通用格式:索引 + HH:MM:SS,mmm --> HH:MM:SS,mmm + 文字。適用於上傳到大多數平台和編輯軟體。
  • WebVTT(.vtt) - 帶有 WEBVTT 標頭,使用 HH:MM:SS.mmm 時間戳記,支援提示的定位和樣式設定。適用於 HTML5 <track> 標籤和網頁播放器。

輸出必須有效且可解析——時間戳記標點符號要正確(SRT 在毫秒前使用逗號,VTT 使用句點),提示之間用空行分隔,結尾不要有多餘空白。

乾淨版 vs 逐字版

對於教學影片,使用乾淨版字幕:刪除填充詞(「嗯」、「啊」、重複開頭),但保留語意不變。技術名詞、程式碼和 UI 標籤必須完全保留。只有在使用者明確要求(法律、研究、精確引用等情境)時才使用逐字版。

QA 檢查同步

對照實際影片進行抽樣檢查——開頭、中間和結尾各檢查一次,因為時間軸漂移會逐漸累積。確認提示在對應的台詞出現時顯示,並在下一句開始前消失。修正任何停留在錯誤畫面上的字幕。

交接

完成的 .srt / .vtt 檔案會交給 social-video-formatter 進行燒錄和平台樣式設定,或直接提供給網頁播放器的 <track> 元素。顏色、字型、位置和動畫等設定留給後續步驟——這項技能只產出準確、時間軸精準的文字,不做其他事情。

不要做的事

  • 不要設定樣式、顏色、位置或將字幕燒錄到畫面上——這些是 social-video-formatter 的工作。
  • 不要逐字製作動畫——這是 kinetic-typography 的工作。
  • 不要輸出未經校正的 ASR;錯誤總是集中在最重要的詞彙上。
  • 不要為了避免拆分提示而塞進 3 行文字或超出閱讀速度限制——直接拆分提示。

Individual skills in this repo

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

Kinetic Typography

Put text in motion the right way - title cards, animated captions, lower-thirds, callouts, and word-by-word reveals - with a reading-time-per-word budget so copy holds long enough to read, plus enter/exit timing, weight and size transitions, and type hierarchy in motion. Use when someone asks to

Motion Design Principles

The craft layer for motion: pick the right easing (ease-in / ease-out / ease-in-out / spring), get timing and spacing right, build the anticipation→action→follow-through arc, and apply Disney

Narration Script

Write the spoken voiceover for a tutorial or demo - the actual words, phrased for the ear and synced one-instruction-per-action to what is on screen, with a pacing budget and a confident, jargon-checked tone. Use when someone says

Product Demo Director

Direct the craft of putting a real software UI on screen - cursor choreography, zoom/pan/callout language, screen-recording vs recreated-UI, and making state changes legible with highlights, focus pulls, and slow-downs. Use when filming or recreating an app for a product demo, feature walkthrough, onboarding clip, or release reel and asking

Remotion Compose

Turns a natural-language video brief into a complete, ready-to-preview Remotion composition - extracts duration, scenes, brand colors, aspect ratio, and real copy; plans the frame budget; and writes data-driven React/TypeScript using useCurrentFrame, interpolate, spring, AbsoluteFill, and Sequence, registered in Root.tsx. Use when someone says

Remotion Render

Renders a Remotion composition to MP4 and runs the edit-and-re-render loop - CLI render commands, 1080p/4K/9:16 presets, concurrency tuning, codec selection, batch variants from a JSON data file, and Lambda for cloud rendering. Use when someone says

Remotion Setup

Scaffolds a new Remotion video project wired for Claude Code Agent Skills - Node check, create-video scaffold, skills install, folder conventions, Google Fonts, and a smoke-test render. Use whenever someone wants to start making videos with Remotion and Claude, even just

Screencast Capture

Capture clean raw screen and camera footage for a tutorial or product demo - choosing the recorder (macOS Screenshot toolbar, QuickTime, OBS, Windows Game Bar), setting resolution / frame-rate / cursor / microphone, prepping a distraction-free stage, and recording in retakeable segments. Use when someone says

SkillMedev/tutorial-video-studio

Plan a product demo, feature announcement, or launch video as a beat sheet and shot list BEFORE animating - hook in the first 3s, problem, reveal, proof, CTA - with target duration and pacing per scene type, output as a JSON scene plan that remotion-compose consumes directly. Use when someone says

Social Video Formatter

Reframe and export a finished video for social platforms - 9:16 ↔ 16:9 cropping, burned-in captions, a platform-native first frame, loop design, and per-platform specs (aspect, length, safe areas) for TikTok, Reels, Shorts, X, and LinkedIn. Use when someone says

Sound and Music Sync

Score a video like an editor: beat-match cuts to the music, land SFX on transitions, pace the voiceover so it breathes, source royalty-free tracks safely, and duck the music so the VO sits clearly on top. Use when adding music, sound effects, or voiceover to a video, when asked to

相關技能