Viral Flow → 兩套經核准的 CapCut 剪輯
主機相容性
在 Codex、Claude Code 或支援自訂技能的 Claude 中使用此技能。將捆綁的參考/腳本相對於此技能資料夾解析。agents/openai.yaml 是選用的 Codex 元資料；Claude 不需要它。使用主機實際的工具，而非假設存在 Codex 工具名稱。
在開始執行前，先檢查對來源檔案、本機 Whisper 以及使用者 CapCut 的存取權限。雲端 shell 並非使用者的 Mac：請勿將雲端檔案存取或程式執行視為本機 CapCut 控制。如果只有轉錄稿可用，則從中準備暫定的流程，將來源時間/音訊標示為未驗證，並在承諾可產出剪輯結果之前，要求提供遺失的媒體或本機工具存取權限。切勿將本機素材靜默地傳送到雲端進行轉錄，或聲稱 Whisper 已執行但實際上並未執行。在 Claude 網頁聊天中，提供的轉錄稿可支援文字審查；而 CapCut 剪輯則需要一個連接到使用者電腦且具備所需權限的主機。
產出結果與持久性預設值
交付兩個基於使用者素材的、獨特且連貫的影片流程，而非兩個憑空編造的腳本。預設使用使用者的語言（粵語搭配繁體中文）。
此工作流程具有其創作者要求的實際核准界限： 分析 → 交付兩個完整的文字流程 → 獲得核准 → 在 CapCut 中剪輯 → 匯出兩部影片。
在核准之前，僅執行讀取、轉錄、檢視素材和準備提案。請勿建立剪輯專案、剪輯時間軸、渲染提案剪輯或匯出粗剪。使用者要求「兩個版本」並不代表放棄此界限。使用者後續明確的指示可以改變它。僅核准一個掛鉤不等於核准完整的修訂流程。保留已核准的部分，修訂被要求的部分，並在要求時重新呈現兩個完整流程。在兩個當前流程獲得明確核准後，直接完成剪輯/匯出，無需再次詢問。如果僅核准一個流程，則僅剪輯該版本。
預設產出結果為純流程剪輯：原始語音與畫面；不新增文字、字幕、標題、圖形、B-roll、音樂、新旁白、AI 語音或新效果。來源素材中既有的元素將被保留。僅在使用者要求時才更改這些預設值。書面審查文件並非影片上字幕。
對於此 IP，每個版本均以以下內容開頭：
- 來自來源的一個強而有力的完整口語掛鉤。
- 原始口語的 「Soft voice, wild truth」。
- 在該影片錄製中緊接於其後的特定英文句子。
- 故事主體、理解上的轉變、具體的當前意涵及結尾餘韻。
請勿將比較影片的英文句子重複用於不相關的主題。請勿合成遺漏的品牌詞句。如果品牌詞句缺失或不明確，請完成主體部分的草稿，標示出確切的缺口，並在完成依賴該剪輯的部分之前，要求使用者提供原始片段或明確的例外處理。
1. 建立參考與來源角色
在提出流程之前，請先閱讀 references/viral-format.md。該檔案保留了標竿影片的說故事機制以及創作者回饋中的經驗教訓。參考影片與要剪輯的新影片是不同的輸入。當使用者更正其角色時，請立即更新記錄；請勿從錯誤的檔案推斷表現。
如果提供了新的標竿影片，請檢查其完整內容，對應出近似的節拍，並在工作資料夾中儲存一份簡潔的 reference-profile.md：來源身份、時長、掛鉤、好奇心/解答序列、衝突、情緒轉折、收尾、分享對象、視覺角色以及證據限制。使用者報告的高分享率/低跳出率並非獨立驗證的因果關係。切勿承諾病毒式傳播。將源自來源的事實與假設分開保存。
2. 在寫作前先進行轉錄與檢視
使用可用的本機 shell/檔案工具及本機 Whisper。輔助腳本 scripts/prepare_media.py 可提取單聲道音訊、在整個片段中取樣視覺畫格，並可選擇性地執行 Whisper。請閱讀其 --help；支援包含空白的檔案名稱。在重新執行之前，請先檢查是否有現存可信的轉錄稿。
- 從快取的 base 或 small 模型開始；當粵語的 base 輸出破壞了重要措辭時，優先使用 small 模型。保留時間戳記與原始 ASR 輸出。
- 檢視整個影片。取樣畫格加上轉錄並不等同於連續觀看/聆聽；請準確描述驗證方式。
- 根據來源音訊或內嵌字幕，校正否定句、疑問句、人名、數字以及英文品牌詞彙。請勿將 ASR 視為最終的轉錄稿。
- 找出品牌詞句加上英文句子的確切範圍，並將其作為一個連續的單元保留下來。
- 識別真實事件、涉及的人物、預期結果、實際發生情況、情緒代價、改變的詮釋、當前的行動以及結尾語句。
- 將來源檔案名稱、轉錄稿、畫格記錄及匯出檔案保留在本機；技能的安裝/發布並不授權發布使用者的媒體。
3. 呈現兩個完整的審查流程
閱讀 references/review-format.md。產出版本 A 和 B，兩者具有不同的觀眾切入點或敘事順序。確保兩者與相同的來源事實保持一致。
一個掛鉤必須傳達完整的張力，而不只是一個標語或未經說明的現象。例如，「比較目標升級了」是不完整的；「我取得了進步，發現有人領先更多，並認定自己還是不夠好」則為聽眾提供了一個完整的矛盾。
保留因果鏈。不要僅僅因為標竿影片是 55 秒，就將一個 112 秒的來源素材剪成 40 秒。被接受的案例需要大約 90–100 秒才能保留其背景、成就、逆轉、當前的品牌選擇以及結尾反思。這些長度是範例，而非配額。
每次審查內容包括：
- 版本標題、切入點以及根據選定來源範圍估計的片長。
- 完整的提議口語流程，按順序列出，包含掛鉤、固定的品牌/英文台詞、背景、具體事件、衝突、轉折、當前意涵與結尾（視情況而定）。
- 標示已為閱讀而進行輕微標準化的文字；請勿暗示不存在的詞語已被錄製。保留內部的來源時間對應。任何必要的新台詞必須明確標示「需要錄製」，且不得被靜默地插入。
- 簡短說明兩個版本之間有意義的差異。
請勿僅提交標題、大綱或孤立的掛鉤作為兩個流程。除非需要簡短、刻意的回顧，否則應將被移動的掛鉤從其原始主體位置移除。在重新排序後，請檢查代名詞、「後來」、「但是」以及因果關係是否仍然合理。
將 flow-review.md 與提議的來源範圍儲存在本機。在此處停止編輯工作，直到使用者核准當前的流程。 明確說明這是遵循使用者要求的先審查再剪片流程；如果技能本身是後續權限問題的基礎，請連結到此確切檔案並引用核准界限的句子。
4. 核准 → 可執行的剪輯計畫
將使用者的核准訊息、其所涵蓋的版本/修訂內容以及核准的流程記錄在 approval.md 中。來源的變更或內容上有實質不同的口語內容，需要重新檢查核准是否仍然涵蓋這些變更。保留核准內容的技術邊界調整則不需要重複核准。
建立 edit-plan.json，包含來源路徑、FPS、時長、品牌範圍、兩個命名版本及其有序的片段（start_frame、end_frame、role）。允許的角色包括 hook、brand、body、payoff。要求掛鉤排在首位，完整的連續品牌範圍排在第二位。使用半開區間：起始包含，結束不包含。
執行 scripts/validate_plan.py 來檢查範圍並計算時長。此腳本驗證的是幾何結構，而非真實性、語言或核准與否。保持來源音訊與影片鎖定在一起，在對齊影格的自然語音邊界上進行剪輯，必要時保留呼吸聲，並避免剪到音節。請勿為了符合片長估計值而加速語音或改變已核准的意義。
5. 使用 CapCut 進行剪輯與匯出
在核准後，閱讀 references/capcut-workflow.md。
- 探索實際可用的功能。CapCut 和 ChatCut 是不同的產品；請勿靜默地替代使用。
- 如果有的話，優先使用真正的 CapCut 連接器，否則使用使用者本機 CapCut 安裝上所支援的電腦使用工具。
- 技能提供的是指示；它不會安裝 CapCut、授予電腦控制權，或讓不存在的工具憑空出現。
- 為版本 A 和 B 維護各自獨立的可編輯專案，並保留原始媒體。切勿編輯不相關的既有專案。
- 本機檢視原生草稿的路徑是選用且依賴於版本的。僅在參考文件中的防護措施下使用它；請勿假設舊的路徑、ID、結構或 UI 座標仍然有效。
- 透過 CapCut 匯出。在實際可行的情況下，交付具有原始寬高比與影格率的 H.264 MP4。請勿暗示放大解析度能創造細節。如果 CapCut 產生的是 H.264 MOV，請在無損的情況下重新封裝為 MP4（不重新編碼）；僅在相關時揭露此資訊。
如果功能/驗證阻礙了 CapCut 剪輯，請保留已核准的審查內容與來源時間計畫，描述具體的阻礙因素與確切的下一步行動。切勿將計畫稱為完成的影片，或在使用 FFmpeg-only 進行剪輯時冒充 CapCut 輸出。
6. 驗證與交付
檢查兩個匯出的檔案確實存在、能完整解碼、包含音訊與影片、符合計畫的時長與寬高比，並且包含已核准的掛鉤 → 品牌 → 英文順序。檢查開頭、每個新接合點與結尾；在可行時聆聽是否有被剪掉的音節、爆音、重複詞語及不自然的轉場。在純流程專案中驗證沒有新增的文字軌/效果。檢查最終匯出檔案，而不僅僅是時間軸。
將音訊與預期的來源範圍進行比較，可以佐證剪輯順序。AAC 相位/延遲差異可能會降低原始波形相關性；振幅包絡的時間點是更好的額外檢查方式。無論是單一指標還是幾個取樣畫格，都無法證明整個剪輯已被觀看或聆聽。
提供兩部完成影片的可點擊本機連結、時長，以及簡潔的版本標籤。註明可編輯的 CapCut 專案儲存位置。誠實報告素材驗證的限制。請勿自動將影片發佈到社群媒體。