pr-to-video 是一個將 GitHub 拉取請求(PR)轉化為程式碼變更解說影片的 HyperFrames 技能。它的輸入是一段程式碼變更,而非網站,因此沒有網頁擷取步驟,除貢獻者頭像外也沒有真實素材。
用途 它接收 PR 網址、owner/repo#N 參照,或已檢出倉庫中的「這個 PR」,先理解變更內容,再規劃逐幀解說,最後在 HyperFrames 中逐幀建構並渲染出影片。適用於 changelog、功能揭示、修復解說、重構走查等 PR 敘事原型。
主要能力
- 以 gh 確定性抓取 PR 事實,並透過分頁 gh api 補全檔案清單,避免大型 PR 在約 100 個檔案處被截斷;輸出 capture/pr.json 與 capture/diff.patch。對已合併的 PR,還會盡力解析 shipped_version 與 version_source 寫入 pr.json。
- 離線轉換為 tokens.json(顏色為空時採用 code-editorial 調色盤)、visible-text.txt 與 people.json(貢獻者、過濾機器人、名稱與登入名、頭像檔名)。
- 盡力下載貢獻者 GitHub 頭像至 assets/<login>.png,用於片尾致謝;此步失敗不視為錯誤。
- 採用固定的 code-editorial 視覺風格,由 build-frame.mjs 依預設產生 frame.md 與字幕皮膚 .hyperframes/caption-skin.html。
- 依 PR 敘事撰寫 STORYBOARD.md 與必要時的 SCRIPT.md,規劃逐幀敘事、鉤子、說服節奏、每幀字數預算與片尾致謝,並嵌入 2–4 個真實 diff 片段。
- 由 audio.mjs 產生旁白、字時序、HeyGen 音樂庫 BGM 與音訊中繼資料;可指定聲音 id,否則依登入狀態使用預設(HeyGen 為 Marcia,Kokoro 為 am_michael)。
- 以有界幀工作池生成 compositions/frames/NN-*.html 與 index.html,最終渲染 renders/video.mp4。
使用方式 工作流程依序為:Step 0 設定 → hyperframes.json;Step 1 擷取 → capture/extracted/ 與頭像;Step 2 設計系統 → frame.md;Step 3 分鏡與腳本 → STORYBOARD.md 與 SCRIPT.md;Step 3.1 音訊 → audio_meta.json;Step 4 視覺設計 → 充實後的分鏡;Step 5 幀 → compositions/frames/;Step 6 最終渲染 → renders/video.mp4。每個步驟都須通過閘門才繼續,其中 Step 0、3、6 為使用者確認步驟。
設定時以腳本解析專案目錄,預設使用耐用的外部快取位置,不在呼叫方倉庫中建立 videos/;若 hyperframes.json 不存在才初始化專案,專案基底名稱取自 PR。初始化後立即寫入 BRIEF.md,並顯示 npx hyperframes auth status 的登入狀態。
安裝與更新:獨立安裝時可執行 npx hyperframes skills update pr-to-video 保持技能最新(執行前需經使用者確認);若技能位於 HyperFrames 外掛中,則依外掛執行規則處理。使用音訊、圖片、標誌前先呼叫 /media-use,從 HeyGen 目錄解析 BGM/圖片、從 Openverse 取得音效、從官方來源取得品牌標誌;宿主應用若自帶音樂或音效工具,則優先使用。
適用場景 適合需要以影片說明單一 PR 變更的開發團隊、開源專案維護者與技術傳播場景,例如版本更新說明、新功能展示、修復解說或重構走查。
限制
- 輸入必須是可由 gh 讀取的 GitHub PR;gh 認證失敗、找不到或私有 PR 時會直接報錯停止,不會捏造 PR 內容。
- 視覺風格固定為 code-editorial,不詢問樣式。
- 無 BRIEF.md 的全新請求須先經 /hyperframes 意圖層確認簡報,不能直接跳入製作。
- 無旁白且無 SCRIPT.md 時跳過語音生成;僅當 STORYBOARD.md 標記 music: none、無 SCRIPT.md 且無音效 cue 或宿主音訊時,才視為完全靜音專案。
- 缺少頭像僅代表沒有片尾致謝,不算失敗;貢獻者若無公開名稱,畫面上以登入名顯示並從旁白中略去。
- 其他未提供的事實(如收費、平台支援細節)暫未提供。