社群媒體行銷影片
引導使用者從構想到完成一支經過檢查的短影音行銷影片，並在他們的剪輯軟體中工作。你負責規劃、撰寫、組織與驗證；剪輯軟體（或使用者）負責實際組裝。一次只專注於一個指定的交付項目或修訂版本，保持專案的可編輯性，並記錄實際檢查過的內容。
工作流程
對於跨越數個步驟的工作（非首次執行的訪談），請在你的回覆中保留此檢查清單，並在進行時逐項勾選：
- [ ] 1. 簡報 – 讀取 STATUS.md，或執行簡報訪談
- [ ] 2. 素材 – 目錄化素材，或撰寫外景拍攝清單
- [ ] 3. 訊息 – 鉤子 → 問題/渴望 → 價值 → 證明 → 行動呼籲；僅使用已核准的主張
- [ ] 4. 規劃 – 針對一個平台/格式的場景規劃 + 拍攝清單
- [ ] 5. 組裝 – 在使用者的剪輯軟體中，或手動規劃 / 無聲預覽
- [ ] 6. 檢查 – 執行匯出檢查；修正並重新檢查直到通過
- [ ] 7. 意見回饋 – 帶有版本與時間碼的修改；保護其他所有內容
- [ ] 8. 交付 – 可編輯的專案 + 已標記的匯出檔 + 更新 STATUS.md
- 簡報。 如果工作目錄有
STATUS.md，請讀取它並從下一個步驟繼續。否則，執行 首次執行簡報訪談 中的訪談：每次最多三個問題，使用使用者的語言，然後儲存BRIEF.md並提供一個具體的下一步。 - 素材。 如果是新專案，建立工作目錄並目錄化素材（使用以下命令）。在選擇之前，請先觀看候選片段的實際動態；目錄或逐字稿不等於觀看。沒有素材 → 根據 垂直構圖的景別尺寸與覆蓋 撰寫拍攝清單。
- 訊息。 遵循 行銷故事與主張。將已提供的事實、已核准的主張、素材顯示的內容以及你自己的提案分開記錄。
- 規劃。 從 社群平台規格、長度與節奏 中選擇格式與長度。如果是 TikTok，也請閱讀 TikTok 鉤子、格式與趨勢 並提供三個替代鉤子。每個規劃都須說明文字的安全區域、為靜音觀看設計的內嵌字幕，以及適用於該帳戶類型的音樂版權（商業帳戶與廣告通常僅限於授權或商用資料庫音樂）。
- 組裝。 使用 剪輯軟體選擇與整合 選擇路線。在任何輔助匯出之前，先將敘事性的
scene.json轉換為技術性的拍攝規劃（拍攝規劃 JSON 格式）。 - 檢查。 對每個新的匯出檔執行 匯出檢查與證據。如果檢查失敗，修正它，匯出新版本並再次檢查。報告未檢查的項目，而非聲稱通過。
- 意見回饋。 使用 意見回饋審查與專案記憶 和 修訂版本保護規則 應用筆記：先儲存一個版本，僅更改要求的範圍，然後比較其餘部分。
- 交付。 提供可編輯的專案、一個標示清晰的審查用匯出檔、剩餘的限制條件以及更新後的
STATUS.md。
應閱讀的參考文件
僅閱讀當前步驟所需的文件。每個檔案都是獨立的。
| 時機 | 閱讀 |
|---|---|
| 首次使用、無參數呼叫、「接下來呢？」 | 首次執行簡報訪談 |
| 建立訊息、檢查主張、價格、推薦 | 行銷故事與主張 |
| 選擇格式、長度、安全區域、節奏、字幕、音量 | 社群平台規格、長度與節奏 |
| TikTok 是目標平台 | TikTok 鉤子、格式與趨勢 |
| 景別尺寸、垂直構圖、拍攝規劃、解釋鏡頭 | 垂直構圖的景別尺寸與覆蓋 |
| 選擇鏡頭 IN/OUT 點、攝影機運動 | 攝影機運動與鏡頭邊界 |
| 規劃或更改任何剪輯點 | 剪輯原則 |
| 字幕、下三分之一、價格/結束卡、封面、模板 (Figma, Photoshop, Canva) | 垂直影片的圖像設計 |
| 選擇音樂、平衡蒙太奇與旁白、物件音效 | 音樂、蒙太奇與旁白平衡 |
| 錄製或清理旁白、音效、混音電平 | 旁白錄製與聲音設計 |
| 使用者選擇了 Epidemic Sound | 音樂資料庫 Epidemic Sound |
| 選擇剪輯軟體或更換服務 | 剪輯軟體選擇與整合 |
| DaVinci Resolve（在操作前） | 剪輯軟體 DaVinci Resolve |
| Resolve AI Audio Assistant 或之後更換音樂 | Resolve Fairlight 混音 |
| Final Cut Pro | 剪輯軟體 Final Cut Pro FCPXML |
| CapCut Web | 剪輯軟體 CapCut Web 外掛 |
| 為輔助腳本撰寫拍攝規劃 | 拍攝規劃 JSON 格式 |
| 任何新的匯出或聲音變更 | 匯出檢查與證據 |
| 修訂時間軸或重建混音 | 修訂版本保護規則 |
| 應用意見回饋、儲存偏好設定、交接 | 意見回饋審查與專案記憶 |
| 安裝、腳本選項、疑難排解 | 設定命令與疑難排解 |
命令
從技能目錄（包含此檔案的資料夾）執行這些命令；使用者檔案請傳遞絕對路徑。腳本僅使用 Python 標準函式庫，且絕不覆蓋現有輸出。
| 目的 | 執行 |
|---|---|
檢查任務工具（plan, catalog, preview, measure, resolve） | python3 scripts/workspace_setup_catalog_and_measure.py doctor --task plan |
| 從模板建立新的工作目錄 | python3 scripts/workspace_setup_catalog_and_measure.py init /path/to/workspace |
| 目錄化素材（雜湊 + ffprobe 元資料） | python3 scripts/workspace_setup_catalog_and_measure.py catalog /path/to/footage --output /path/to/workspace/catalog.json |
| 測量匯出檔（解碼、黑畫面/凍結、響度） | python3 scripts/workspace_setup_catalog_and_measure.py measure /path/to/export.mp4 --output /path/to/workspace/checks.json |
| 從拍攝規劃產生無聲 MP4 預覽 | python3 scripts/render_silent_preview_mp4.py shot-plan-v1.json --media-root /path/to/media --output /path/to/preview-v1.mp4 |
| 從拍攝規劃為 Resolve 產生 FCP 7 XML | python3 scripts/shot_plan_to_fcp7_xml.py shot-plan-v1.json --media-root /path/to/media --output /path/to/v1.xml |
| Resolve：唯獨探測 / 安全匯入 | python3 scripts/davinci_resolve_safe_import.py probe · … import-xml FILE.xml --project 'Exact Empty Project' |
| 驗證安裝 | python3 scripts/verify_skill_installation.py |
結束碼 2 表示「已完成但需留意」（缺少工具、空或部分目錄）：請閱讀輸出，不要將其視為成功。scripts/shot_plan_validation.py 是一個共享模組，並非命令。
環境
- Claude Code / 本地代理程式： 完整工作流程。輔助腳本在本地執行；若已安裝，FFmpeg、Resolve 和 Final Cut 即可運作。在承諾渲染或匯入前，請先以
doctor指令檢查。 - claude.ai： 規劃、腳本、簡報、拍攝清單、文案和檢查清單隨處可用。輔助腳本僅在程式碼執行環境中執行；FFmpeg 可能缺失，網路存取則取決於設定。無法連接原生剪輯軟體（Resolve, Final Cut, CapCut），因此請改為提供手動組裝規劃。
始終適用的規則
- 主張： 價格、付款方案、交屋日期、收益率、可用性、推薦與法律文字僅來自已核准的來源。視覺稿或草稿文案不構成核准，捏造的主張可能為使用者帶來法律責任。
- 短影音提案： 任何針對 TikTok、Reels 或 Shorts 的概念或規劃（包括首次回覆中的暫定提案）都必須說明文字安全區域、為靜音觀看設計的內嵌字幕，以及適用於該帳戶類型的音樂版權。這些是社群影片審查失敗的最常見原因。
- 檢查的誠實性： 精確說明實際測量、觀看、聆聽或由使用者接受的內容。命令執行成功不等於核准。
- 工作安全性： 絕不覆蓋來源檔案、工作目錄或先前的版本；在每次變更前儲存一個新版本。
- 授權： 僅在使用者明確要求特定動作時，才上傳媒體、花費金錢或發佈到帳戶。
- 資料位置： 專案檔案位於使用者的工作目錄中（
BRIEF.md,STATUS.md,scene.json,feedback.json,preferences.json），絕不放在技能資料夾內。