外掛安裝: 在執行設定或更新命令之前,如果此技能位於 HyperFrames 外掛內部,請遵循外掛執行規則。獨立安裝則保留下方的更新說明。
首先,保持此技能為最新狀態——執行前先向使用者確認:
npx hyperframes skills update faceless-explainer。如果一切已是最新,則為快速無操作;否則,它會刷新此技能及其依賴的核心領域技能,然後再開始依賴它們。
media-use:在獲取音訊/圖片/標誌之前,先呼叫
/media-use從 HeyGen 目錄和品牌標誌的官方來源解析 BGM/SFX/圖片。先執行--adopt以註冊現有資產。請參閱/media-use技能。
Faceless Explainer 轉 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 或輸出檔案。
在 init 之後立即寫入 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 § 提供者。
關卡: 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,並自我驗證(映射錯誤時退出碼為 1)。一旦退出碼為 0,即可繼續——無需手動編輯規格。
無面孔解說通常沒有品牌顏色/字型(tokens.json 的 colors/fonts 為空)→ 腳本會保留預設自己的調色盤,這是一個完整的可出貨設計。僅當使用者提供了品牌顏色/字型時,才在執行前將其新增到 tokens.json 中,並且僅在映射確實需要時才在事後手動調整 frame.md。
關卡: build-frame.mjs 退出碼為 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。教學的真實性仍然決定哪些節拍存在——切勿強迫節拍去適應藍圖,也切勿僅僅因為某個經過驗證的形狀可用就憑空創造一個節拍。無面孔視覺效果在後續步驟中創作,因此影格不攜帶資產清單:除非使用者提供了真實的 public/<basename> 圖片,否則將 asset_candidates 留空。使用分鏡和腳本參考中要求的確切欄位。
草擬完成後,執行審查循環的計畫審查——../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;assemble 將 audio_meta.json 不存在視為靜默),因此此步驟可以乾淨地跳過。music: none 但存在旁白時,會保留 TTS 並僅關閉 BGM。請確切使用此拼寫——不要即興創造其他標記。
關卡: 音訊作業已開始,或專案標記為靜默(music: none + 無 SCRIPT.md)。
步驟 4:影格視覺設計
目標:為每個分鏡影格加入視覺方向、佈局意圖和動作選擇。
草擬分鏡表...
(此處原文被截斷。完整的技能應包含步驟 4 至 6,以及更多細節。請根據原始完整的 SKILL.md 內容補齊。)
步驟 5:建構影格
目標:為每個影格生成獨立的 HTML 組合文件。
(此處原文被截斷。請根據原始完整的 SKILL.md 內容補齊。)
步驟 6:最終渲染
目標:從組合的影格生成最終影片文件。
(此處原文被截斷。請根據原始完整的 SKILL.md 內容補齊。)
用法範例
-
開始一個新的解說影片
- 步驟 0:使用
/hyperframes並以主題初始化專案。 - 步驟 1:將你的文字貼上作為來源。
- 步驟 2:選擇一個設計預設(例如,簡潔、卡通、科技感)。
- 步驟 3:批准或完善生成的故事腳本。
- 步驟 3.1:旁白和音樂在背景生成。
- 步驟 4-6:視覺效果被應用、逐個影格建構,並最終渲染成影片。
- 步驟 0:使用
-
從暫存狀態恢復
- 如果專案目錄存在,技能會自動從上次中斷的地方繼續。
-
從配方開始
- 在設定過程中提供一個配方名稱,以跳過設計系統選擇,並使用預製的結構。
相關參考資料
/hyperframes:主要入口和意圖路由。/media-use:授權和媒體資產管理。../hyperframes-creative/:設計、動畫和創意規則。../hyperframes-animation/:藍圖和影格工作規則。