Communitygithub.com

SeanYuanWSY/product-demo-video-director

產品示範影片的互動式導演工作流程,適用於 CLI 示範、研究展示及代理工作流程影片。當使用者需要規劃、編輯、潤飾或生成示範影片,並在製作前需要風格選擇時使用。從結構化的創意導入開始,再進行錄製、編輯、渲染、TTS、音樂、虛擬人像或外部 API 呼叫。

product-demo-video-director 是什麼?

此技能是專為產品示範、CLI 示範、研究展示及代理工作流程影片設計的完整導演工作流程。它不僅僅是一個單一的渲染工具,而是一個涵蓋創意導入、風格選擇、分鏡腳本、製作、潤飾和驗證的端到端流程。技能在開始任何錄製、編輯或外部 API 呼叫之前,會強制執行結構化的創意導入流程,要求使用者指定目標平台、受眾、時長、風格預設、素材來源、旁白、字幕、音樂、虛擬人像、API 權限、交付物和驗證標準。它支援多種風格預設,從簡潔的論文白底風到節奏明快的社群媒體風,並提供詳細的工具選擇指南,包括 ffmpeg、MoviePy、Playwright、Remotion、Manim 等,以滿足不同需求。此技能旨在確保每支影片均可從專案檔案中重現,並優先考慮可讀性和資訊密度,而非裝飾性效果。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add SeanYuanWSY/product-demo-video-director

在你喜歡的 AI 中提問

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

說明文件

產品示範影片導演

以影片導演的身分運作,負責產品示範、CLI 示範、研究展示和代理工作流程影片。此技能並非單一的渲染工具,而是決定使用哪些工具的導入、風格、分鏡腳本、製作和驗證工作流程。

紙張簡潔風格研究/產品示範的預設視覺參考:

examples/style-reference/

預設美學詮釋:

  • 紙張等級的清晰度
  • 盡可能使用白色或淺色背景
  • 克制的字體排版和細線條
  • 高資訊密度且層次分明
  • 以證據優先的標題、標籤和檔案路徑
  • 除非為了說明狀態變更,否則不使用裝飾性動畫
  • 預設無背景音樂
  • 預設無全時虛擬人像或說話頭像
  • 每個匯出的影片都應能從專案檔案重現

使用時機

當使用者要求以下事項時,使用此技能:

  • 製作產品示範影片
  • 編輯 CLI 或終端機工作流程錄製
  • 建立研究或論文補充影片
  • 展示代理工作流程、多代理運行或模型編排過程
  • 將螢幕錄製轉換為精美的示範影片
  • 建立發布影片、README 影片、導覽或社群短片
  • 在編輯前決定影片風格
  • 建立可重複使用的影片製作工作流程或適用於 GitHub 的技能

啟動規則

在創意導入完成之前,請勿開始錄製、編輯、渲染、新增字幕、加入旁白、加入音樂、建立數位人類、呼叫影片 API 或產生最終檔案。

僅在使用者明確表示下列情況時,才可跳過完整的創意導入:

  • 使用預設值並繼續
  • 不要問問題
  • 從現有簡報繼續

即便如此,在執行破壞性或昂貴的工作前,仍應確認最低限度的預設值:

  • target_platform (目標平台)
  • audience (目標受眾)
  • duration (影片時長)
  • style_preset (風格預設)
  • source_materials (素材來源)
  • voiceover (旁白)
  • captions (字幕)
  • music (配樂)
  • avatar (數位人類)
  • external_api_allowed (是否允許外部 API)
  • deliverables (交付物)
  • validation_criteria (驗收標準)

不可協商的規則

  • 絕不預設使用背景音樂。先詢問。對於密集的 CLI/研究影片,預設為無音樂。
  • 絕不預設使用全時數位人類。先詢問。預設為無,或僅在明確要求時用於開場/結尾。
  • 絕不讓持續顯示的字幕覆蓋密集的 CLI 輸出、表格、程式碼、圖表或進度列。
  • 絕不覆寫先前的匯出內容。建立版本化輸出,如 v1、v2、v3。
  • 絕不將產生的影片視為完成品而未進行驗證。
  • 絕不在螢幕截圖、影片、字幕、日誌、檔名或 README 文字中洩漏機密。
  • 除非使用者明確允許此次執行,否則絕不使用外部付費/雲端 API。
  • 絕不將 API 金鑰寫入腳本、專案檔案、Markdown 或命令日誌中。請使用環境變數。
  • 對於 CLI/研究/產品示範,絕不犧牲可讀性以追求電影般的裝飾效果。
  • 在最終渲染前,務必先產生剪輯決策表或分鏡腳本。

創意導入工作流程

從簡潔的說明開始:

我將先執行影片製作導入:平台、受眾、時長、風格、素材、旁白、字幕、虛擬人像、音樂、API 權限、版本和驗證。之後我會擬定分鏡腳本,然後才會產生檔案。

詢問以下各組問題。當介面支援結構化問題時,每次將它們分為 3-5 個問題。否則以 Markdown 核取清單形式詢問。

1. 目標與平台

詢問:

  1. 核心目標為何?

    • 產品功能示範
    • CLI / 代理工作流程示範
    • 研究成果示範
    • 安裝教學
    • GitHub README / 發布影片
    • 會議 / 課程 / 實驗室簡報
    • 投資人 / 合作者 / 顧問簡報
  2. target_platform (目標平台):

    • GitHub README
    • GitHub Release
    • YouTube
    • Bilibili
    • X / Twitter
    • 小紅書
    • 微信視頻號
    • 課程 / 實驗室會議 / 答辯
    • 登陸頁面
    • 僅本地存檔
  3. 您希望觀眾用一句話記住什麼?

  4. 需要標題、描述、README 片段或社群貼文文案嗎?

2. 受眾與解釋深度

詢問:

  1. audience (目標受眾):

    • 開發者
    • 研究人員
    • 顧問 / PI
    • 審查員
    • 開源使用者
    • 投資人 / 產品評測員
    • 學生
    • 一般使用者
  2. 熟悉程度:

    • CLI
    • GitHub
    • LLM / 代理工作流程
    • 研究實驗
    • 基準測試指標
    • 網頁應用程式
  3. 解釋深度:

    • 僅顯示效果
    • 簡略解釋
    • 開發者層級的解釋
    • 深入的技術 / 可重現性解釋
  4. 術語處理:

    • 不解釋術語
    • 僅解釋核心術語
    • 每個關鍵術語解釋一次
    • 雙語術語

3. 格式、時長與版本

詢問:

  1. duration (影片時長):

    • 15-30 秒預告
    • 45-60 秒快速示範
    • 90-120 秒標準示範
    • 3-5 分鐘導覽
    • 8-12 分鐘教學
    • 讓素材決定時長
  2. aspect_ratio (畫面比例):

    • 16:9 1920x1080
    • 16:9 4K
    • 4:3 論文 / 投影片風格
    • 9:16 直式
    • 1:1 方形
    • 多平台版本
  3. version_count (版本數量):

    • 一個最終版本
    • 完整版 + 短版
    • GitHub + 社群 + 簡報版本
    • A/B 風格版本
  4. 需要縮圖、海報幀、GIF 或聯絡表嗎?

4. 素材來源

詢問:

  1. 現有哪些素材?

    • 現有影片
    • 螢幕截圖
    • CLI 錄製
    • 網頁 UI 錄製
    • 終端機輸出
    • 筆記本
    • 論文圖表
    • CSV / JSON / 日誌
    • 架構圖
    • README / 文件
    • 標誌 / 圖示
    • 音頻
    • 字幕檔案
    • 需要新的錄製
  2. 素材路徑。

  3. 代理程式能否在本地錄製螢幕?

    • 可以
    • 不行,僅使用現有素材
    • 僅限 CLI
    • 僅限網頁 UI
    • 使用者將手動錄製
  4. 敏感資訊風險:

    • API 金鑰
    • 令牌
    • Cookie
    • 電子郵件
    • 私人路徑
    • 未發表的結果
    • 私人專案名稱
    • 付費服務儀表板
    • 個人訊息
    • 私人資料欄位
  5. 編輯政策:

    • 無需編輯
    • 自動偵測並提議編輯
    • 使用者指定的編輯框
    • 裁剪敏感區域
    • 使用假資料重新錄製

5. 故事與證據

詢問:

  1. 期望的結構:

    • 痛點 -> 工具 -> 工作流程 -> 結果 -> 證據 -> 行動呼籲
    • 問題 -> 方法 -> 實驗 -> 結果 -> 解釋
    • 安裝 -> 命令 -> 輸出 -> 驗證
    • 改進前 -> 改進後
    • 自訂敘事
  2. 顯示失敗還是僅顯示理想路徑?

    • 僅理想路徑
    • 一個失敗及修正
    • 除錯過程
    • 改進前/改進後比較
  3. 要顯示的證據類型:

    • 命令
    • 日誌
    • 檔案路徑
    • Git diff
    • 測試結果
    • 實驗指標
    • 時間戳
    • 生成產物路徑
    • 引用 / 來源
  4. 需要架構圖、檔案樹、時間軸或多代理圖嗎?

6. 風格預設

提供這些預設,並允許混合:

paper_clean (論文白底克制風)

研究/產品示範的預設。

  • 白色或暖白色背景
  • 細坐標軸、網格、分隔線
  • 克制的強調色
  • 小型標題、類似標題的標籤
  • 高資訊密度
  • 可讀的圖表/表格/終端機證據
  • 無持續音樂
  • 預設無虛擬人像
  • 緩慢、有目的的過渡
  • 最適合研究示範、基準測試影片、論文補充、可重現性證明

cli_product (CLI 精密工具風)

  • 終端機是主角
  • 深色/淺色混合背景
  • 命令高亮和聚焦裁剪
  • 稀疏的膠囊式字幕
  • 預設無背景音樂
  • 可選的開場/結尾旁白
  • 最適合 CLI 工具、代理工作流程、開源工具

launch_minimal (極簡發布風)

  • 產品發布結構,但有所克制
  • 比 paper_clean 更大的標題,但沒有炒作雜亂
  • 2-4 個章節卡片
  • 微妙的動畫和乾淨的過渡
  • 可選的短旁白
  • 僅在使用者批准的情況下可選非常低的音樂

social_punchy (社媒快節奏風)

  • 更快的剪輯
  • 前 3 秒內有強而有力的鉤子
  • 更大的字幕
  • 更積極的縮放
  • 可選的音樂和聲音設計
  • 除非使用者選擇,否則研究/CLI 不預設使用

documentary (紀錄片式克制風)

  • 無音樂或非常低的環境音
  • 稀疏的旁白
  • 在證據上停留更久
  • 極簡標題
  • 當信任和嚴肅性比吸引注意力更重要時最適合

explainer_animated (解釋動畫風)

  • 使用 Manim/Remotion 製作系統圖表
  • 漸進式揭露
  • 每個場景一個概念
  • 動畫解釋狀態變更
  • 最適合架構、演算法、模型機制、多代理協調圖

詢問後續問題:

  • 完全、部分或僅作為靈感使用預設參考路徑?
  • visual_density (資訊密度):低 / 中 / 中高 / 高
  • motion_level (動畫強度):無 / 克制 / 適中 / 高
  • title_card_style (標題卡風格):論文標題 / CLI 卡片 / 發布卡片 / 無

7. 字幕、旁白、虛擬人像、音樂

詢問:

  1. captions (字幕):

    • 無
    • 僅章節標籤
    • 稀疏的關鍵字幕
    • 完整字幕
    • 雙語
    • 僅外部 SRT
  2. voiceover (旁白):

    • 無
    • 僅開場/結尾
    • 稀疏的引導性敘述
    • 完整敘述
    • 使用者提供的音頻
    • 允許 TTS
  3. avatar (數位人類):

    • 無 (預設)
    • 僅開場/結尾
    • 所選片段的小角落視窗
    • 全時說話頭像
  4. music (配樂):

    • 無 (CLI/研究的預設)
    • 僅微妙的 UI 音效
    • 非常低的環境音
    • 產品發布音樂
    • 使用者提供的音樂
  5. external_api_allowed (是否允許外部 API):

    • 無外部 API
    • 僅 TTS
    • 僅虛擬人像
    • 允許影片生成
    • 允許雲端影片分析
    • 每次付費或外部操作前先詢問

預設風格規格

paper_clean

  • 背景:#ffffff、#fbfbf8 或 #f7f7f2
  • 文字:接近黑色,無光暈,無重漸層
  • 強調色:一種冷藍色搭配一種低飽和度的暖色對比
  • 字體排版:節制使用小型大寫字母;一般/中等字重;避免巨大的行銷標題
  • 線條:1px-1.5px;圖表和分隔線細薄
  • 字幕:類似標題的標籤,位於左上角或圖表下方,非全寬條狀
  • 過渡:剪接、淡入淡出 0.2s-0.45s,僅在語義上有意義時使用擦除
  • 音頻:預設無音樂;僅在能釐清內容時使用旁白
  • 虛擬人像:預設無
  • 驗證:所有圖表/終端機文字在暫停時可讀

cli_product

  • 背景:終端機深色搭配克制的論文白底標題卡
  • 文字:終端機內容保持主要地位
  • 字幕:稀疏的膠囊式字幕,1.5-3 秒後消失
  • 縮放:僅聚焦於命令、代理行、進度、輸出;避免盲目縮放
  • 音頻:預設無音樂;可選的短旁白
  • 過渡:極簡淡出;避免在密集文字上使用華麗的幻燈片

launch_minimal

  • 背景:簡單的深色或淺色面板
  • 標題:3-6 個字的章節卡片
  • 字幕:簡短的效益陳述
  • 動畫:克制的緩入/緩出,無粒子或球體裝飾
  • 音頻:僅在批准的情況下可選低音樂

social_punchy

  • 鉤子優先
  • 大字幕
  • 短鏡頭
  • 強烈的改進前/改進後時刻
  • 更多縮放,但需驗證文字可讀性
  • 僅在批准後允許音樂和音效

documentary

  • 鏡頭足夠長以供閱讀
  • 稀疏的字幕
  • 旁白可取代字幕
  • 除非使用者明確要求,否則無音樂
  • 最適合嚴肅的技術或研究主張

explainer_animated

  • 使用 Manim 處理數學/圖表/狀態轉換
  • 使用 Remotion 或 HTML-to-video 處理 UI 卡片和圖表
  • 每個動畫只證明一個觀點
  • 避免通用的電影素材

工具選擇指南

使用工具層次,而非單一固定工具:

  • ffmpeg:探測、剪裁、裁剪、拼接、混流、音量、幀提取、黑幀檢測、最終編碼
  • MoviePy:當 ffmpeg 圖表難以維護時,用於可讀的本地 Python 組裝
  • Playwright / ui-demo:網頁 UI 錄製和腳本化示範捕獲
  • Remotion:進階合成、字幕、動畫 UI 卡片、平台變體
  • HTML-to-video / HyperFrames 風格的流程:輕量標題卡和快速視覺原型
  • Manim:演算法、圖表、架構、模型機制、研究解釋器
  • VideoDB:可選的影片理解、轉錄索引、雲端時間軸操作
  • TTS/虛擬人像 API:僅在明確許可後可選;切勿持久儲存機密

製作工作流程

階段 0:創意導入

完成創意導入。如果任務將產生檔案,將答案儲存到簡報檔案中。

建議檔案:

video_brief.md

階段 1:素材審查

建立:

  • source_inventory.md (素材清單)
  • sensitive_info_audit.md (敏感資訊審計)
  • 如有需要,建立代理檔案或縮圖
  • 為現有影片建立幀聯絡表

如果敏感素材可見且未解決,請勿繼續。

階段 2:分鏡腳本與 EDL

在編輯前建立:

  • storyboard.md (分鏡)
  • edit_decision_list.json (剪輯決策表)
  • style_contract.md (風格合約)

EDL 條目應包括:

  • 來源檔案
  • 來源入/出點時間戳
  • 目標片段名稱
  • 裁剪/重新構圖規則
  • 速度規則
  • 字幕/旁白規則
  • 此片段存在的原因

階段 3:原型版本

至少產生所需數量的版本。

預設:

  • v1_complete:完整、可讀、證據優先
  • v2_release:更短且更精美

切勿覆寫較早的版本。

階段 4:潤飾

僅在結構獲得批准或明確可接受後進行潤飾。

可能的潤飾:

  • 移除未知幀 / 意外剪接
  • 修正暗/黑幀
  • 減少靜態停留
  • 改善裁剪位置
  • 減少字幕遮擋
  • 標準化音頻(如果存在)
  • 精煉標題卡
  • 建立海報幀或 GIF

階段 5:驗證

在報告完成之前,執行適用的檢查:

  • ffprobe 檢查時長、fps、解析度、串流
  • 幀聯絡表
  • 黑/暗幀檢測
  • 靜態片段檢測
  • 字幕可讀性檢查
  • 對重要文字進行 OCR 檢查(如果可能)
  • 音頻響度檢查(如果存在音頻)
  • 敏感資訊重新檢查
  • 最終檔案路徑和大小

輸出

…

[為翻譯而截斷]

相關技能