編輯 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-25 | US$ 1-2 |
| 視覺提案(字體、顏色、光線)含樣本 | 8-15 | US$ 1-1.5 |
| 組裝編輯、文字審批並匯出 v1 | 20-35 | US$ 2-3 |
| 每輪修改 + 重新匯出 | 10-25 | US$ 1-2.5 |
| 尋找並調整音樂 | 10-20 | US$ 1-2 |
| 3 張封面 | 8-15 | US$ 1-1.5 |
| 典型完整影片 (計劃、v1、2 輪修改、封面) | 80-130 | US$ 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:準備原始影片
- 提取一個影格(
"$FF" -ss 20 -i crudo -frames:v 1 x.jpg)並查看:方向(如果人物側身,使用ccw/cw)、牆壁顏色(決定關鍵字的顏色)以及臉部位置(FACE_ORIGIN)。 FF="$FF" ./scripts/prep.sh "<crudo>" <none|ccw|cw>→public/video-vertical.mp4(包含提亮陰影的照明曲線;LIGHT=0則移除)以及work/中的音訊。- 如果要求改善背景或光線(背景雜亂、上方光線導致臉部過暗):
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)。如果檢測到此類句子,請提案,或應要求應用。
……
[為翻譯而截斷]