Communitygithub.com

mishanaer/showtime

透過實際應用程式互動,創造、修改或審查短產品影片。適用於應用程式演示、腳本製作或現有的 showtime 影片。支援 iOS 模擬器畫面擷取與本地端合成。

showtime 是什麼?

此技能讓開發者或產品經理能直接在真實應用程式上操作,自動產生高品質的短產品展示影片 (MP4 格式,1920×1920,60fps)。它整合了 iOS 模擬器畫面擷取與自動化腳本,能根據使用者的情境 (腳本) 與選擇的版面 (頂部裁切、底部裁切或全手機),生成包含流暢過場與輸入動畫的影片,並自動套用 iPhone 樣機與背景。工作流程包含取得使用者批准的腳本與版面、內部準備與審查(含視覺驗證)、擷取、匯出及最終交付。最終輸出包含完整的技術檢查記錄與視覺驗證結果,確保影片品質。此技能可獨立用於新影片製作,也能接續現有工作階段(例如修改腳本或重複利用已通過的素材),並適用於 Telegram 產品等應用程式的示範。其強項在於避免手動重複操作、提供一致的技術規範與自動化品質管控,並支援多種模擬器與使用者偏好設定。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mishanaer/showtime/tree/HEAD

在你喜歡的 AI 中提問

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

說明文件

showtime 是做什麼的?

透過真實的應用程式互動,展示一項產品優勢。可接續現有工作的相關階段;若既有素材能支援要求的變更,則重複使用這些素材。

開始製作新影片

  1. 詢問使用者他們的腳本,並等待取得該腳本。使用他們提供的腳本。
  2. 一旦取得腳本,詢問他們想要的版面:頂部裁切 (crop-top)、底部裁切 (crop-bottom),或全手機 (full)。在準備供審查的故事板之前,請等待他們做出選擇。
  3. 取得對腳本、構圖與時間安排的核准。然後準備並內部審查實際的場景、錄製、匯出,並在發送完成的影片之前,完成視覺驗證。沒有獨立的使用者預覽或故事板核准階段。

每次只問一個問題,並使用對話進行的語言。將使用者已提供的資訊視為已回答。

預設值與範圍

  • 以模擬器的原生影格率進行錄製。以正常速度觀看滾動和轉場。如果捕捉到的動作明顯不流暢,請重新拍攝。

  • 提供一段 10–20 秒、1920×1920、固定 60 fps 的 MP4 影片,包含可讀的結果和一個循環播放。不要加入編輯用的標題或說明文字;應用程式的文字保持可見。若要求不同的格式,則需檢查後端支援。

  • 除非明確要求使用其他語言,否則以英文撰寫使用者腳本的審查文案、已儲存的腳本及螢幕上顯示的內容。在兩個資訊清單中相應地設定 content.language。腳本之外的說明則遵循使用者的對話語言。

  • 腳本核准即授權在該故事範圍內進行製作。已準備好的素材仍需經過內部審查並附上證據,無需再次請使用者決定。直接的修正請求即授權該範圍;在交付修改後的完成影片之前,重新執行受影響的檢查。切勿將未經檢視的素材標記為「使用者已審查」。

  • 發送給使用者的第一部影片,其要求必須與之後每次交付的影片相同:完整的內容、手指點擊指示器、時間安排、版面,以及全面的技術與視覺檢查。請將技術排練保留在內部。在發送前修正未通過的檢查;如果無法完成某項必要的檢查,請回報阻礙因素,而非提供未經檢查的預覽來尋求核准。重複使用已通過的拍攝或匯出,不要僅為了將其重新命名為「final」而再次執行。

  • 保留完整的原生轉場、滾動和閱讀時間。為了符合影片長度,可縮短閒置等待時間或簡化故事。

  • 新影片使用已核准的 iPhone 17 或 18 系列樣機以及隨附的背景調色盤。自動選擇可用的相符模擬器型號、手機顏色和背景;使用者偏好設定可覆寫這些選擇。在故事板中顯示這個組合。請參閱準備工作以了解素材和拍攝畫面的比對。

  • 套用使用者選擇的版面。使用 crop-top 呈現靠近頂部的動作,使用 crop-bottom 呈現靠近輸入區域、附件或鍵盤的動作,使用 full 顯示整支手機居中,並在 1920 方形畫面上方與下方預留 90 像素。在準備、審查和匯出階段使用所選的版面。

  • 輸入文字時,文字會逐字出現,且輸入游標隱藏。在輸入最後一個字元或中斷輸入後,立即恢復欄位的原始游標外觀;不要在恢復前插入停頓。鍵盤按鍵不得顯示任何反白、彈出字元或手指點擊指示器。標準打字驅動程式 · 使用方式 · 視覺驗證

工作區

此檔案所在的目錄即為 showtime 根目錄 (SHOWTIME)。請使用絕對路徑來解析並呼叫腳本。遵循目標應用程式的指示。讀取相關執行階段的 run.json 和成品;使用 scripts/showtime_run.py init/note/status 來更新進度。進度不代表核准。

製作期間將已安裝的技能和素材保持為唯讀狀態。寫入影片的執行目錄;保留先前的拍攝畫面和其他代理人的工作。僅在作為參考資料提供時,才使用歷史階段的測試資料。

在開始製作之前,執行 scripts/showtime_doctor.py;在錄製時,加上 --record --axe <驅動程式> 參數。新的執行階段使用產品設定檔;現有的執行階段則保留其設定。

僅讀取任務所需的內容

任務參考資料
規劃故事、拍攝、編輯或匯出執行 — 載入相關章節
準備場景或故事板準備工作 — 審查前的視覺規則與證據
儲存核准或授權修正資訊清單與核准合約
審查已準備好的影格或完成的影片視覺驗證
調整點擊顏色、時間或大小點擊素材

一次完成的交付包含 MP4 影片、來源拍攝畫面、動作日誌、觀察結果與驗證發現。技術檢查不構成視覺驗證。

相關技能