hyperframes (heygen-com/hyperframes)

評測

在 Mac 測試機上執行 Codex CLI 0.166（gpt-6-astra，低推理），每次執行都使用全新的暫存專案與暫存的 HOME/TMPDIR/快取，技能分為已安裝（實驗組）、未安裝（對照組），以及未安裝但把技能核心要求濃縮成一句話附加在提示詞後（一句話提示組），每個任務的每個組別執行 2 次，關閉網路，封鎖 /tmp 寫入。提示詞從未提到技能（除了下方註明的措辭）。環境：所有組別都使用相同的專案範本（含 GSAP script 標籤的 index.html、作品的中繼資料）。沙箱沒有網路，也沒有 HyperFrames CLI，因此各組都無法執行 check、snapshot 或 render，只能撰寫原始碼。之後我們在另一台離線機器上，用固定版本 HyperFrames 0.8.226（draft 品質）渲染每個專案。這測的是技能的文字內容，而不是它的 CLI 迴圈。

三組對照

以 Codex CLI 執行 18 次，採規則式檢查評分，不經 LLM 評審。總分 19.9 / 30，評級為 視情況推薦。

判定：視情況而定（19.9 / 30）。 來源：heygen-com/hyperframes，skills/hyperframes，固定於提交 af0d68d。安裝：npx skills@latest add heygen-com/hyperframes --skill hyperframes。授權條款： Apache-2.0。

這是什麼

來自 heygen-com/hyperframes 的 hyperframes 技能（Apache-2.0）：一份 1,100 字的 SKILL.md，加上約 25 個參考檔案與幾個輔助指令碼，用來把影片做成 HTML，再透過逐格 seek 暫停的 GSAP 時間軸渲染成 MP4。它制定了一套 12 條規則的渲染契約（每個有時間的元素都是 class="clip" 並帶有 data-start／data-duration，在 window.__timelines 註冊一個暫停的時間軸，且沒有任何不具決定性的內容）、一種可編輯結構（每個子合成一個場景），以及一個以 npx hyperframes CLI 為核心的工作迴圈（檢查、快照、預覽、渲染）。

我們如何測試

在 Mac 測試機上使用 Codex CLI 0.166（gpt-6-astra，低推理），每次執行都使用全新的暫存專案與暫存 HOME/TMPDIR/快取，安裝技能（實驗組）、未安裝（對照組），或未安裝但將技能核心要求濃縮成一句話附加在提示詞後（一句話提示組），每個任務每組執行 2 次，網路關閉，/tmp 寫入封鎖。提示詞從未提及技能（以下註明的措辭除外）。

環境：專案範本（含 GSAP script 標籤的 index.html、composition 中繼資料）對所有組別都相同。沙箱沒有網路，也沒有 HyperFrames CLI，因此各組都無法執行 check、snapshot 或 render；他們只撰寫原始碼。接著我們在另一台離線機器上，以固定版本的 HyperFrames 0.8.226（草稿品質）渲染每個專案。這測試的是技能的文字，而不是它的 CLI 迴圈。

1. 15 秒產品預告 — 在這個 HyperFrames 專案中（index.html 根 composition、GSAP 時間軸，透過 npx hyperframes render 渲染），為 Tidepool 建立一支 15 秒、1920x1080、30 fps 的產品預告；Tidepool 是每月海藻零食訂閱服務。畫面上必要的文字：名稱「Tidepool」、…
2. 20 秒動畫長條圖解說 — 在這個 HyperFrames 專案中（index.html 根 composition、GSAP 時間軸，透過 npx hyperframes render 渲染），建立一支 20 秒、1920x1080、30 fps 的動畫解說影片：每月營收的長條圖（8 月 $42k、9 月 $58k、10 月 $71k）。標題「Revenue, last 3 months…
3. 30 秒直式字幕短片 — 在這個 HyperFrames 專案中（index.html 根 composition、GSAP 時間軸，透過 npx hyperframes render 渲染），建立一支 30 秒直式 1080x1920、30 fps、帶有燒錄字幕的社群短片。字幕依序出現，每則停留約 5 秒，從…

評分方式為程式化檢查（隱藏測試／植入問題召回／限制條件檢查／視情況進行渲染與 OCR），每次執行 0–5 分。沒有任何 LLM 評審決定分數。

結果

提供給第三組的一句話提示：「把它建成 HyperFrames HTML 合成：一個根節點帶有 data-composition-id/data-width/data-height/data-duration，每個有時間的元素都賦予 class="clip" 以及以秒為單位的 data-start 與 data-duration，將一個暫停的 GSAP 時間軸註冊為 window.__timelines["<composition-id>"]，且沒有任何不具決定性的內容（不要 Date.now()、未播種的 Math.random()、計時器、網路或 repeat:-1）。」

平均分數：未使用技能 4.9，使用技能 4.89（差異 -0.01）。每次執行 Token 數：128k 對 249k（1.95 倍）；時間 154 秒對 208 秒。一句話提示組：4.91（技能相較一句話提示的增益：-0.01；一句話提示相較無技能的增益：+0.0）；一句話提示每次執行 150k Token，因此技能的成本是一句話提示的 1.67 倍。

實際發生了什麼

• 影片品質相同。全部 18 個專案都在第一次嘗試就渲染出正確的尺寸、長度與影格率，而 OCR 在每個應該出現必要文字的執行中，都在畫面上找到那些文字（名稱、標語、$14／盒、結尾句、字幕）。平均分數：未使用技能 4.90、只使用其規則一句話版本 4.91、使用技能 4.89。所有三組唯一失分的地方，是長條圖解說影片有長時間靜止不動（有動作的影格佔 15-23%）。
• 一句話版本表現與技能相當。給對照組代理一句契約內容（clip 類別、data-start/data-duration、一個暫停的時間軸、沒有不具決定性的程式碼），就產生相同的分數與相同的外觀：我們檢視了三組的預告、圖表與直式短片的縮圖拼版，無法依品質為它們排名。
• 技能每次都會被讀取（6/6 次實驗組執行），但改變的是專案的建構方式，而不是外觀。全部 6 次技能組執行都將影片拆成子合成（compositions/*.html，每個場景一個），符合其「保持可編輯」章節的要求；未使用技能的 12 次執行中則有 0 次這麼做。將有時間的元素標記為 clip 的情況因組別而異，而非因技能而異：無技能執行每個專案使用 0-6 個、技能組 1-9 個、一句話提示組 3-25 個。如果之後有人要在 HyperFrames Studio 開啟專案，這正是技能中重要的部分，而這裡並未計分。
• 成本很高。每次執行 249k Token，未使用技能為 128k（1.94 倍），使用一句話提示為 150k（1.66 倍）；每次執行 15 個指令，對照組 8 個；時間約多 35%。代理會先讀取 SKILL.md 與數個參考檔案，而且在自主模式下，它仍會寫出沒有人要求的 SPEC.md、REVIEW.md 與 README（每次執行 4.7 個檔案，對照組 1 個）。
• 技能有一部分無法執行。SKILL.md 的迴圈是檢查、快照、審查、渲染；在沒有 CLI 的情況下，代理退而手寫 REVIEW.md 檔案。若在 CLI 可運作的環境中設定，可能會出現不同結果，也可能抓到此地第一次嘗試的專案所沒有的錯誤。

各面向分數

這項測試的限制

• 沙箱中無法使用 CLI 迴圈（檢查、快照、預覽、渲染），因此這裡只評分技能的指引；技能本身的前提是 CLI 能形成完整迴圈。
• 三項任務：產品預告、三條長條圖，以及直式字幕短片，全部以程式碼繪製。實拍素材、音訊、地圖、registry 區塊與基於 HeyGen 的媒體功能並未測試。
• 在 Linux 機器上以草稿品質渲染；動作檢查是粗糙的影格差異門檻，而同一個圖表任務在每組都失分。
• 結構計數（子合成、clip 元素）來自閱讀原始碼檔案，不屬於 0-30 分的一部分。
• 授權為 Apache-2.0，但技能依賴的 CLI 是另一個 npm 套件，我們並未稽核，也未在測試電腦上執行；除非停用，否則它會傳送使用遙測資料。
• 每項任務每組 n = 2：約 1 分以下的差異屬於雜訊。
• 規則式評分只能衡量檢查看得到的部分；無法評判品味，也無法判斷結果是否為最佳可能。

安全性

見 security.md。掃描：CRITICAL 27 / HIGH 26 / MEDIUM 88。判定：可安全執行（網路關閉的沙箱）。乾淨的掃描結果不能證明技能安全。

總結

在這個沙箱中，對於一次性的程式碼繪製影片，技能並沒有讓影片變得更好，還多花了大約一倍的 Token；把它的契約寫成一句話也有相同效果。它的價值在於專案結構（每個子合成一個場景、標記 clip），適合之後還會在 HyperFrames Studio 繼續編輯的人，以及我們無法實際演練的 CLI 迴圈。如果你經常使用 HyperFrames，就安裝它；如果只是快速做一次性的渲染，可以跳過。