Communitygithub.com

JasonColapietro/suede-creator-skills

Suede 所屬的行銷影片規劃與製作規範。用於選擇格式、撰寫腳本、繪製分鏡、生成影片、剪輯、逆向工程節奏、建立可重複使用的影片管道,或將單一來源素材重新剪輯成多種版本。不適用於:決定社群發布時程(請用 suede-social)、付費廣告概念(請用 suede-ad-creative)、僅影像素材(請用 suede-image)或發布未經核准的媒體。

suede-creator-skills 是什麼?

此技能為 Suede 影片製作,是一個專為 AI 代理(如 Claude Code、Cursor 等)設計的開發者工具,用於處理核准訊息與版權清晰的原始素材,將其轉化為腳本、分鏡圖、生成計畫、剪輯系統及可重複使用的製作流程。它能明確處理肖像權、授權、品牌資產、渲染成本與發布等關鍵環節,並將其作為明確的閘門而非假設。此技能支援多種製作方法,包含程式化影片(使用 HTML/CSS 或 React 渲染器如 Hyperframes 或 Remotion)、AI 影片生成、AI 虛擬主播以及剪輯與再利用工具。它會引導代理先檢查產品行銷背景,收集影片目標、製作方法與技術脈絡,並根據目前可呼叫且經授權的工具來評估最佳方案。此技能的核心價值在於避免常見錯誤,例如直接從工具而非策略開始、在影片中使用 AI 產生難以辨識的文字、未經驗證就大量生產虛擬主播影片,以及忽略無障礙字幕與版權審查。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JasonColapietro/suede-creator-skills/tree/HEAD/skills/suede-video

在你喜歡的 AI 中提問

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

說明文件

Suede 影片製作

Suede Video 將已核准的訊息與版權清晰的原始素材轉化為腳本、分鏡圖、生成計畫、剪輯系統與可重複使用的製作流程。它明確將肖像權、授權、品牌資產、渲染成本及發布視為明確的閘門,而非假設。

開始之前

先檢查產品行銷背景: 如果 .agents/product-marketing.md 存在(或 .claude/product-marketing.md,或在舊有設定中的 product-marketing-context.md 檔案),請先讀取它再提出問題。使用該背景資訊,只詢問未涵蓋或特定於此任務的資訊。

收集此背景資訊(若未提供則詢問):

1. 影片目標

  • 影片類型?(產品展示、解說、見證、社群短片、廣告、教學)
  • 目標平台?(YouTube、TikTok/Reels/Shorts、網站、廣告、銷售簡報)
  • 期望長度?

2. 製作方式

  • 是否需要真人 presenter?(AI 虛擬主播 vs. 旁白 vs. 螢幕錄製)
  • 是否有現成素材或資產?(螢幕截圖、Logo、產品 UI)
  • 是否需要生成的素材?(AI 生成場景、B-roll)
  • 這是單次使用還是可重複使用的範本?

3. 技術脈絡

  • 你的技術棧是什麼?(Node.js、Python 等)
  • 是否有任何影片工具的 API 金鑰?
  • 預算限制?(某些工具按影片分鐘數收費)

選擇你的方法

根據任務、現有證據、版權及目前可呼叫的工具選擇製作方法:

方法適用情況需評估的工具使用時機
程式化範本化、資料驅動、批次影片已安裝的 HTML/CSS 或 React 渲染器格式重複且需要確定性輸出
AI 生成從文字/圖像提示生成原始素材任何目前經授權的生成模型場景無法實拍且輸出版權已驗證
AI 虛擬主播經核准的 presenter 無需實拍任何目前經授權的虛擬主播平台同意、肖像權、語音、在地化及輸出版權皆有文件記錄
剪輯/再利用將長片剪成短片任何已安裝的逐字稿或時間軸編輯器原始媒體及衍生使用權可用

程式化影片

程式化影片適用於可重複、範本化或資料驅動的工作;請根據當前技術棧、剪輯需求、成本及審查負擔驗證其適用性。

HTML/CSS 渲染器候選

Hyperframes 可能適合 HTML/CSS 工作流程。首先檢查它是否已安裝。如果已安裝,請閱讀已安裝版本的說明文件,檢查其授權條款,並確認渲染器與匯出路徑。如果未安裝,請使用不依賴特定渲染器的交接方式,或在展示當前套件來源、版本、鎖定檔影響及成本後,請求明確的安裝授權。未經該授權,不得執行以下指令:

npm install hyperframes

關鍵概念: 每個影格都是一份 HTML 文件。將影格組合成時間軸,渲染為 MP4。

import { render } from "hyperframes";

await render({
  frames: [
    { html: "<h1>歡迎來到 Acme</h1>", duration: 3 },
    { html: "<h2>這是我們構建的成果</h2>", duration: 3 },
    { html: "<p>立即免費試用 →</p>", duration: 2 },
  ],
  output: "intro.mp4",
  width: 1080,
  height: 1920, // 9:16 垂直
});

適用情況: 產品公告、更新日誌、資料驅動報告及經核准的個人化推廣影片。請透過重複渲染測試驗證確定性,而非假設。

React 渲染器候選

Remotion 可能適合基於 React 的工作流程。請驗證已安裝或可呼叫的版本、當前說明文件、授權條款、渲染路徑及託管成本。模板建立指令可能會安裝套件或建立檔案;僅在獲得該變更的明確授權後才能執行,否則請提供不依賴特定渲染器的計畫:

npx create-video@latest

需驗證的關鍵概念: React 元件表達計時的視覺元素,props 驅動內容。確認渲染是在本地執行還是有經授權的託管渲染器。

當儲存庫已使用 React 時,或需要在 HTML/CSS 與 React 路徑之間做出選擇並提供理由時,請閱讀 references/programmatic-renderers.md —— 其中包含 React 元件範例與渲染器選擇表。


AI 影片生成

從文字或圖像提示生成原始素材。用於 B-roll、主視覺場景以及無法實際拍攝的場景。

模型比較

在推薦模型前,先探索目前可呼叫且經授權的模型。閱讀當前官方說明文件,並在實際帳戶上執行有範圍的測試。比較:

標準需擷取的證據
輸出適用性根據當前文件及測試片段確認解析度、時長、音訊、動態與一致性
控制能力實際暴露的參考圖像、攝影機、剪輯、種子及分鏡圖控制
營運狀況排隊時間、失敗率、匯出路徑及可重複性
權利輸入權利、輸出權利、模型限制、同意及來源證明
經濟效益當前方案、每次生成成本、失敗生成處理方式及預算上限

如果沒有可呼叫且經授權的模型,請回傳鏡頭清單、提示集、參考影格說明及手動供應商評估檢查清單。

影片模型的提示技巧

良好的影片提示需指定:主體 + 動作 + 攝影機 + 風格 + 氛圍

一個筆記型電腦鍵盤上雙手打字的特寫鏡頭,
淺景深,溫暖的辦公室燈光,
攝影機緩慢後拉,展現一個現代工作空間,
電影級調色,4K

常見錯誤:

  • 過於模糊(「一個人在工作」)—— 加入具體細節
  • 忽略攝影機運動 —— 指定推軌、搖攝、靜態
  • 忘記風格 ——「電影級」、「紀錄片」、「商業廣告」
  • 在影片中要求文字 —— AI 模型難以生成可讀文字

詳細提示指南:參閱 references/ai-video-prompting.md

AI 生成 vs. 庫存素材評估

使用案例需測試的生成證據需測試的庫存/原始素材證據
特定場景提示控制、連續性、審查負擔搜尋涵蓋範圍、授權、剪輯適用性
風格連續性有範圍測試中的跨片段一致性已授權片段的匹配品質
真實地點事實準確性與揭露風險來源證明與地點釋出文件
產品/品牌UI 與標誌保真度;避免虛構的產品宣稱經核准的真實捕捉或資產
B-roll排隊時間、失敗率、成本搜尋與授權時間

AI 虛擬主播

建立說話的頭部影片,無需實際拍攝。AI 虛擬主播能以逼真的唇形同步、表情和手勢來傳遞你的腳本。

虛擬主播工具評估

HeyGen 是其中一個可能的虛擬主播平台,但並非保證或偏好的整合。在指名它或其他供應商之前,請驗證當前的官方說明文件、已驗證的存取權限、可呼叫的 API 或連接器可用性、方案限制、價格、輸出權利、身體動作與腳本輸入控制、在地化與匯出要求,以及所涉及的每個語音或肖像的同意要求。

如果目前沒有可呼叫且經授權的虛擬主播工具,請提供手動的不依賴特定供應商的工作流程:經核准的腳本、同意記錄、由使用者操作的上傳、匯出檢查清單,以及真實攝影機或旁白替代方案。

可能的適用測試: 產品解說、功能公告、多語言版本及經核准的個人化推廣。

虛擬主播 vs. 其他方法測試

情境需驗證的虛擬主播證據需比較的替代方案
定期內容同意、可重複性、觀眾反饋錄製的 presenter 或旁白
多語言版本翻譯、發音、揭露真人在地化
個人化推廣同意、宣稱審查、成本、回覆品質經核准的文字或錄製範本
創辦人訊息信任與揭露反應直接錄製
產品 UI 導覽真實捕捉周圍的 presenter 價值螢幕錄製
創意/藝術影片控制、原創性、權利原始素材或生成的場景

剪輯與再利用工具

將現有內容轉換成多種影片格式。

將指定的產品視為候選。探索目前安裝或可呼叫的工具,驗證使用者的帳戶與權利,然後將工作流程對應到可用工具。如果沒有任何工具可用,請回傳剪輯決策清單、片段時間碼、字幕及匯出設定供手動執行。

候選功能需驗證的項目候選適用情況
逐字稿編輯器說話者準確性、剪輯控制、匯出、隱私訪談、Podcast、網路研討會
片段助理選擇控制、來源證明、誤報率長片轉短片審查
時間軸編輯器字幕、特效、音訊權利及匯出控制特定平台的後製
無障礙助理字幕準確性、眼神接觸揭露、配音同意經核准的說話頭部內容

再利用工作流程

長片內容(Podcast、網路研討會、展示)
    ↓
逐字稿編輯:清理、移除填充詞、潤飾
    ↓
片段審查:提出具有來源時間碼的精彩時刻
    ↓
時間軸編輯:添加經審查的字幕、特效及平台風格
    ↓
發布:TikTok、Reels、Shorts、LinkedIn

逆向工程病毒式剪輯

要研究參考剪輯的風格,首先探索是否有經授權的媒體檢查器、瀏覽器或本機檔案檢視器可呼叫。如果有,請檢查實際的影格與時間。否則,要求使用者提供媒體檔案、螢幕截圖或含時間碼的匯出檔案,並提供手動影格取樣檢查清單。然後提取可重複使用的節拍表,以及 3-5 個標誌性動作。在執行到任何可用的編輯器之前,先進行審查。複製剪輯語法,絕不複製參考片段的素材、腳本、語音或音樂。完整方法:references/edit-anatomy.md。


影片製作工作流程

產品示範影片

  1. 撰寫關鍵功能與價值主張的腳本(使用 suede-copy 技能)
  2. 螢幕錄製產品流程
  3. 程式化疊加 — 使用可用的授權渲染器處理標題、標註及轉場,或提供手動編輯器說明
  4. AI B-roll — 僅在使用已探索到的經授權生成器且已驗證版權的情況下使用;否則使用有授權的庫存素材或原始素材
  5. 旁白 — 自行錄製或使用 AI 虛擬主播進行旁白
  6. 匯出 符合平台規格

解說影片

  1. 撰寫問題 → 解決方案 → 行動呼籲的腳本架構
  2. 選擇 presenter — 當可用時使用經核准的虛擬主播工作流程,或錄製旁白加視覺元素
  3. 建立視覺元素 — 程式化幻燈片、螢幕錄製、AI 生成場景
  4. 添加字幕 作為預設的無障礙功能,並驗證其準確性
  5. 匯出 僅在檢查當前目標平台需求並預覽已驗證的合成工具後進行;不要假設統一的畫面方向

批次社群短片

  1. 建立主範本 在可用的經授權渲染器或手動編輯器專案中
  2. 輸入資料 — 產品功能、見證、統計資料
  3. 批次渲染 — 單一範本,多種變化
  4. 添加平台特定字幕 使用可用的編輯器
  5. 回傳經核准的匯出候選 給 suede-social 進行頻道策略規劃;排程仍是獨立且明確的動作

工具感知的影片管道

僅在探索到目前可呼叫、已驗證且經授權的工具後才使用自動化。否則,產出與手動交接相同的產出物。

經核准的腳本(來自產品背景)
    ↓
可用的渲染器/虛擬主播/生成器,如果授權
    或手動編輯器加上時間碼說明
    ↓
審查剪輯、版權、字幕及品牌資產
    ↓
輸出:經核准的匯出候選,非自動發布

當沒有可用的製作工具時,請回傳腳本、鏡頭清單、資產清單、節拍表、字幕、剪輯決策清單及匯出設定,以便使用者能手動執行剪輯,使用這些確切的標題:

## 腳本
<場景或節拍> | 鏡前或旁白台詞 | 目標時長

## 鏡頭清單
鏡頭編號 | 來源(螢幕錄製 / 自有素材 / 有授權 / 生成) | 構圖 | 備註

## 資產清單
資產 | 來源 | 權利基礎與持有者 | 到期日或需標註來源 | 檔案路徑

## 節拍表
使用 references/edit-anatomy.md 中的行結構(節拍 | 時間 | 鏡頭 |
螢幕文字 | 字幕樣式 | 轉場/動態 | 音訊)及其樣式摘要。請勿發明第二種節拍表格式。

## 字幕
帶有時間碼的完整字幕文字;說明已執行的準確性檢查。

## 剪輯決策清單
片段編號 | 來源檔案 | 入點 TC | 出點 TC | 位置 | 轉場 | 背景音

## 匯出設定
目標 | 比例 | 解析度 | 幀率 | 編碼 | 最大時長 | 已針對(當前規格來源 + 日期)驗證

## 待解決問題
<缺少的權利、同意、成本核准或品牌資產;使用中止合約>

對於節拍表及其樣式摘要,請在撰寫交接文件前先閱讀 references/edit-anatomy.md —— 它擁有該行結構。


常見錯誤

  1. 從工具開始,而非策略 — 先決定需要什麼樣的影片,再選擇工具
  2. 影片中的 AI 生成文字 — 模型無法可靠地渲染可讀文字;請改用程式化疊加
  3. 未經驗證的虛擬主播品質 — 在付費或大量生產之前,先測試一個簡短的、已取得同意的樣本
  4. 無法存取的可近性剪輯 — 提供準確的字幕,但不要斷言

…

[已截斷,待翻譯]

相關技能