Communitygithub.com

RoleModel/rolemodel-openscreen

將 RoleModel 品牌套用到 HyperFrames 影片上 — 涵蓋設計規範來源、該選用哪個動態代碼、品牌禁止事項,以及旁白與客戶交付流程。

rolemodel-openscreen 是什麼?

此技能專為在 HyperFrames 生態系統中製作 RoleModel 品牌影片而設計。它作為一個輕量層,疊加在現有的 HyperFrames 技能組之上,專注於注入品牌特定的設計規範、動態代碼選擇規則與禁止事項,而將底層的合成、時間軸動畫、音訊混音等技術細節委託給其他 HyperFrames 技能處理。技能的核心是透過 `design.md` 檔案與品牌設計系統銜接,該檔案由 `rolemodel-brand` 儲存庫的自動化腳本產生,確保色彩、字型與動態代碼的一致性。使用此技能時,開發者不應直接複製或覆寫 HyperFrames 技能的既有規則,所有遺漏或修正都應回饋到上游技能。此外,本技能定義了明確的不允許行為(如禁止徑向漸層、畫面 wipe、裝飾性分隔線等),並引導使用者在方向未鎖定時先使用 `hyperframes-direction-harness` 進行審閱,最後透過專屬 CLI 工具處理旁白生成與客戶交付。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/RoleModel/rolemodel-openscreen/tree/HEAD/skill/hyperframes-brand

在你喜歡的 AI 中提問

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

說明文件

RoleModel 品牌 for HyperFrames

我們已擁有深入的 HyperFrames 工具組。從那份清單開始著手,而不是從零開始。 此技能僅是上層的品牌層:我們的規範從何而來、該選用哪個代碼、以及我們不做哪些事。

工具清單

已安裝兩套技能組,且名稱上有重疊。請確認你正在呼叫的是哪一套。

官方(HeyGen),位於 ~/.claude/skills:

技能何時使用
hyperframes合成腳本創作、時間軸設定、媒體管理、製作流程
hyperframes-core合成協定與 data-* 時間屬性
hyperframes-animation動態規則、場景藍圖、GSAP 及其他執行期
hyperframes-keyframes特寫切入、鏡頭移動、重構畫面、安全關鍵影格
hyperframes-creative色盤、節奏規劃、旁白、合成模式
hyperframes-audio已放置音軌的混音 — 淡入淡出、側壓、自動化
hyperframes-cli初始化、檢查、預覽、渲染、轉錄、文字轉語音
hyperframes-registry安裝區塊與元件
media-use尋找或生成音樂、音效、圖片、語音

標準(我們的),位於 ~/.claude/skills/synced:

技能何時使用
hyperframes我們自己的合成技能 — 讀取 design.md、house-style.md
hyperframes-cli我們自己的 CLI 筆記
hyperframes-direction-harness在最終 index.html 之前,當方向尚未鎖定時
optics-context任何同時也需作為產品界面的內容
gsapGSAP 特定細節
impeccable我們的工藝規範

名稱衝突。hyperframes 與 hyperframes-cli 同時存在於兩套清單中。 當你取得哪一套很重要時,請明確指定。

請勿在此重述它們的任何規則。 合成協定、檢查錯誤、音軌衝突、暫停的時間軸 — 所有這些都歸屬於那些技能,並在那裡維護。第二份副本會隨著它們發佈新版本而走樣,且無人察覺。如果某條規則遺漏了,請在上游修正,而不是在此檔案中。


品牌透過 design.md 連接到 HyperFrames

標準版的 hyperframes 技能已會從專案根目錄讀取 design.md,將其視為 "品牌色彩、字型與限制的唯一真相來源",並被指示使用其確切數值,而非自行發明。這就是連結點。請善用它。

品牌儲存庫會產生此檔案:

cp rolemodel-brand/dist/design.md <video-project>/design.md

它由 rolemodel-brand/tokens/brand.json 透過 scripts/build-tokens.mjs 產生,因此不可能與其他 RoleModel 界面使用的代碼不一致。切勿手動編輯它 — 請修改 brand.json 後重新執行。

該檔案包含色彩、字型、完整的動態尺度、四項動態原則,以及以下的限制。一旦檔案進入專案,現有的技能就會接手後續工作。

若要在合成本身中使用 CSS 自訂屬性:

<link rel="stylesheet" href="rolemodel-brand/css/academy-theme.css">
<body data-theme="academy">

選擇動態代碼

完整數值在 design.md 中。選擇的規則很簡短:

根據元素在做什麼來選擇,而不是根據它看起來像什麼。

  • 一個元素進入畫面 → --duration-base + --ease-enter
  • 同一個元素離開畫面 → --duration-fast + --ease-exit。 離開總是比到達更快。
  • 已在畫面上的元素改變位置或大小 → --ease-move
  • 刻意吸引目光的效果 → --ease-emphasis,唯一可能 overshoot 的曲線
  • 一個群組 → 兄弟元素之間使用一個 --stagger,切勿同時出現

切勿在合成中直接使用原始時長或原始 cubic-bezier。工作室對色彩也適用相同的規則,原因相同。

我們不做的事

這些是具有約束力的。其中幾項由工具包中的 npm run check 強制執行,且全部列在 design.md 中,供合成技能讀取。

  • 禁止使用徑向漸層,任何地方都不行。 品牌是線性的 — 方向性,而非模糊色塊。
  • 禁止畫面 wipe。 請勿繪製白色或淺色邊框、框線或盒子,作為場景轉場。Claude 未經提示就會使用這個效果;這是典型的範本花招,不是我們的風格,而且它無法引導注意力。請透過直接剪接,或使用 --ease-enter 揭露進入的內容來進行轉場。沒有任何東西會圍繞畫面畫框。
  • 禁止裝飾性線條、底線或分隔線。 請勿為標題加底線、在區塊之間加入分隔線,或在卡片、統計數據、引言或 Lower Third 周圍畫邊框。Claude 傾向使用這些來標示結構;它們只表示多加了東西。區隔應來自空間、重量與背景。系統中唯一許可的規則線是標題下方的短品牌槓,而 rm-title 會繪製它 — 切勿手動加上第二條。
  • 邊緣必須是實線,而非漸層。 這規範的是必要邊緣如何繪製,並非給予你加上邊緣的許可。如果沒有邊緣也不會導致混淆,就不要加。
  • 橙色僅可作為強調色 — 絕不能作為背景色。
  • 禁止裝飾。 如果一個元素不承載資訊或引導注意力,就移除它。

當方向尚未鎖定時

請勿直接開始撰寫 index.html。請使用 hyperframes-direction-harness — 它正是為此而建,能在任何合成之前產生可審閱的工作板:

01_intake.md → 02_design_direction.md → 03_critical_frame_plan.md
             → direction_board.html  (導演工作台,已審閱)
             → 04_render_plan.md     (僅在審閱後備妥)
             → 移交給 hyperframes 技能

僅在對現有合成進行小幅編輯時可跳過此流程 — 例如修正錯字、微調時間軸、更改一個顏色、修正 lint 問題。

哪個工具解決哪個問題

HyperFrames 用於合成,而非錄製。如果影片必須顯示真實產品介面,它就是錯誤的工具。

輸入工具保持最新?
錄製你的螢幕openscreen否 — 需手動重新錄製
合成腳本或簡報HyperFrames重新執行簡報即可
從測試Playwright 追蹤playwright-recast是 — 重新執行測試即可

當你需要為錄製內容加上標題卡、Lower Third 與動態圖形時,才使用 HyperFrames。

旁白、時間軸、交付

請勿在合成內部合成旁白。

rm-voice <project> --script opener --voice af_nova

每行一個片段,每個都經過測量,SRT 檔案根據已知時長撰寫 — 因此時間軸透過建構方式精確無誤,且進行文案編輯時僅重新合成變更的部分。Kokoro 在本地端執行:無需 API 金鑰,且未發佈的客戶產品相關資訊不會離開你的機器。

渲染與旁白音軌處於不同的時間軸上。 playwright-recast 會壓縮閒置時間;旁白則取決於文字所需的時間。將 22 秒的字幕軌燒入 3.8 秒的渲染中,cue 1 會為整個片段保持等待,而其餘部分則會被靜默丟棄 — 這看起來像是運作成功了。

rm-mux --video demo.mp4 --audio narration.wav --srt narration.srt -o final.mp4
rm-share final.mp4 --project "Ridgeline Railing"

rm-share 會回傳一個連結,客戶無需帳號即可開啟,並可留下帶有時間戳的評論。rm-share --check 則會顯示它是否已設定。

在客戶專案開始前

export HYPERFRAMES_NO_TELEMETRY=1

遙測功能預設為開啟。專案名稱與影片內容絕不會被收集,但 hyperframes auth login 會將你的 HeyGen 帳號電子郵件連結到你的使用情況,並將先前的匿名活動與之關聯。 請在專案腳手架中加入退出選項。

鎖定版本。HyperFrames 採用 Apache-2.0 授權 — 無座位數限制,無公司規模門檻,這也是它成為我們預設選項的原因 — 但它處於 1.0 版之前,且幾乎每日發佈,並未聲明任何相容性保證。今天能渲染的客戶專案,六個月後也應能以同樣方式渲染。


致謝

三層框架以及從剪接 → 分鏡 → 動態圖形管線的概念,來自 Jay at RoboNuggets 的 hyperframes-helper,使用 CC BY 4.0 授權。若你重新分享此內容,請保留此出處 — 這是授權條款的要求。

相關技能