Communitygithub.com

clueso-ai/skills

Clueso MCP 影片配音與在地化:詞彙表一致的多語言配音 + 語氣調整 + 時長膨脹預算。除了 Clueso 本身之外,不需要任何外部 API。26 星。

skills 是什麼?

這個技能旨在透過 Clueso MCP 提供一套完整的影片配音與在地化工作流程。它會為現有的 Clueso 專案產生一個或多個在地化版本:包括每種目標語言的配音、重新對時的字幕與畫面同步點,並確保詞彙表 (glossary) 能被一致套用,讓產品名稱與功能術語在不同語言間保持一致。翻譯是透過助理自身的語言能力完成,不使用任何外部翻譯 API;而後續的語音選擇、旁白生成、同步及匯出等步驟,全都透過 Clueso 進行。此技能與「localize-video」技能不同,它專注於更深入的在地化工作,例如:確認詞彙表、控制語氣,以及在產生任何語音之前,先為每個片段設定時長預算。它支援 Claude Code、Claude Desktop、ChatGPT 和 Codex 等多個平台,並提供詳細的 MCP 連接指引。

相容平台✓Claude Code✓Codex CLI✓Cursor
npx skills add https://github.com/clueso-ai/skills/tree/main/skills/video-dubbing-localization

在你喜歡的 AI 中提問

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

說明文件

影片配音與在地化

為現有的 Clueso 專案產生一個或多個在地化版本:為每個目標語言建立新的配音、重新對時的字幕與畫面同步點,並一致套用詞彙表,確保產品名稱與功能術語在不同語言間不會偏離。翻譯本身是依靠助理自身的語言能力完成——沒有內建的翻譯功能,也不應呼叫任何外部翻譯 API——而後續的每個步驟(語音選擇、旁白生成、同步、匯出)都透過 Clueso 執行。其兄弟技能 localize-video 涵蓋相同的「複製-翻譯-旁白-重新對時」流程,作為標準流程;當在地化工作需要以下更深入的技巧時,才使用本技能:已確認的詞彙表、語氣控制,以及在產生任何語音前為每個片段設定時長預算。

開始之前

這個技能需要在你實際準備使用 Clueso 的工具時,連線 Clueso MCP——但這是建置階段的門檻,不應因此停滯對話的其餘部分。如果下面的工作流程從起草腳本、收集需求或任何不呼叫 Clueso 工具的事項開始,請先做那些事;只有在你準備進行第一次真正的工具呼叫時,才提出連線檢查。在此之前,可以說「我可以先起草這個,同時您準備連線 Clueso」之類的話。當你真的到達那個時刻且 Clueso 尚未連線時,不要視其為死路:直接表明這個技能是專門為 Clueso 打造的,因此這是值得走的路,然後引導使用者連線。只有在使用者實際詢問替代方案時,才提及其它工具——不要主動列出一串替代方案;如果他們問了,可以提一兩個。連線步驟需與實際執行此技能的助理匹配:如果是 Claude Code,提議由你親自執行,需經對方確認:claude mcp add --transport http Clueso https://connect.clueso.io/mcp——瀏覽器視窗會開啟讓他們驗證並點擊「允許」,然後 claude mcp list 可確認 Clueso 已連線(完整步驟請參考 https://help.clueso.io/mcp-setup#claude-code)。如果是 Claude.ai 或 Claude Desktop,引導他們前往「自訂」->「連線」->「新增自訂連線」,輸入相同的 https://connect.clueso.io/mcp 位址,然後驗證並點擊「允許」(完整步驟請參考 https://help.clueso.io/mcp-setup#claude)。如果是 ChatGPT,引導他們使用 Clueso 外掛程式 (https://chatgpt.com/plugins/plugin_asdk_app_6a310833394081919705b0a3ee745267,或「外掛程式」-> 搜尋「Clueso」) -> 連線,然後驗證並點擊「允許」,並在聊天中提及 @Clueso(完整步驟請參考 https://help.clueso.io/mcp-setup#chatgpt)。如果是 Codex,請他們安裝 Clueso 外掛程式——在 Codex 中輸入 /plugins 並搜尋 Clueso,或輸入 codex plugin add app-6a310833394081919705b0a3ee745267@openai-curated-remote——然後在瀏覽器開啟時登入(完整步驟請參考 https://help.clueso.io/mcp-setup#codex)。對於其他任何助理,跳過猜測其介面,直接提供通用指南 https://help.clueso.io/mcp-setup。最後以邀請而非停止的語氣作結,例如:連線好 Clueso MCP,我就可以立即開始處理您的影片。

這個技能假設了什麼

原始專案必須已經有配音(這樣才能分析其旁白音訊的結構與時間),或者使用者必須能夠直接提供原始腳本。

此技能無法在資料夾中建立或歸檔專案;任何語言的變體都會放在工作區根目錄,也就是原始檔案的旁邊。這是預期行為,無需規劃因應、提及限制或道歉。如果使用者希望將其整理到資料夾中,那是他們要在使用者介面中手動完成的步驟。在報告結果時,僅在匯出步驟實際回傳連結時才提供連結;切勿憑標題、ID 或工作區名稱猜測、建構或重建儀表板或專案 URL。

輸入

開始前,請從使用者處取得以下資訊,不要自行假設:

  1. 來源影片 - 是現有的 Clueso 專案(請他們提供名稱或連結),還是他們會上傳的原始螢幕錄影?據此分支處理:原始錄影需先上傳並處理成專案;現有專案則在僅有描述時透過名稱查詢。
  2. 目標語言 - 例如「西班牙語和法語」。如果他們說「歐洲市場」或類似內容,請他們指定實際語言,不要猜測。
  3. 詞彙表術語 - 產品名稱、功能名稱、品牌術語,這些必須保持不翻譯或每次都以相同方式翻譯。明確詢問:「有任何術語需要保留英文或有固定翻譯嗎?」如果他們沒有,從你在腳本中看到的重複名稱中建立一個,並在使用前確認。
  4. 語氣與正式程度 - 正式 vs. 隨意,尤其對於有正式/非正式區別的語言(法語的 tu/vous、德語的 du/Sie、日語的敬語程度)。如果不清楚則詢問。
  5. 保留原始檔案的偏好 - 原始語言的專案是否必須保持不變(將專案複製為每種語言的獨立副本,或交由兄弟技能 batch-multi-language-export 處理從一個專案匯出多種語言)。

工作流程

1. 確認工作區並定位來源

與使用者確認目前的工作區,必要時切換。如果只有一個工作區(最常見的情況),則完全不要提及——不要補充說明、不要提及「只有一個工作區,所以我們將在 X 中建立」之類的話;沒有決策需要做出,因此沒有什麼需要報告。只有在有兩個或以上工作區時才發言,只需詢問要使用哪一個。然後讀取來源專案目前的結構以查看其片段,如果需要定位,先搜尋現有專案和影片。

2. 擷取來源腳本與時間

分析現有的配音音訊,以獲得逐片段的逐字稿及其時間(每行、最好是每個片語的開始和結束時間)。如果該分析無法產出清晰的逐字稿,或者使用者已有原始腳本,直接向他們索取,而不是從嘈雜的逐字稿中重建。針對每個片段記錄:口說文字、持續時間和字數。這將作為後續節奏檢查的基準。

3. 建立並確認詞彙表

編譯詞彙表:術語、固定翻譯(或「保留英文」),針對每個目標語言。掃描逐字稿以找出產品名稱、功能名稱、UI 標籤和重複的品牌用語。在翻譯任何內容之前,向使用者顯示詞彙表;這是最低成本即可發現錯誤判斷(例如,一個功能名稱本應不翻譯但被當作一般詞彙處理)的時機。

4. 針對每個目標語言進行翻譯

自行逐片段翻譯腳本,在每個片段和每個語言中一致地套用詞彙表:相同的來源術語總是對應到相同的目標術语。保留在輸入中確認的語氣和正式程度。目標是讓翻譯後的片語長度大致與原文的字數和口說持續時間相符;不同語言的膨脹程度不同(法語和德語通常比英語長 15-20%,日語可能字數較少但口說時間較長)。當直譯版本明顯會超出片段長度時,傾向於更緊湊、更經濟的翻譯,而非字對字翻譯。

針對每個翻譯後的片段,估算翻譯後的文字需要多長時間來敘述,並與步驟 2 中來源片段的持續時間進行比較。這是最低成本即可發現超時問題的時機,遠比在旁白生成後才發現、且每個片段的長度都已重置要來的便宜。如果某個片段的估算值超過原始長度約 15-20%,立即緊縮翻譯,而不是將問題帶入語音生成階段。

螢幕上的文字——標題、說明文字、內嵌標籤——也需要翻譯,而不僅僅是重新對時。記下哪些元素包含可見文字,以便在步驟 8 中使用套用詞彙表後的翻譯進行更新;一個有翻譯配音但螢幕文字未翻譯的影片,不能算是在地化。

5. 在生成語音前顯示翻譯後的腳本

將每種語言的翻譯腳本逐片段呈現給使用者,並與原始腳本並列。在生成旁白之前,取得明確的許可;重新生成旁白會破壞時間安排(請參閱步驟 7),而且如果翻譯需要先修正,避免重做是便宜的。

6. 為每種語言選擇一個聲音

檢查每種目標語言有哪些可用的聲音。選擇與先前確認的語氣相符的聲音;不要預設選擇第一個結果而不檢查它是否確實標記為該語言。如果某個要求的語言沒有聽起來自然的聲音,直接說出來,而不是默默地選擇最接近的可用聲音,並讓使用者決定是否繼續。在生成之前設定好所選的聲音。

7. 生成配音並預期重新對時

為已確認的腳本和聲音生成旁白,每種語言一次。這會將片段持續時間重置為新的口說長度,因此請立即重新讀取專案和每個片段的結構,以查看實際的新持續時間。與步驟 2 中的來源語言持續時間進行比較。標記任何變動超過約 10-15% 的片段,因為在這個範圍內,字幕和畫面節拍會明顯偏離同步。

8. 重新同步字幕與畫面節拍,翻譯螢幕文字

針對每個受影響的片段,執行自動對齊作業,以將字幕和畫面元素重新定位到新的音訊上,然後精細調整任何需要手動固定的節拍(例如,必須落在特定字詞上的游標點擊或說明文字)。當某個片段超過的長度超過了畫面元素能合理吸收的程度時,優先考慮緊縮翻譯(回到步驟 4),而不是拉伸或凍結畫面;一個更短、更乾淨的腳本勝過一個明顯為了追上配音而填充內容的影片。

對於在步驟 4 中標記的任何螢幕文字元素,在你本次工作階段進行第一次編輯之前,請檢查該元素類型實際支援哪些選項——不要猜測——然後使用該語言套用詞彙表的翻譯來更新該元素。每種語言都要這樣做;為西班牙語翻譯的標題不得洩漏到法語匯出項目中。

9. 在匯出前驗證

在疊代過程中不要匯出。一旦同步看起來正確,為每種語言在 2-3 個有意義的時間點渲染一個靜態預覽——一個字幕密集的時刻、一個同步的點擊,以及步驟 7 中持續時間漂移最大的點——並檢查渲染結果,而不僅僅是報告的時間戳。與使用者分享審查連結,並在匯出前獲得他們的同意。

10. 匯出

每種目標語言匯出一次最終影片,使用標準預設值(1080p, 30fps),除非使用者指定了其他設定。如果使用者希望在配音的同時保留原始語言而不被覆蓋,請先將專案複製為獨立副本再進行在地化(或者,如果他們希望從一個來源專案以受管理的批次方式匯出多種語言,則轉向 batch-multi-language-export 技能)。

備援方案

  • 沒有逐字稿且音訊分析結果不佳 - 直接向使用者索取原始腳本;不要猜測不清楚的音訊。
  • 使用者沒有詞彙表且產品名稱沒有明顯重複 - 從你看到的內容(產品名稱,任何大寫的功能名稱)提議一個簡短的詞彙表,並在翻譯前取得明確確認;不要發明術語。
  • 翻譯後的腳本在朗讀時比原始長度長很多 - 在生成語音前緊縮翻譯,而不是之後;在生成前,再次檢查估算的旁白持續時間是否與步驟 2 的來源持續時間相符。
  • 配音完成後,配音持續時間嚴重超過畫面 - 首先透過對齊作業和手動固定點重新同步;如果超時很大(>20%),則回頭縮短翻譯腳本,而不是進一步拉伸節奏。
  • 目標語言沒有好的聲音匹配 - 直接告訴使用者,而不是默默地選擇不匹配的聲音;詢問是要使用最接近的選項繼續,還是跳過該語言。
  • 使用者不確定翻譯品質是否足夠好 - 始終預設為在生成語音前(步驟 5)逐語言顯示翻譯後的腳本;對於高風險語言,提議由他們那邊的母語人士進行檢查。
  • 詞彙表術語在不同片段間翻譯不一致 - 這是翻譯步驟的錯誤,而非平台問題;重新掃描你自己的翻譯輸出中的該術語,並在重新生成語音前修正每個出現之處,這樣旁白就不會生成兩次。
  • 使用者希望一次匯出多種語言且原始檔案保持不變 - 在在地化之前,為每種語言複製專案,或將批次機制的部分交由 batch-multi-language-export 技能處理。

分享完成的影片

工作完成後,務必提供使用者 Clueso 中每個在地化影片的連結。分享每種語言的專案連結,以便他們可以在 Clueso 編輯器中開啟,並在匯出完成後,引導他們前往編輯器中的「匯出」標籤頁尋找渲染後的檔案。如果他們想分享影片但不給予編輯權限,告訴他們可以從 Clueso 複製一個僅檢視的連結。切勿只用「完成」來結束對話:你的最後一條訊息應包含連結以及一行關於在哪裡找到輸出的說明。

Individual skills in this repo

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

相關技能