Communitygithub.com

tatacardona/Reels-FR-Doc-Juanes

將 Futuros Residentes / Doc Juanes 的原始影片(一人面對鏡頭說話、已錄製好的腳本)編輯成動態的 9:16 垂直 Reels,支援 Remotion。自動去除場記板、NG 片段、重複與靜音段落,清理音訊,添加逐字字幕(顏色強調且絕不擋住臉),在每個剪輯點切換鏡位,並可按要求疊加照片(含撕裂效果)、表情符號/貼紙(附音效)、過場光暈以及免版稅音樂。可在 Mac 與 Windows 上運作。

Reels-FR-Doc-Juanes 是什麼?

這是一個專為 Futuros Residentes 與 Doc Juanes 品牌設計的 AI 技能,用於將原始影片(例如一人面對鏡頭說話或已錄製的腳本)自動編輯成適合 Instagram、TikTok、Reels 或 Shorts 的 9:16 垂直動態影片。它基於 Remotion 框架,支援 Mac 和 Windows。核心功能包括:去除場記板與 NG 片段、清理音訊(降噪、去迴音)、逐字字幕(可自訂強調顏色,且絕不遮擋人臉)、自動切換鏡位、以及可選的視覺特效(如照片撕裂、貼紙、過場光暈)。該技能具備嚴格的審核流程:每次編輯前需提交計劃並獲得批准,並內建 Token 消耗預測與實際用量追蹤,協助控制成本。編輯決策需參考專屬的風格指南(`estilo.md`)與常見問題文件(`problemas.md`),確保產出風格一致。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add tatacardona/Reels-FR-Doc-Juanes

在你喜歡的 AI 中提問

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

說明文件

編輯 Futuros Residentes / Doc Juanes 的 Reel

在做出任何編輯決定之前,請先閱讀 references/estilo.md:這是已核准的風格以及每條規則背後的原因。 如果出現問題,請查閱 references/problemas.md:幾乎所有可能出錯的情況都已經發生過一次。 關於音樂,請參考 references/musica.md。

如何與提出影片需求的人合作

  • 使用清晰、無技術術語的西班牙文與對方溝通。對方可能不是程式設計師:請解釋你看到了什麼以及你將做什麼。
  • 在執行之前,請務必總結行動計劃並等待對方批准,這適用於每個階段(初始計劃、每輪修改、封面、音樂)。摘要需包含兩個標準:視聽標準(將做什麼,逐步說明)和財務標準:Token 消耗預估(請參閱「Token 消耗」)。你可以先準備和轉錄原始影片,以便計劃更具體。
  • 你無法收聽音訊。請透過測量和重新轉錄來驗證,並請對方收聽主觀部分:音效、音樂音量以及非常緊湊的剪輯。
  • 在每個版本中向對方展示影格和 MP4 檔案。當對方要求修改時,請在已編輯影片的對應秒數(對應 src/Reel/edit.json)定位,並確認是哪一句話。
  • 標記: 在計劃中確認影片是屬於 Doc Juanes 還是 Futuros Residentes (FR)。定義專案資料夾以及通知用的 Google Chat 空間(步驟 9)。
  • 命名: 在計劃中提議(或請對方提供)一個大寫並使用底線的短名稱(例如 JUANCHO_PASASTE);這也將作為專案資料夾的名稱。
    • 審查期間:每個版本都帶有編號,以免對方看到舊版本(「我沒看到變化」):NOMBRE_CORTO_REEL_v2.mp4、NOMBRE_CORTO_PORTADA_1.jpg……在下載資料夾中,只保留最新版本。
    • 當對方批准最終版本時,重新命名它們,移除所有其他內容,包括編號:NOMBRE_CORTO_REEL.mp4 和 NOMBRE_CORTO_PORTADA.jpg,並從下載資料夾中移除已廢棄的版本和封面。
    • 封面:一旦對方選定一個,立即將其重新命名為 NOMBRE_CORTO_PORTADA.jpg(不帶編號),放在下載資料夾和 out/portadas/ 中,即使影片仍在審查中,並移除其他選項。如果之後對方要求對已選定的封面進行調整,則覆蓋該同名檔案(不帶編號)。
    • 你發送給對方的測試圖片(字體、顏色、光線、效果、審查影格):NOMBRE_CORTO_PRUEBA_<主題>_N.jpg(例如 NOMBRE_CORTO_PRUEBA_FUENTES_1.jpg)。批准最終版本後,將它們與廢棄的版本一起移除:最終只保留 REEL 和 PORTADA。
    • 永遠不要使用 rm 刪除對方的檔案: 請使用 ./scripts/papelera.sh <檔案>(Mac 的垃圾桶或 Windows 的資源回收筒;可以還原)。
  • 音樂: 並非所有影片都需要音樂;僅在對方要求時才添加。切勿重複使用已用過的歌曲(列表在 references/musica.md 中),除非 Janeth 授權重複使用。
  • 互動式程式(例如 npx create-video)會在終端機面板的新分頁中執行:請告知對方點擊該分頁並在該處回應,並解釋每個問題。

誰可以修改此技能

此技能存在於 GitHub (github.com/tatacardona/Reels-FR-Doc-Juanes),且只有 Janeth Cardona 可以修改它。要確認你在哪台電腦上:git -C ~/.claude/skills/editar-reel-fr config user.email。

  • 如果顯示 [email protected] (Janeth 的電腦):在修改技能之前,務必先詢問她並等待她的同意;用一句話說明你要更改什麼以及這對所有影片有何幫助(如果她本人要求修改,則表示已批准)。僅針對單一影片的特定內容(歌曲、時間、位置、音量)應放在該專案中,絕不放在技能中。修改後:git -C ~/.claude/skills/editar-reel-fr add -A && git commit -m "<更改內容>" && git push。
  • 在任何其他電腦上:切勿修改技能檔案。 如果你發現一個對所有人都有益的改進或問題,請告知對方轉告 Janeth,並為對方寫好要發送的內容(發生了什麼、在哪個影片中、以及你的建議)。
  • 已使用的歌曲會記錄在 references/musica.md 中;在其他電腦上,請將歌曲標題、藝術家和連結提供給 Janeth,以便她添加。

Token 消耗(帳戶由整個團隊共享)

Claude 的每一步都會重新讀取整個對話:這幾乎是所有成本的來源,並且隨著對話長度而增加。 因此:

  • 每個影片使用一個新的對話。 當一個影片獲批後,建議為下一個影片開啟一個新的對話。在同一個對話中繼續可能會花費 2-3 倍的費用。
  • 批次修改: 請對方將所有修正集中在一個有編號的訊息中,並在一次匯出中應用它們。
  • 少讀、讀小: 使用縮小的影格條(SCALE=0.25-0.35),只讀取檔案和輸出的必要部分(tail、grep),僅重新轉錄有疑問的片段。大圖像成本很高。
  • 無需詢問的等待: 長時間的匯出在背景進行;不要每分鐘檢查。
  • 不要執行未要求的步驟: 僅在有人要求時才添加貼紙、音樂、AI 背景或額外搜尋。

每個計劃的預估(基於 30-45 秒真實影片的測量數據;以 Claude Opus 5.5 API 的公開價格計算,使用新對話)。顯示一個簡短表格,包含計劃的步驟、其範圍和總計,並說明這僅為預估值:

階段Claude 步驟數預估費用
準備、轉錄並提交計劃15-25US$ 1-2
視覺提案(字體、顏色、光線)含樣本8-15US$ 1-1.5
組裝編輯、文字審批並匯出 v120-35US$ 2-3
每輪修改 + 重新匯出10-25US$ 1-2.5
尋找並調整音樂10-20US$ 1-2
3 張封面8-15US$ 1-1.5
典型完整影片 (計劃、v1、2 輪修改、封面)80-130US$ 7-12

使用 Team/Enterprise 方案的帳單可能不同;此數字用於比較選項。如果對方想節省費用,請提供具體的替代方案(減少修改輪次、不使用音樂、不製作新封面,或為簡單影片使用更經濟的模型);決定權在對方。 在結束每個影片時,使用 python3 scripts/consumo.py --desde "<影片第一則訊息的文字>" 測量實際消耗,並與預估值一同分享。如果差異很大且你正在 Janeth 的電腦上,建議調整此表格。

步驟 0:工具(每台機器一次)並更新技能

git -C ~/.claude/skills/editar-reel-fr pull -q        # 獲取技能的最新版本(每個影片)
source ~/.claude/skills/editar-reel-fr/scripts/setup-tools.sh   # 匯出 $PY, $FF, $PROYECTOS, $DESCARGAS

在獨立環境中安裝完整的 ffmpeg、faster-whisper、DeepFilterNet(去除迴音)和 OpenCV。 第一次轉錄會下載 large-v3-turbo 模型(約 1.6 GB):在此之前請先徵求許可。

  • Mac: 需要 Node.js 和 Python 3(隨 Xcode 工具一起提供,或一次性安裝)。
  • Windows: Claude Code 使用 Git Bash,這些程式在該環境中執行。首先,一次性安裝 Python 3.11 和 Node.js LTS(winget install Python.Python.3.11 和 winget install OpenJS.NodeJS.LTS,需獲得對方許可;Python 3.12 或更高版本無效)。如果 Windows 上出現問題,請查看 references/problemas.md 並告知 Janeth。

步驟 1:Remotion 專案

  • 專案位於 $PROYECTOS/<品牌>/短名稱,其中 <品牌> = Doc Juanes 或 FR(Mac:影片 → Reels Doc Juanes;Windows:影片 → Reels Doc Juanes),每個影片一個專案。要複製的先前專案:在這兩個子資料夾中。
  • 最快的方法:從先前的專案複製 package.json、package-lock.json、tsconfig.json、remotion.config.ts、src/index.ts、src/index.css 和 src/Root.tsx,以及 node_modules(Mac:cp -c -R,即時克隆;Windows:npm ci)。如果沒有先前的專案:npx create-video@latest(選擇 Blank,Tailwind Yes),然後 npm i 和 npm i @remotion/google-fonts@<remotion 版本>。
  • 模板和腳本:cp -R ~/.claude/skills/editar-reel-fr/assets/template/src/Reel src/Reel 和 mkdir -p scripts && cp ~/.claude/skills/editar-reel-fr/scripts/* scripts/。
  • 註冊合成(請參閱 assets/template/Root.snippet.tsx)並添加 "resolveJsonModule": true。

步驟 2:準備原始影片

  1. 提取一個影格("$FF" -ss 20 -i crudo -frames:v 1 x.jpg)並查看:方向(如果人物側身,使用 ccw/cw)、牆壁顏色(決定關鍵字的顏色)以及臉部位置(FACE_ORIGIN)。
  2. FF="$FF" ./scripts/prep.sh "<crudo>" <none|ccw|cw> → public/video-vertical.mp4(包含提亮陰影的照明曲線;LIGHT=0 則移除)以及 work/ 中的音訊。
  3. 如果要求改善背景或光線(背景雜亂、上方光線導致臉部過暗):scripts/fondo-luz.py 使用 AI 分離人物,並創建帶有模糊背景、跟隨臉部的補光(如需要,還可在牆壁上添加彩色玻璃效果的光線)的 public/video-fondo.mp4。在 edit-config.json → "fondo" 中進行調整(請參閱腳本開頭的說明);在 build-edit.py 之後執行(僅處理使用的片段;如果片段更改,請重新執行,否則這些畫面將未經處理),並使用 VIDEO_SRC = "video-fondo.mp4" 啟動。事先向對方展示一個測試影格。 風格偏好是微妙:輕微模糊(5)、非常柔和的邊緣(14)以及非常淡的彩色玻璃/散景效果。

步驟 3:轉錄與對應

"$PY" scripts/transcribe.py          # 帶時間戳的句子 → work/transcript.json
"$PY" scripts/energy.py words        # 每個單詞相對於其句子的音量(+dB = 強調)

建立編輯對應表,並以簡短列表告知對方:

  • 移除: 場記板(「準備,第 N 鏡…」)、NG 片段(「再一次」、髒話、笑聲)、重複的句子(保留最乾淨的鏡次;通常是最後一次)、錯開始、結尾(「準備」)。
  • 鉤子: 第一句強而有力的句子;放在最前面。
  • 拉長的單詞(例如持續 3 秒的「不」)、奇怪的單詞或未轉錄的聲音 = 重複的鏡次或錯開始:單獨重新轉錄這些片段(使用 WhisperModel 處理音訊片段),並使用 energy.py zoom <開始> <結束> 進行微調。
  • 如果腳本中有錯誤的數據(說錯的數字),建議剪掉它;絕不使用 AI 模仿語音。

步驟 4:音訊

FF="$FF" PY="$PY" ./scripts/audio.sh   # 人聲更乾淨、更自然(DeepFilterNet + 柔和擴展器,−14 LUFS)
"$PY" scripts/energy.py                # 在乾淨的人聲上測量 → 更緊湊的剪輯
"$PY" scripts/sfx-stickers.py          # 僅在需要帶聲音的貼紙時
"$PY" scripts/sfx-tear.py              # 僅在需要照片撕裂效果時

步驟 5:edit-config.json:編輯決策

基礎:assets/edit-config.example.json。所有時間均為原始影片的秒數:

  • clips:每個句子或想法一個片段,按順序排列,並留有足夠的邊距。腳本會剪掉內部和外部的靜音,但絕不切割任何單詞。fx:punch(連續)、whoosh(主題轉換)、leak(彩色陽光光暈;適用於勵志影片,請參閱 estilo.md)、flash(白色閃光)。zoom 設定一個片段的鏡位;steps: [[秒, 縮放], …] 是一個不切斷音訊的鏡位梯級。hold_zoom: true = 單一鏡位。tail: 0.1 = 如果剪輯吃掉了結尾的柔輔音,則在片段末尾添加額外的邊距。
  • emphasis:[單詞, 秒] 對於說得有力或關鍵的單詞(大約每 1.5-2 秒一個)。
  • word_fixes:單詞的實際時間。之後確認它在片段內(如果落在先前的靜音中,它將從字幕中消失)。
  • idea_start:想法開頭的大寫字母(影響所有距離 < 0.1 秒的單詞:如果下一個單詞非常接近,例如「Y no」,則使用第一個單詞之前的時間)。
  • text_fixes:[{"at": 秒, "text": "pregunta:"}] 單詞的確切文字(例如保留「:」)。
  • brand_words(保護「Futuros Residentes」、「Doc Juanes」;添加其他如「UdeA」)、small_extra(永遠不會單獨出現的短詞:「fue」、「esa」、「mi」、「tan」……)。
  • photos:{src, show_at, tear_at}(撕裂)或 {src, show_at, hide_at}。
  • stickers(僅在要求時;範例在 assets/edit-config.stickers.example.json 中):{kind, show_at, hide_at, x, y, size, sfx: [[檔案, 秒, 音量]]}。類型:broken-heart(break_at)以及 src/Reel/Stickers.tsx 中 ART 的圖案。對於新的貼紙,將其繪製為專屬的 SVG(絕不使用 Apple 表情符號或受版權保護的圖像)。將它們放在人物移動手部的位置(查看影格),切勿放在臉部或字幕上。如果效果需要跟隨頭部,"$PY" scripts/head-track.py <開始> <結束> + follow_head: true 提供其逐影格位置(track)。
  • sounds:[[檔案, 秒, 音量, 偏移_秒]];shakes:帶有震動效果的秒數(衝擊)。
  • end_push: {at, to}:預設結尾,柔和地推近臉部(約 1.6 倍),無淡出至黑色。end_hold:結尾處的額外秒數。
  • speed:如果要求加速(請參閱步驟 7)。
  • 基礎字體(普通單詞):Montserrat Black 900,白色帶黑色邊框,除非影片品牌要求其他字體(例如 Futuros Residentes 的影片使用其網站字體)。
  • 強調的單詞:根據影片情緒在計劃中向對方提案,並在真實影格上提供 2-3 個選項:一種字體或兩種字體(例如,一種優雅/襯線字體用於情感部分,一種粗體字體用於衝擊部分),使用相同或不同顏色。字體和顏色需符合情緒(勵志、懷舊、活力、幽默……)。在 constants.ts 中設定 EMPH_*(第一種)和 EMPH2_*(第二種,在 emphasis 中標記為 "alt" 的單詞)。顏色必須與牆壁形成對比。
  • echo:[[開始, 結束]] 在具有重要意義的句子上添加柔和迴音(之後:"$PY" scripts/eco.py)。如果檢測到此類句子,請提案,或應要求應用。

……

[為翻譯而截斷]

相關技能