Communitygithub.com

idilsaglam/應用預覽影片

將提供的行動應用錄影轉換為可編輯的 Remotion 發佈影片或經過技術檢查的 App Store 預覽草稿。用於素材檢查、分鏡腳本、字幕剪輯、本地渲染與匯出檢驗;不適用於虛構應用畫面或提交商店素材。

應用預覽影片 是什麼?

此技能提供一個結構化的工作流程,用於從真實的行動應用錄影創作專業的 Remotion 發佈影片和 App Store 預覽。它針對需要將其應用素材轉換為可編輯、可渲染的影片檔案的開發人員和產品團隊,這些檔案符合 Apple 的指南。該技能會引導使用者完成素材攝入、品牌資產探索(包括真實標誌和設計權杖)、場景規劃、透過 Remotion 的影片渲染,以及全面的審查與技術報告。它嚴格遵循「無幻覺」原則,禁止虛構應用畫面或功能,確保所有輸出的素材均基於已提供的真實錄影與設計資產。支援「發佈」和「App Store」兩種模式,每種模式都有獨特的版面、字幕和揭露要求,並保留完整的來源出處以供審計。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/idilsaglam/app-preview-video/tree/HEAD

在你喜歡的 AI 中提問

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

說明文件

應用預覽影片 是做什麼的?

此資料夾既是可安裝的技能,也是可執行的 Remotion 範本。請閱讀 README.md 以了解經過測試的設定與指令。建立規劃時,請閱讀場景規劃介面;使用 App Store 模式時,請閱讀 Apple 需求。如需進行全新的錄製,請使用錄製指南。

攝入與證據

接受錄影資料夾、模式(launch 或 app-store)、應用名稱、品牌資產、語言與創意簡報。預設為英文、直向、發佈模式 30 秒或 App Store 模式 25 秒。預設遵循應用本身的設計;請勿默默套用虛構範例的顏色、字型或視覺風格。絕不虛構當前的應用功能。

執行 npm run doctor,然後使用 npm run inspect -- --recordings DIR --out NEW_DIR 檢查素材。閱讀檢查 JSON 與參考畫格,並審查完整片段以確認動作、敏感資料、測試 UI、載入中狀態及真實順序。僅憑靜態圖片無法完成內容驗證。如果無法完整播放,請記錄此限制,並保留手動審查以待後續。

收集錄製版本、裝置、日期與模擬條件。將真實的應用資產保留在公開套件之外。當請求的時刻缺失時,要求提供缺少的素材。請勿以產生的 UI 取代,反向時間軸以暗示不同的結果,或將模擬器素材標示為實體裝置錄製。

渲染前的品牌探索

首先檢查提供的資產以及相關的應用專案、截圖或錄製,以取得真實的標誌/應用圖示、顏色、字體排印、表面、邊角形狀與動態風格。使用已提供或可驗證存在的資產;請勿要求使用者重新上傳。如果有多個標誌版本看起來合理,請詢問哪一個是目前使用的。如果沒有可用的標誌,請詢問其檔案/路徑並在渲染前等待;同時繼續進行素材檢查。使用者可以明確選擇僅文字/無標誌的處理方式。絕不虛構或默默省略標誌。

在可用時使用應用的設計權杖,並將其與目前的素材進行視覺比對。如果字型在本機上不可用,請說明替代方案,而非聲稱完全匹配。在私人場景規劃或隨附報告中記錄設計來源與決策。將真實標誌放入規劃的 logo 欄位;使用場景規劃參考來設定顏色與可選的 design 權杖。將真實的品牌資產保留在此可發佈的儲存庫之外。

在完整渲染前,顯示具代表性的開場畫格預覽與字幕風格。邀請修正;如果使用者已指定設計並要求您渲染,請勿引入額外的批准關卡。當適合應用時,使用節制的 design.layout: "app" 發佈處理方式,或根據所提供的設計調整構圖。請勿用泛用的深色畫格、全大寫字標或裝飾形狀來取代應用識別。

錄製來源屬於 provenance 與 capture 欄位,且始終保留在報告中。對於發佈影片,除非要求或為避免誤導性聲明而必須加入螢幕揭露,否則預設將 disclosure 留空。請勿自動將模擬器/裝置/位置中繼資料嵌入行銷影片中。這並不表示移除有意義的登入/付費存取揭露、虛構示範標籤或 App Store 的錄製要求。絕不將模擬位置呈現為實際完成的步行,或將模擬器素材標示為裝置素材。

編輯與渲染

建立一個場景規劃,包含實際的來源修剪點、簡潔易讀的字幕,以及每個場景的證據描述。使用一個連貫的旅程,並在開頭幾秒內包含有用的動作。保持可讀性與輸入比例。使用 examples/launch.json 或 examples/app-store.json 作為結構起點,取代所有虛構的聲明與來源參考。

發佈模式允許使用一個畫格、標題、行動呼籲按鈕與品牌背景。App Store 模式則顯示帶有節制字幕和存取揭露的應用;不得有假裝置互動或偽造的 UI。捆綁的示範內容明確為虛構,絕非 Apple 提交素材。此 v1 版本要求在將真實應用編輯視為以提交為導向之前,提供裝置來源證明;僅技術檢查絕不能確立內容合規性或接受度。

執行 npm run render -- --recordings DIR --plan PLAN.json --out NEW_DIR。輸出資料夾必須是新的以保留證據。該工具會正規化修剪後的媒體,透過 Remotion 渲染,編碼為 MP4,建立預覽圖,並寫入來源出處、雜湊值、時間碼與技術檢查。來源檔案保持不變。音樂為選用、使用者提供、已授權,且長度至少與剪輯相同。來源音訊預設為靜音。

審查與交付

在手機尺寸下,以有音訊和靜音的狀態審查整個完成的 MP4。檢查所有剪輯、揭露、字幕、聲稱的動作與音訊。如果發現問題,請修改場景規劃並渲染到另一個資料夾;保留第一次渲染的結果,並描述真實的修正。

分別報告:技術驗證、手動播放/內容審查、來源出處及 Apple 接受度。絕不基於少許截圖將 pending 狀態改為 passed。提供 MP4、預覽圖、可編輯的專案/場景規劃、報告及剩餘限制。不暗示上傳、提交、雲端渲染、付費資產或發佈。

相關技能