Communitygithub.com

示範影片

規劃並製作關於軟體工作的簡短、以證據為優先的影片:單一變更的「完成」影片、衝刺示範、「先前提要」回顧、研究結果、發布、概念影片、逐步解說與錯誤重現。這是一個藍圖:包含簡報、聲明表、分鏡腳本、節奏、品牌與審查,適用於任何 HTML 轉影片的渲染器。

示範影片 是什麼?

「示範影片」是一個專門的 AI 輔助技術技能,旨在幫助開發人員與團隊為軟體開發工作建立簡短、且以證據為基礎的影片。它將影片製作本身置於次要地位,優先強調呈現真實、可驗證的軟體工作成果。此技能提供了一個結構化的藍圖,涵蓋從選擇影片模式(例如「完成」、「衝刺示範」、「研究」)、撰寫簡報(BRIEF.md),到建立聲明表、分鏡腳本,以及確保最終產品在手機上可讀且符合品牌規範的完整流程。它詳細說明了「證據優先於美術」、「始終在螢幕上標示內容」、「結果優先」和「手機可讀性」等不可協商的規則。此技能不包含特定的渲染器或錄製工具,而是與任何決定性幀渲染器(如 HyperFrames、Remotion 或 Motion Canvas)以及瀏覽器自動化工具(如 Playwright)和 FFmpeg 等編碼工具協作。最終的交付物包括無聲版、音樂版、網頁版、海報,以及一份詳盡的審查報告(REVIEW.md),記錄了所有檢查項目與最弱的鏡頭。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jernejk/jkstack/tree/HEAD/blueprints/demo-video

在你喜歡的 AI 中提問

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

說明文件

示範影片 是做什麼的?

此處的影片以證據為優先,其次是電影藝術。每個畫面都展示真實的內容,並標示其為何物,能在手機上清晰閱讀,且時間安排得當,讓結果在細節之前先呈現出來。

這是一個藍圖,並非已安裝的技能。它描述了一種已產出真實影片的方法,但未綑綁任何渲染器、錄製器或檢查器。請使用你現有的工具;擴充功能 說明了值得建置的工具。請相對於此技能資料夾解析參考路徑。

1. 選擇模式,然後撰寫簡報

模式用途長度結構
完成 (done)一個已合併的變更或錯誤修正15–30 秒介紹卡 → 在真實 UI 中的變更 → 結尾卡,附上 issue 或 PR
衝刺示範 (sprint-demo)給利害關係人的衝刺審查2–4 分鐘衝刺目標 → 3–5 個已完成的重點,最有價值的優先 → 未完成 → 下一步
先前提要 (previously-on)進行中專案的一集1–3 分鐘上一個未結案緒論 → 部分:問題 → 結果 → 改變了什麼 → 下一個緒論
研究 (research)一個實驗、spike 或研究之夜1–2.5 分鐘問題 → 一張圖片中的方法 → 結果及其分母 → 驚喜 → 決策
發布 (release)已發布的內容與下一步計畫1–2.5 分鐘回顧結構,包含已合併 → 已發布 → 暫存 → 生產狀態
概念 (concept)一個功能影片、模型或提案45–95 秒結果鉤子 → 一個實際範例 → 證明 → 誠實的限制 → 報酬
逐步解說 (walkthrough)如何執行一個任務30–90 秒完成結果 → 在真實 UI 中的步驟 → 再次顯示完成結果
重現 (repro)一個錯誤報告10–30 秒環境 → 步驟 → 失敗,暫停顯示 → 預期結果(以文字呈現)

各模式的詳細說明:模式。回顧、週年回顧與告別影片是擴充功能中的旅程擴展。

在進行任何錄製之前,請在影片資料夾中撰寫 BRIEF.md:包含模式、目標觀眾、一個核心領悟、觀看寬度(預設:手機,844 像素橫向與 390 像素直向播放器)、品牌設定檔、每個場景的證據類別、截止日期與輸出檔案。僅要求你無法從請求或來源推斷的資訊。

2. 不可協商的規則

  • 證據優先於美術。 展示真實的 UI、真實的已儲存輸出與真實的原始頁面。絕不描繪未曾發生的狀態、捏造數字,或暗示速度、發布或生產環境的使用。螢幕上的每個事實,在其場景建立之前,都必須在聲明表中有一行對應的記錄(證據)。
  • 始終在螢幕上標示內容。 在攝影機範圍外的一個導引列標示證據類別:本機建置、概念示範·範例資料、錄製答案·重播、暫存、生產環境。概念與模型絕不能偽裝成已發布的功能。
  • 結果優先。 核心領悟與一個主要數字或可見結果,須在場景開始後約 1.5 秒內呈現,並持續到剪輯點。場景長度 ≥ 1 秒 + 字數 ÷ 3 + 1.5 秒暫留(節奏)。
  • 可在手機上閱讀。 主要文字 ≥ 80 像素(1080p 解析度下);觀眾必須閱讀的任何文字 ≥ 36 像素。字太多:刪減文字或重新構圖,絕不縮小。
  • 清晰的 UI。 以 2 倍密度擷取證據,並以 ≥ 1.0 的比例顯示或放大檢視。絕不放大一張密集的 1080p 畫面並稱之為特寫。
  • 僅使用已核准的品牌。 個人或公司品牌必須來自品牌設定檔及該品牌已核准的資產(品牌)。絕不重新繪製、重新著色或近似任何標誌。
  • 已授權的音效。 音樂與音效需要經過驗證的授權及其所需的姓名標示。
  • 完成意味著已驗證。 分別報告技術檢查、已檢查的幀、以正常速度播放與聆聽的結果。請求者的接受是其自身的獨立狀態(審查)。

3. 工作循環

  1. 簡報與聲明。 建立 BRIEF.md 與聲明表。對於包含數字的影片,在完整渲染之前,應由一位獨立審查者(理想情況下是不同模型家族或真人)檢查最終螢幕上的文字,包括螢幕截圖內部的文字。
  2. 文字分鏡腳本。 每個場景一行:時間區間、主要台詞、畫面、證據標籤、音效提示、如何交接。挑選影片使用的 3–5 種轉場類型及觸發每種轉場的原因。
  3. 錄製(錄製)。使用腳本化的瀏覽器流程進行互動式畫面錄製;使用偽造的時鐘幀擷取來處理頁面自身的動畫;使用 2 倍元素截圖來處理靜態畫面。
  4. 合成(合成器)。較短的模式適合使用規格驅動的合成器;較長的模式適合在一條暫停的時間軸上手動構圖,並在條狀網格上放置場景。
  5. 在渲染前先檢查。 對每個場景的第一個可讀時刻、中點、最後暫留點以及每個剪輯點的兩側進行快照。修正文字重疊、文字被裁切、空白幀,以及任何陌生人無法閱讀的問題。
  6. 渲染、混音、驗證。 渲染、編碼、混入音樂與音效,執行技術檢查,然後親自閱讀聯絡表、剪輯條與手機版頁面(動態與聲音)。
  7. 交付。 提供無聲版、音樂版與網頁版,以及一張海報、播放器旁附上音樂姓名標示,還有一份 REVIEW.md:記錄了哪些項目經過測量、哪些僅是目視檢查,以及最弱的鏡頭是哪一個。

4. 工具鏈

任何能決定性產生幀的渲染器皆可使用。HyperFrames(Apache-2.0 授權)搭配一個傳送至 FFmpeg 的幀擷取腳本,可直接渲染 HTML 合成畫面。Remotion(React;使用前請先檢查其公司授權條款)與 Motion Canvas(TypeScript 場景)有其各自的場景模型;合成器中的合成合約可轉譯至這些工具。瀏覽器自動化工具(如 Playwright)可驅動錄製。FFmpeg 負責編碼、混音與測量。請固定渲染器版本,並在可能的情況下關閉遙測功能。

5. 授權

製作一部影片授權進行本機錄製、合成與驗證。它不授權進行上傳、發送訊息、張貼 PR 或 issue 評論、進行產品變更或發布。請使用範例資料或已核准的虛構資料;未經核准,絕不顯示客戶、顧客或員工姓名,並且絕不放大顯示任何已登入的身分。

參考資料

需求閱讀資料
模式簡介與故事結構模式
聲明、標籤、狀態狀態、事實查核證據
閱讀時間、文字大小、手機寬度節奏與手機
動態、轉場、音樂與音效動態與聲音
個人與公司品牌設定檔品牌
錄製技巧與陷阱錄製
完成影片規格與合成合約合成器
審查階段與交付建議審查與交付
錄製器、檢查器、從時間軸進行的回顧、旅程影片擴充功能

相關技能