Communitygithub.com

ahnchiyoon87/claude-skills

使用 Playwright 錄製實際操作服務的過程,並加上消費者視角的字幕,製作 5 分鐘以內的展示影片。用於「幫我拍影片」、「展示影片」、「示範影片」、「把過程拍成影片」等請求。不包含簡報投影片或實作指南。

claude-skills 是什麼?

這個技能會自動將服務操作過程錄製成 5 分鐘以內的展示影片,並加上消費者視角的字幕。它主要支援 Playwright 錄製(預設解析度 1280×720),並可選擇加入語音旁白或純字幕(SRT 格式加上字幕嵌入)。技能會先將請求拆分為 3 到 6 個場景,然後用 Playwright 的 `recordVideo` 功能以人類操作速度(slowMo 約 300ms)實際錄製每個場景。錄製完成後,它會撰寫字幕,避免使用內部術語,專注於解釋「這個功能對使用者有什麼好處」。最後透過 ffmpeg 將片段合併、重新計算字幕時間點,並確認總長度不超過 5 分鐘。這個技能非常適合用於快速製作產品展示、教學影片或客戶示範,但不會處理簡報投影片或實作指南。支援 Windows(Malgun Gothic 字型)和 Linux(Noto Sans CJK KR 字型)環境。

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

在你喜歡的 AI 中提問

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

說明文件

展示影片

展示影片是以消費者視角,展示實際使用服務的過程。長度 5 分鐘以內。 只要說一句「幫我把這個過程拍成影片,並加上簡單的說明」,就會用預設值從頭做到尾。

預設值:Playwright 錄製(1280×720)· 旁白採字幕(SRT + 嵌入字幕),語音僅在要求時加入 · 輸出為 mp4 + srt。 啟動服務的方式、測試帳號、影片風格請遵循專案中的 CLAUDE.md。

步驟

  1. 拆分場景 — 將請求拆解為使用者實際操作的流程,共 3 到 6 個場景。每個場景描述「畫面顯示的內容」與「一兩句說明」。

  2. 實際完整走一遍並錄製 — 啟動服務,使用 Playwright 的 recordVideo(解析度與 viewport 相同)從頭到尾實際操作。 以人類操作速度(slowMo 約 300ms),點擊後等待結果顯示在畫面上。影片檔案需關閉 context 後才會完成。 只重新錄製失敗的場景。記錄每個場景的錄製時間點(開始、結果顯示、結束)。

  3. 撰寫字幕 — 避免使用內部術語或程式碼名稱,改說「這樣做的好處是什麼」。每個場景 1 到 2 句話,在結果顯示後才說。

    • 不好的例子:「建立一個將 DMN rule 3 的 hit policy 改為 FIRST 的 PR。」
    • 好的例子:「重複的規則被整理好了,同一個訂單不會再重複套用折扣。」
  4. 編輯至 5 分鐘以內 — 只剪掉或加速載入、等待的部分。操作瞬間與閱讀結果的 2 到 3 秒保留。 若還是超過 5 分鐘,合併場景。不可刪除請求中的關鍵步驟。

  5. 合成 — 使用 ffmpeg 連接片段,並根據最終編輯版的時間點重新計算 SRT 時間碼,再嵌入字幕。 Windows 需切換到工作資料夾,使用相對路徑(避免路徑中的 : 跳脫問題)。字型 Windows 使用 Malgun Gothic,Linux 使用已安裝的韓文字型(例如 Noto Sans CJK KR)。

    ffmpeg -i edited.mp4 -vf "subtitles=demo.srt:force_style='FontName=Malgun Gothic,FontSize=22'" -c:a copy demo.mp4
    
  6. 確認 — 使用 ffprobe -v error -show_entries format=duration -of csv=p=0 demo.mp4 檢查是否小於等於 300 秒。 從幾個字幕時間點擷取畫面(ffmpeg -ss <秒數> -i demo.mp4 -frames:v 1 f_<秒數>.png),親自打開檢查字幕所述內容是否在畫面上可見,以及韓文是否正常顯示。

注意事項

  • 不得使用假畫面、模擬回應、注入 DOM 數值或強制點擊來製作場景。若無法完整走完流程,請回報無法完成。
  • 實際合併 PR、變更正式環境資料、發送郵件、付款等難以復原的操作,只能在專案指定的測試環境中執行。 若無此類環境,請在該場景執行前詢問使用者。確保密碼、Token 不會顯示在畫面或字幕中。
  • 回報內容:mp4 與 srt 路徑、實際長度、每個場景的說明、手動檢查的畫面、未確認的部分。發佈或傳送需另行請求。

相關技能