Communitygithub.com

reel-from-raw

將原始直式談話頭影片(Hinglish 或英文,9:16 垂直)轉換為經過 Remotion 編輯的 Instagram Reel,包含靜音剪輯、拉近縮放、3D 標題、終端面板、漏光特效、音效及關注卡片。

reel-from-raw 是什麼?

此技能可將原始直式談話頭影片(Hinglish 或英文,9:16 垂直)自動編輯成專業的 Instagram Reel,使用 Remotion 框架。支援 macOS、Linux 與 Windows WSL 環境。工作流程包含專案建立、語音轉寫、靜音裁剪、節拍規劃、元件組裝、類型檢查、視覺檢查與音效設定。技能強制要求嚴格遵循現有設計模式與安全區域,不允許猜測時間點或無謂下載資源。所有疊加元素均需從 `work/words.txt` 的秒數參考,並使用 `src/` 中的庫元件。音效表與常見需求(如調整音量、更換鍵盤聲)皆有精確對應的處理方式與指令。

相容平台✓Claude Code~Codex CLI~Cursor✓OpenCode
npx skills add https://github.com/pawantekchandani/reel-from-raw/tree/HEAD/skills/reel-from-raw

在你喜歡的 AI 中提問

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

說明文件

從原始影片製作 Reel

已在兩個 Reel 上驗證:Linux Day 2 與 Linux Day 1(含音效)。library/Reel.tsx 是 Day 1 的 Reel。複製其模式。不要發明新風格。

可在 macOS 及 Linux / Windows WSL 上執行。設定方式:請參閱儲存庫中的 README.md。

嚴格規則

  1. 每個疊加元素的時間點都從 work/words.txt 的秒數參考。絕對不要猜測時間。
  2. 僅使用 src/(library)中的元件。僅在沒有任何庫元件符合某個節拍時才新增元件。
  3. 保持臉部清晰。安全區域(1080x1920):
    • 頂部標籤和標題:y 90 到 400。
    • 臉部和頸部:y 約 450 到 1350。此處除了全螢幕標題卡(最多 3 秒)外,不得放置任何東西。
    • 其他所有東西都放在頸部以下(襯衫的第一顆鈕扣):y 1360 到 1880。Panel 從 BELOW_NECK(1360)開始。使用 fit 來縮放較高的面板,使其結束於 1880。
    • 為每個新影片找到頸線:擷取帶有 y 網格的影格並觀察。更新 ui.tsx 中的 BELOW_NECK。
  4. 除非使用者在聊天中要求,否則不要渲染完整影片。使用 scripts/stills.sh 進行檢查。掛鉤會阻止未設定 RENDER_OK=1 的 remotion render。
  5. 未經使用者同意,不要下載任何東西(模型、字型、音樂、音效包)。
  6. 在除錯之前,請先閱讀 reference/known-problems.md。
  7. 在 OpenCode 中,外掛 ~/.config/opencode/plugins/reel-from-raw 的功能與 Claude 掛鉤相同(渲染阻止、類型檢查、靜止幀提醒)。使用讀取工具開啟圖表影像。如果你的模型無法看到影像,請要求使用者檢查圖表。

範圍規則(嚴格遵循)

  1. 只做使用者要求的事。僅更改請求所需的檔案和數值。
  2. 檢查(類型檢查、靜止幀檢查、來自掛鉤或外掛的提醒)就只是檢查。僅修正違反此檔案或 reference/style-spec.md 中規則的項目。絕不因為檢查而重新設定樣式、新增元件、新增場景、或更改文字、時間或音量。
  3. 如果你認為有其他東西應該更改,請用一行告訴使用者。不要更改它。
  4. 在處理影片時,絕對不要編輯 ~/.claude/skills/reel-from-raw/(此技能)。只編輯影片專案。
  5. 你建立的測試檔案(例如 src/__probe.ts)必須在完成前刪除。

工作流程(新影片)

執行每個步驟。每個腳本成功時會印出 OK:。遇到任何 ERROR 時停止並修正。

#步驟指令 / 動作
1建立專案bash ~/.claude/skills/reel-from-raw/scripts/new-project.sh <dir> <raw.mp4>(例如 ~/Coding/motion-videos/<name>)。它會複製庫、音效檔案和掛鉤,並安裝 npm 套件(或從 $REEL_SEED 複製)。
2轉寫bash ~/.claude/skills/reel-from-raw/scripts/transcribe.sh <dir> hi(僅英文時使用 en)。然後使用 reference/glossary.md 修正聽錯的部分。
3裁剪靜音python3 ~/.claude/skills/reel-from-raw/scripts/cuts.py <dir>。使用 --start/--end 來刪除錯誤的開頭或結尾。
4節拍表遵循 reference/beat-sheet-prompt.md。寫入 work/beats.md。如果使用者想要批准計畫,就顯示給他們看。
5建構src/Reel.tsx 是 Day 1 的 Reel。根據節拍表重寫它。在 Root.tsx 中,設定 id(例如 LinuxDay3)和實際的 handle。刪除 Reel 未使用的場景元件。保留 At 和 r() 輔助函式。
6類型檢查自動:掛鉤會在每次編輯後執行 tsc --noEmit。修正它回報的每個錯誤。
7視覺檢查bash ~/.claude/skills/reel-from-raw/scripts/stills.sh <dir> auto,然後讀取每個 out/stills/sheet*.jpg。同時檢查節拍影格:stills.sh <dir> 120,450,...。對照 reference/style-spec.md 進行檢查。修正並重複。
8音效檢查音效會隨元件提供(參閱「音效」)。檢查 public/sfx/typing.wav 和 public/sfx/pop.wav 是否存在。除非使用者要求,否則不要添加表格以外的音效。
9預覽在 launch.json 中新增一個項目,執行 npx remotion studio --no-open --port <free>。提供使用者 URL http://localhost:<port>。使用者在那裡聆聽音效。
10渲染(僅在要求時)RENDER_OK=1 npx remotion render <Id> out/<name>.mp4 --gl=angle(在背景執行,90 秒的影片約需 3-5 分鐘)。

音效

src/sfx.tsx 包含所有音效。SFX 列出音效。<Sfx src at volume frames name> 在目前 Sequence 的 at 影格播放一個音效。

SFX 中的鍵來源需要網路
whoosh、ding、click、switch、whip@remotion/sfx(remotion.media 上的檔案)是,適用於 Studio 和渲染
poppublic/sfx/pop.wav(由程式碼產生)否
typingpublic/sfx/typing.wav(由 scripts/make-typing-sound.py 產生)否

庫元件已經會播放這些音效。你不需要手動添加。

時機檔案(在專案中)音效音量
鉤子標題 / 子晶片scenes/Intro.tsx(Hook)whoosh / whip0.54 / 0.48
日標題卡scenes/Intro.tsx(DayTitle)whoosh / ding0.6 / 0.36
指令清單晶片scenes/Intro.tsx(CommandList)每個晶片 pop0.36
指令標籤 / 指令名稱scenes/Commands.tsx(CommandTag)whoosh / switch0.54 / 0.48
記事本行scenes/Commands.tsx(NoteCard)每行 typing0.6
下方面板出現ui.tsx(Panel)pop0.48
終端機指令輸入ui.tsx(Terminal)每個指令行 typing0.6
漏光Reel.tsxwhoosh0.48
完成徽章 / 關注點擊scenes/Outro.tsx(DayDone、FollowCard)ding / click0.48 / 0.72
任何未指定 volume 的 <Sfx>sfx.tsx(預設)-0.42

音量範圍從 0(無聲)到 1(最大)。保持所有音效低於人聲。

常見需求(確切配方)

使用者要求確實執行此操作
「將所有音效增加 / 減少 N%」將 <Sfx 行上的每個 volume={x} 以及 sfx.tsx 中的預設值乘以 (1 ± N/100)。四捨五入到小數點後兩位。不要碰 CutVideo.tsx(那是人聲)。在修改前後執行 grep -rn "<Sfx" src,並顯示更改後的數值。
「只改變鍵盤 / 打字音音量」只更改包含 src={SFX.typing} 的行(ui.tsx 的 Terminal 和 scenes/Commands.tsx 的 NoteCard)。
「只改變音效 X」在上面的表格中找到它的列。只更改那個 volume。
「鍵盤音太弱 / 製作一個新的」python3 ~/.claude/skills/reel-from-raw/scripts/make-typing-sound.py <project>/public/sfx/typing.wav。先保留舊檔案的副本。僅在使用者要求不同感覺時才編輯腳本中的數字。
「移除一個音效」刪除那一行 <Sfx .../>。
「我在渲染前能在哪裡聽到它?」Studio(步驟 9)。按下播放或空白鍵。每次儲存編輯後 Studio 會自動重新載入。
「我自己如何渲染?」終端機:cd <project> && npx remotion render <Id> out/<name>.mp4 --gl=angle。Studio UI:渲染按鈕(時間軸上方欄位的右端)→ 影片標籤 → 設定輸出名稱 → 渲染影片。進度顯示在「工作」標籤中。OpenGL 設定已經是 angle。
「渲染它」步驟 10,加上 RENDER_OK=1。然後提供輸出檔案的完整路徑。
「更改 handle」Root.tsx 中的 defaultProps.handle。

時間如何運作

  • src/timeline.ts:CUTS(移除的原始秒數),out(sec) 將原始秒數對應到輸出影格。
  • <At from={rawSec} to={rawSec} name="..."> 顯示該段說話內容的區塊。
  • r(t0, t) 在區塊內提供影格延遲,用於「當 t 時刻說出這個詞時彈出這個」。
  • CutVideo 在每個片段交替縮放 1.0 / 1.14(在每次剪輯上拉近)。不要增加更多縮放。

庫地圖

檔案匯出用途
theme.tsDISPLAY(Anton)、SANS(Inter)、MONO、顏色 C、extrude()所有文字和顏色。沒有新的字型或顏色。
sfx.tsxSFX、Sfx音效(參閱上方)
ui.tsxPop、useIn、useOut、BELOW_NECK、Panel、TermFrame、Terminal彈簧彈入、下半部面板、輸入終端機
scenes/Intro.tsxHook({title, sub, subAt})、DailyStep({children})、DayTitle({day})、CommandList({commands, line, lineAt})、LightLeak開場、章節過場
scenes/Commands.tsxCommandTag({n, total, name, nameAt, meaning, meaningAt, color})、FolderPath、FileGrid、MoveSwap、NoteCard每個章節一個主題:頂部標籤,Panel 中的視覺效果
scenes/Commands.tsx(Day 2,硬編碼文字)IdCard、OwnerSwap、PhoneApps、Snapshot、TopView、PdfSearch在重複使用前為文字新增 props
scenes/Outro.tsxDayDone({day})、NextDay({day, commands, at})、FollowCard({handle})結尾(NextDay 為選擇性)
Reel.tsxReel完整的 Day 1 Reel。將其用作結構範例。

更改文字時,保持大小、顏色和動畫效果。

相關技能