Communitygithub.com

jakerains/elevenagents-harness

此精簡參考專為橋接器設計。完整產品指南請見已安裝的桌面應用程式及官方 HyperFrames 文件。

elevenagents-harness 是什麼?

此技能(HyperFrames 橋接器的創作參考)為 AI 代理(如 Claude Code、Cursor 等)提供從 HyperFrames 設計工具將多媒體合成匯出至獨立 HTML 的指引與規範。它支援繪製時間軸、管理媒體資產、註冊 GSAP 動畫,以及執行 lint、檢查、時間軸檢閱等驗證命令。透過明確的資料屬性與約定,確保匯出的作品能在外部執行環境(Harness)中正確顯示,同時避免 CSS 變形與 GSAP 的衝突、不受信任的網路依賴或隨機時序。此外,技能整合 ElevenLabs 語音與音效生成 API,可從描述或腳本產生實際的 MP3 資產,並在合成中正確放置。它不支援影像或影片生成,且所有生成皆使用使用者自己的 API 金鑰。此技能特別適用於將 HyperFrames 多媒體專案轉換為可佈署、自足的 HTML 體驗,同時配合桌面應用程式的規則執行匯出與驗證。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jakerains/elevenagents-harness/tree/HEAD/references/hyperframes-core

在你喜歡的 AI 中提問

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

說明文件

此橋接器的 HyperFrames 創作參考

此精簡參考專為橋接器設計。完整產品指南請見已安裝的桌面應用程式及官方 HyperFrames 文件。

組成

一個獨立的 index.html 在 body 中直接有一個合成根元素。請使用 data-composition-id、data-width、data-height 及有限的 data-duration。根元素的 CSS width/height 為 100%;畫布尺寸則應放在其 data 屬性中。子合成使用一個範本,並將其樣式/腳本寫在範本內部。

為片段指定 class="clip"、明確的 data-start/data-duration 和 data-track-index。一個軌道是 Studio 中的一條車道,並非時間限制或 z-index。根元素的 duration 必須涵蓋所有預定片段的結束時間。編輯時請保留不相關的時間設定、識別符號及媒體。

在 window.__timelines[compositionId] 中註冊一個暫停的 GSAP 時間軸,使用與根元素相同的 ID。對內部元素進行動畫;由框架控制片段的可見性與媒體搜尋。請勿對片段進行 display、visibility 或 autoAlpha 的動畫。避免 CSS-transform/GSAP 衝突、時鐘、計時器、未設種子的隨機值以及依賴網路的動畫狀態。

使用可本地重現的媒體。每個音訊元素都需要唯一的 ID 和有意義的時間設定。避免在媒體上使用 crossorigin,以及在含有 data-start 的影片周圍放置巢狀的時間祖先。檔案路徑必須與實際專案資產相符。

工作流程

在編輯前,請先閱讀相關檔案及應用程式所需的指南。比對使用者要求的範圍。請勿聲稱執行不可用的 MCP 工具或 shell 命令。橋接器會公開命名為 lint、check、timeline 和 inspect 的命令。

執行有意義的命名檢查,回報其實際的退出狀態與發現結果,並保留不相關的工作。lint 錯誤可能會阻止 runtime/layout/contrast 檢測的執行;零樣本並不代表成功的視覺驗證。通過 lint 並非視覺品質的證明。

僅在使用者要求匯出且 app_rules 允許時才進行渲染。持續輪詢 render_status 直到終端狀態;絕不能聲稱未完成的匯出已成功。桌面應用程式可能自行負責匯出,此時請遵循其 app_rules。

音訊資產

在本機啟用且使用者要求時,list_voices 會回傳使用者可用的語音 ID。create_speech 和 create_sound_effect 會回傳實際的、相對於專案的 MP3 檔案。在合成中使用回傳的路徑,並賦予唯一的音訊 ID 和適當的時間設定。若生成失敗,請回報失敗,不得自行發明資產或自動重試。

語音與音效是使用使用者自己的金鑰進行的產品 API 呼叫。腳本/描述會被傳送至 ElevenLabs,生成過程可能消耗點數。聊天僅限文字。此版本不開放音樂、圖片或影片生成。

相關技能