Community程式設計與開發github.com

saranambiar/hyperframes-video-agent-skills

適用於 HyperFrames、FFmpeg、字幕、音訊同步和渲染品質檢查的代理驅動影片創作可重複使用技能、腳本和生產工作流程。此為來自真實 HyperFrames 影片工作的社群專案,非 HyperFrames 或 HeyGen 官方儲存庫。

hyperframes-video-agent-skills 是什麼?

此技能專為 AI 代理設計,用於處理 HyperFrames 生態系統中的影片創作,提供一套結構化的指南以整合產品錄製片段。它會指示代理如何管理關鍵任務,例如素材裁切決策、基於時間軸的過渡處理、敘述與產品狀態同步,以及嚴格的渲染品質檢查。支援的平台包括 Claude Code、Coder、Cursor 和 Codex,適用於需要將畫面或 UI 錄製內容編織到最終影片的任何影片製作流程。技能運作方式是透過指定詳細的攝取檢查清單(解析度、影格率、死時間)、輸出格式(需包含來源錄製、裁切策略、檢驗影格)以及特定的使用者審批點(在裁切畫布或移除游標之前),確保代理在無需人工干預的情況下做出明智的編輯決策。此外,它還包含一個產品時刻對照表,以將錄製時間戳記與敘述短語對齊,以及一個裁切決策矩陣,可根據 UI 可見性和畫面移動來選擇無裁切、輕裁切或動態裁切,從而在保持產品清晰度的同時實現專業的影片品質。

相容平台~Claude Code~Codex CLI✓Cursor
npx skills add saranambiar/hyperframes-video-agent-skills

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

產品示範整合

當產品錄製素材是最終影片的一部分時,請使用此技能。

攝取

在編輯之前:

  • 探查錄製的持續時間、解析度、影格率和音訊。
  • 識別錄製內容是否包含畫布、瀏覽器框、游標、縮放、滾動或死時間。
  • 識別所需的產品時刻及其時間戳記。
  • 識別必須與產品狀態對齊的敘述短語。
  • 在進行可能切掉重要 UI 的激進裁切前,請取得批准。

裁切決策

預設保留 UI 優於移除背景畫布。

僅在以下情況使用裁切:

  • 重要的 UI 在縮放和滾動期間保持可見。
  • 裁切不會切掉標題、標籤、游標上下文或最終狀態。
  • 有一個檢驗影格確認最緊的縮放仍然有效。

在以下情況使用不裁切或輕裁切:

  • 錄製內容縮放到不同區域。
  • 產品時刻在畫布上移動。
  • 使用者已經表示裁切的輸出切掉了關鍵文字。

請參閱 references/crop-and-zoom.md 的檢查清單。

過渡至產品錄製素材

  • 從前一場景的最終影格開始。
  • 如果需要連續性,請使用相機滑動或推送動作,而非硬切。
  • 停留在產品錄製的目前第一個影格。
  • 如果錄製內容以死時間開始,僅在不會破壞同步的情況下才修剪它。
  • 如果產品時刻必須與敘述對齊,請重新調整該時刻之前的片段時序,而非改變之後的所有同步。

過渡退出

  • 保留最後有意義的產品狀態足夠長時間,以便觀眾認出它。
  • 如果需要,建立一個相機滑動到下一個場景。
  • 避免在螢幕錄製的結尾出現意外的空白影格。
  • 在過渡邊界提取一個檢驗影格。

品質檢查

  • 檢查第一個產品影格。
  • 檢查每個縮放峰值。
  • 檢查每個必需的產品狀態。
  • 檢查過渡的進入/退出。
  • 確認字幕未遮蓋產品 UI。

輸出

傳回:

  • 使用的來源錄製。
  • 裁切/不裁切決策。
  • 修剪/重新時序的片段。
  • 渲染路徑。
  • 最緊裁切和關鍵產品時刻的檢驗影格。

產品時刻對照表

在編輯前建立時刻對照表:

  • 錄製時間戳記。
  • 可見內容。
  • 敘述短語。
  • 期望的全域時間戳記。
  • 游標是否重要。
  • 滾動位置是否重要。
  • 字幕是否重疊。
  • 裁切是否安全。

使用此對照表來決定修剪和重新時序。

裁切決策矩陣

在以下情況選擇不裁切:

  • 使用者接受畫布/背景。
  • 縮放在畫面中移動。
  • 主要文字被緊裁切切掉。
  • 產品狀態比修飾更重要。

在以下情況選擇輕裁切:

  • 畫布分散注意力但 UI 保持居中。
  • 字幕需要更多空間。
  • 瀏覽器 chrome 或死邊距可以安全移除。

僅在以下情況選擇動態裁切:

  • 每個裁切矩形都已對應。
  • 移動感覺有意圖。
  • 所有關鍵產品狀態都有檢驗影格。

敘述同步

將產品狀態與口語短語同步:

  • 如果產品必須在短語發出時可見,請在短語之前開始過渡。
  • 如果理解很重要,請讓最終產品影格在短語後保持。
  • 放慢事件之前的素材,而不是不自然地加快產品滾動。
  • 不要為了達到產品狀態而在敘述中途切斷詞語。

螢幕錄製清理

檢查:

  • 游標可見性。
  • 瀏覽器 UI。
  • 通知彈出視窗。
  • 死時間。
  • 空白載入畫面。
  • 意外的桌面邊緣。
  • 滾動速度。
  • 縮放焦點。

僅在不會損害產品清晰度的情況下移除或隱藏這些。

字幕安全性

如果字幕是燒錄的:

  • 檢查底部導覽列。
  • 檢查產品表格。
  • 檢查模態按鈕。
  • 檢查時間軸控制項。
  • 移動字幕邊距或在必要時選擇不同的檢驗影格。

使用者審批點

在以下情況之前詢問:

  • 裁切掉可見的畫布。
  • 移除游標。
  • 大幅加快素材速度。
  • 模糊或遮蓋產品細節。
  • 用重新建立的 UI 取代真實素材。

交接格式

報告:

  • 使用的產品片段。
  • 裁切策略。
  • 修剪點。
  • 重新時序比率。
  • 關鍵檢驗影格。
  • 任何出於設計考量而保留不完美的 UI。

相關技能