首先,保持此技能最新狀態 — 執行前請與使用者確認:
npx hyperframes skills update faceless-explainer。若一切已是最新,則快速無操作;否則會在此技能及其依賴的核心領域技能被使用前,先進行更新。
media-use:在取得音訊/圖片/標誌前,請呼叫
/media-use從 HeyGen 目錄解析 BGM/SFX/圖片,並從官方來源取得品牌標誌。先執行--adopt註冊現有資產。請參閱/media-use技能。
Faceless Explainer to HyperFrames
使用此技能將一段文字轉換成解說影片:選擇設計系統、規劃教學故事,並在 HyperFrames 中逐影格建構。無人物表示每個視覺效果都是在後續步驟中發明產生 — 沒有擷取步驟,也沒有真實資產庫存。
入口是
/hyperframes。 你是編排者。依序執行每個步驟,驗證其關卡,然後才能繼續。此技能適用於從文字解釋主題,沒有產品且沒有網站可擷取。任何其他意圖、單純「製作影片」或任何不確定性 → 請先閱讀/hyperframes— 意圖層擁有所有路由決策權,而在沒有BRIEF.md的情況下,新創作請求會直接經過意圖層(設定階段的開場規則)。
你是編排者。在 videos/<project>/ 目錄下工作。依序執行步驟並通過每個關卡後再繼續。需要使用者確認的步驟為步驟 0、步驟 3 與步驟 6。在步驟 0 之前閱讀 ../hyperframes/references/brief-contract.md — 它定義了關卡類型,以及 BRIEF.md 的 flow/storyboard 如何推導模式,進而決定步驟 3/4/6 的關卡。除了步驟 5 你需要為每個影格派遣一個子代理執行,其餘步驟請自行完成。請勿在此放置設計或動畫規則;這些規則應存在於影格工作子代理、此技能本地的 ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/ 以及 hyperframes-creative 中。
工作流程:步驟 0 設定 → hyperframes.json;步驟 1 摘要 → capture/extracted/;步驟 2 設計系統 → frame.md;步驟 3 故事板/腳本 → STORYBOARD.md 和 SCRIPT.md;步驟 3.1 音訊 → audio_meta.json;步驟 4 視覺設計 → 增強的 STORYBOARD.md;步驟 5 影格 → compositions/frames/NN-*.html 和 index.html;步驟 6 最終渲染 → renders/video.mp4。
步驟 0:設定
目標:帶著已確認的摘要進入、建立 HyperFrames 專案,並使摘要持久化。
摘要由意圖層確認,而非在此提問決定。 開場規則,依序:(1) BRIEF.md 存在 → 讀取它且不問任何問題 — 摘要已定案,其 flow/storyboard 將推導模式(摘要合約 § 1)。(2) 沒有 BRIEF.md 但專案存在(磁碟上有 hyperframes.json / STORYBOARD.md)→ 從故事板的前置資料與已記錄的偏好設定繼續;切勿對已建構一半的專案重新提問。(3) 兩者皆無 — 直接到達的全新創作請求 → 閱讀 /hyperframes 並執行其意圖層(references/intent-interview.md):它會檢查配方與記住的預設值,進行此路由的提問(../hyperframes/references/routes/faceless-explainer.md),並回傳鎖定的摘要。編輯請求跳過所有這些 — 直接進行編輯。
僅在 hyperframes.json 遺失時才進行初始化。以 kebab-case 格式命名 <project>(從主題衍生),例如 compound-interest-explained;切勿使用工作區名稱或時間戳。
npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=faceless-explainer — init 會檢查已安裝的技能是否與 GitHub 上的最新版本一致,並在有任何技能過期時更新全域技能集。
初始化後,設 <PROJECT_ROOT> 為 videos/<project>,並以該目錄作為工作目錄執行後續所有相對路徑命令。在以下命令中,. 代表 <PROJECT_ROOT>;切勿在呼叫者目錄中寫入 .media、capture 或輸出檔案。
在初始化後立即寫入 BRIEF.md(絕不能在之前寫入 — init 拒絕非空目錄):意圖層鎖定的摘要,格式遵照 ../hyperframes/references/brief-format.md。將 <MEDIA_DIR> 解析為已安裝的 /media-use 技能目錄。然後使用 node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes . 記錄每個偏好支援的答案(brief-format.md 標示了子集合)。如果意圖層採用了配方,請執行 node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes . --name <name>;它會將配方的 frame.md 複製到專案中(步驟 2 隨即跳過),並回傳步驟 3 用以草稿的骨架。配方只填入答案,不包含核准;審查關卡仍會執行。
在繼續進行設定之前顯示登入狀態 — 執行 npx hyperframes auth status 並逐字轉達其輸出。它會回報語音/BGM 將使用 HeyGen 還是本機引擎,並在未登入時說明如何登入。套用一個分支:
- 協作模式: 等待使用者登入或明確選擇
offline/go。 - 自主模式: 陳述狀態並繼續使用可用的本機引擎。
當沒有離線提供者時,請勿默默忽略必要功能;應將阻礙點明確提出。請勿將此決策摺疊進其他問題,或將金鑰寫入每個儲存庫的 .env。認證所有權與離線備援:請參閱 /media-use 的 references/setup-providers.md § Providers。
關卡: hyperframes.json 和 BRIEF.md 已存在;偏好支援的答案已記錄(摘要合約 § 2);已顯示登入狀態(已登入,或繼續以離線模式運作)。
步驟 1:摘要(無擷取)
目標:將使用者的文字摺疊進專案作為資訊來源。沒有網站擷取和真實資產 — 這是一個無人物解說影片。
逐字儲存使用者的完整輸入,然後手動建立合成擷取封包:
capture/extracted/visible-text.txt— 完整的文章 / 筆記 / 主題 / 摘要,逐字呈現。這是資訊的來源,而非故事模板(步驟 3 會重塑它)。capture/extracted/tokens.json—{ "title": "", "description": "", "colors": [], "fonts": [] }。從摘要填入title/description。將colors/fonts保留為空,除非使用者明確提供了品牌色彩或字型 — 若有則加入(無論如何,設計預設會提供完整的調色盤)。
如果使用者貼上了腳本或希望保留其措辭,請逐字另存為 user_script.txt;VO_MODE(逐字或重構)來自 BRIEF.md — 意圖層會在收到腳本時詢問此項。僅在此處(若摘要因故缺少此資訊)詢問一次,並將答案儲存供步驟 3 使用。
請勿執行 npx hyperframes capture(沒有 URL)。請勿建立 asset-descriptions.md 或填入 capture/assets/ — 無人物視覺效果將在步驟 4-5 中發明產生,而非擷取。唯一例外:如果使用者提供了真實圖片,請將其置於 public/<basename> 下,並在步驟 3 中加以備註。
關卡: capture/extracted/visible-text.txt 和 capture/extracted/tokens.json 已存在;你能用一句清晰的話語陳述解說的主題與目標觀眾。
步驟 2:設計系統
目標:選擇一個已出貨的影格預設;一個腳本會將其轉換為此影片的 frame.md + 字幕外觀。
當 BRIEF.md 中指定了 style_preset — 使用者在意圖層透過展示集親自挑選的 — 則使用它;唯有在摘要未提及時,才由你做判斷。然後你只需做出一個決定 — 哪個預設:閱讀 ../hyperframes-creative/references/design-spec.md 並瀏覽 ../hyperframes-creative/frame-presets/;選擇外觀最符合主題、語氣與目標觀眾的預設。接著執行:
node <SKILL_DIR>/scripts/build-frame.mjs --preset <name> --hyperframes .
腳本會確定性地完成其餘工作:將預設的 FRAME.md 複製為 frame.md,並根據 capture/extracted/tokens.json 中的任何品牌代碼進行混搭(依角色將品牌色彩映射到預設的色彩鍵;以品牌的顯示字型與內文字型取代預設的),將預設的字幕外觀複製到 .hyperframes/caption-skin.html,並自行驗證(若映射中斷則以 exit 1 退出)。一旦 exit 0 即可繼續 — 無需手動編輯規範。
無人物解說影片通常沒有品牌色彩/字型(tokens.json 的 colors/fonts 為空)→ 腳本會保留預設自己的調色盤,這是一個完整的可出貨設計。僅在使用者明確指定了品牌色彩/字型時,才在執行前將其加入 tokens.json,並僅在必要時於事後手動調整 frame.md(如果某個映射確實需要調整)。
關卡: build-frame.mjs 以 exit 0 結束 — frame.md 已從指定的預設存在,並且(當預設有提供時).hyperframes/caption-skin.html 已作為字幕外觀來源存在;已將所選預設記錄為偏好(--key style_preset --workflow <此工作流程>,摘要合約 § 2)。
步驟 3:故事板與腳本
目標:將文字轉換為經批准的逐影格教學計畫。
閱讀 ../hyperframes-creative/references/story-spine.md(鉤子語言、價值先於證據、作為提案的故事板、可追溯來源的視覺效果)、references/story-design.md、../hyperframes-animation/blueprints-index.md、../hyperframes/references/storyboard-format.md 以及 ../hyperframes/references/script-format.md。使用它們來撰寫 STORYBOARD.md,並在需要旁白時撰寫 SCRIPT.md。根據摘要的 length 設定前置資料中的 duration: — 這是一個粗略預期;組合階段會報告最終長度與此預期的比較。
使用 story-design.md 來決定解說結構(概念 / 教學指南 / 條列式清單 / 故事)、鉤子策略、清晰度技巧、情緒節拍、類型列舉映射以及 VO_MODE。影片的序列來自敘事設計,而非輸入文字的段落順序 — 可以重新排序、合併、省略、壓縮。作為軟性指南,請參考 ../hyperframes-animation/blueprints-index.md 中的角色→藍圖選單:為每個節拍撰寫配音腳本,使其符合候選藍圖的形狀,並在適用時標記該候選藍圖的 blueprint: ID。教學真相仍然決定哪些節拍存在 — 切勿為了配合藍圖而強加節拍,也切勿因為有現成的好用形狀就發明節拍。無人物視覺效果將在後續步驟中發明,因此影格不需要資產庫存:將 asset_candidates 保留為空,除非使用者提供了真實的 public/<basename> 圖片。使用故事板和腳本參考文件中要求的確切欄位。
草稿完成後,執行審查迴圈的計畫階段 — ../hyperframes/references/review-loop.md § 1:將計畫作為提案呈現,並詢問兩個問題 — 批准或修改,以及先看草圖(建議)或跳過。回饋以聊天回覆的形式給出;持續循環直到獲得批准。這是一個檢查點關卡(摘要合約 § 1):在自主模式下無需提問 — 張貼相同的摘要作為提示並繼續;草圖會合併到建構中,唯一的一次預覽問題會留到步驟 6。
關卡: STORYBOARD.md 已存在,每個影格都具備必要的敘事欄位,SCRIPT.md 在需要旁白時已存在,且使用者已批准逐影格計畫(自主模式:摘要已作為提示張貼)。
步驟 3.1:音訊
目標:從已批准的腳本生成旁白、單字時間軸、音樂與音訊元資料。
在步驟 3 批准後開始音訊處理。在背景執行,然後繼續進行步驟 4。(登入狀態已在步驟 0 顯示;引擎會自動備援。)
在呼叫前,根據使用者的要求選擇旁白語音。 如果請求指定了語音、性別或語氣,請選擇相符的語音 ID 並透過 --voice <id> 傳遞。管線預設值為 HeyGen 的 Marcia(女性) 或 Kokoro 的 am_michael — 因此像「男聲」這樣的請求若未傳遞旗標,則會默默忽略。語音 ID 因提供者而異;請根據步驟 0 的登入狀態所選的提供者進行解析:HeyGen(已登入)使用 node <MEDIA_DIR>/audio/scripts/heygen-tts.mjs --list(或 GET /v3/voices?engine=starfish);Kokoro(離線)使用 <MEDIA_DIR>/audio/references/tts.md 中的語音表格(前綴 am_/bm_ 為男性,af_/bf_ 為女性)。當使用者未表達任何偏好時,在回退到管線預設值之前,先使用已記住的語音(摘要合約 § 2),並告知你使用了哪個語音;僅在兩者都未指定時才省略 --voice。當使用者在此次執行中明確選擇了語音,請記錄下來(prefs.mjs record --key voice)。
node <SKILL_DIR>/scripts/audio.mjs --script ./SCRIPT.md --storyboard ./STORYBOARD.md --hyperframes . --out ./audio_meta.json --voice <voice-id> &
音訊腳本負責處理旁白、單字時間軸、從 HeyGen 音樂庫查詢 BGM 以及時間軸元資料。BGM 情緒來自故事板的 music: 欄位。這使用 HeyGen Audio API 進行檢索(而非生成),並使用與 TTS 相同的 ~/.heygen 憑證。關於提供者的詳細資訊,請閱讀 ../media-use/audio/references/tts.md。
如果沒有旁白且沒有 SCRIPT.md,則跳過語音生成。如果故事板指定了音樂情緒,BGM 仍可能運行。
正統的完全靜音標記(跨所有重複使用此音訊模型的工作流程共享):在 STORYBOARD.md 的頂層 YAML 區塊中包含 music: none 並且沒有 SCRIPT.md。此組合標記專案為靜音 — 無旁白、無 BGM、無 SFX。audio.mjs 會辨識此標記且不生成任何內容(它會移除任何過時的 audio_meta.json;組合階段會將 audio_meta.json 不存在視為靜音),因此此步驟可乾淨地跳過。music: none 搭配旁白則保留 TTS 並僅關閉 BGM。請確實使用此拼寫 — 不要發明其他標記。
關卡: 音訊任務已啟動,或專案已標記為靜音(music: none + 沒有 SCRIPT.md)。
步驟 4:影格視覺設計
目標:為每個故事板影格加入視覺方向、佈局意圖與動畫選擇。
先繪製故事板草圖(僅限協作模式)。 計畫一經批准,立即執行草圖階段 — ../hyperframes/references/review-loop.md § 2(無需等待步驟 3.1;草圖不使用時間軸):自行將每個影格以線框形式繪製為 storyboard.html 的一個儲存格(`../hyperfram…
[以下省略,基於原文截斷]