Communitygithub.com

christiansalazar-wk/ai-lore

HyperFrames 組成合約 — HTML 結構、data-* 屬性、片段與軌道。撰寫有效 HyperFrames HTML 的權威參考。

ai-lore 是什麼?

此技能定義了 HyperFrames 的「組成合約」——一個用於宣告式動態排版與媒體組合的 HTML 框架。它詳細說明了標準的 HTML 骨架、Canvas 中繼標籤(如解析度、幀率、持續時間),以及 data-* 屬性系統,用於場景、軌道和片段。開發者可運用場景層級(data-hf-scene)組織時間線,在軌道(data-hf-track)上按 z 軸分層素材,並設定片段(data-hf-clip)精確控制每個媒體元素的開始時間、持續時間、動畫與音量。支援影片、圖片、音訊及文字轉語音片段。此技能對於使用 Cursor、Claude Code 或 Codex 等 AI 代理來生成或驗證 HyperFrames 專案的使用者至關重要,因為它提供了可供 lint 檢查的語法規則與時間格式(CSS 樣式時間記法),確保 HTML 遵循框架規範。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/christiansalazar-wk/ai-lore/tree/HEAD/skills/hyperframes-core

在你喜歡的 AI 中提問

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

預覽

來自技能 README

ai-lore preview

說明文件

HyperFrames 核心 — 組成合約

HTML 骨架

<!DOCTYPE html>
<html data-hf-version="1">
<head>
  <meta charset="UTF-8" />
  <meta name="hf:canvas-width" content="1920" />
  <meta name="hf:canvas-height" content="1080" />
  <meta name="hf:fps" content="30" />
  <meta name="hf:duration" content="auto" />
</head>
<body>
  <div data-hf-scene="intro" data-hf-duration="5s">
    <div data-hf-track="background">
      <div data-hf-clip data-hf-start="0s" data-hf-duration="5s"
           style="background:#111;width:100%;height:100%;position:absolute;"></div>
    </div>
    <div data-hf-track="title">
      <div data-hf-clip data-hf-start="0.5s" data-hf-duration="4s"
           data-hf-animate="fade-in">
        <h1>Hello World</h1>
      </div>
    </div>
  </div>
</body>
</html>

Canvas 中繼標籤

標籤預設值備註
hf:canvas-width1920像素
hf:canvas-height1080像素
hf:fps30每秒幀數
hf:durationauto總時長;或明確指定如 60s
hf:bg-color#000預設場景背景

場景屬性 (data-hf-scene)

屬性類型說明
data-hf-scene字串場景名稱 / ID
data-hf-duration時間5s、10s、auto
data-hf-transition字串cut、fade、slide-left、slide-right、zoom
data-hf-transition-duration時間預設 0.5s
data-hf-bgURL 或顏色場景背景

軌道屬性 (data-hf-track)

屬性類型說明
data-hf-track字串軌道名稱
data-hf-z數字z-index 層疊順序
data-hf-mute布林值靜音此軌道的音訊

片段屬性 (data-hf-clip)

屬性類型說明
data-hf-clip—將元素標記為片段
data-hf-start時間在場景內的開始偏移量
data-hf-duration時間片段持續時間;auto = 內容持續時間
data-hf-end時間可替代持續時間
data-hf-animate字串簡寫動畫預設
data-hf-in字串入場動畫
data-hf-out字串出場動畫
data-hf-volume0–1音訊音量
data-hf-speed數字播放速度倍率
data-hf-loop布林值循環播放媒體
data-hf-trim-start時間從開頭裁剪媒體
data-hf-trim-end時間在結尾裁剪媒體

媒體片段

<!-- 影片 -->
<video data-hf-clip data-hf-start="0s" src="assets/hero.mp4" />

<!-- 圖片(靜態,持續時間內保持) -->
<img data-hf-clip data-hf-start="0s" data-hf-duration="3s" src="assets/logo.png" />

<!-- 音訊 -->
<audio data-hf-clip data-hf-start="0s" src="assets/music.mp3" data-hf-volume="0.4" />

<!-- TTS 旁白 -->
<div data-hf-clip data-hf-tts="Hello, welcome to the demo." data-hf-start="1s" />

時間格式

所有時間值使用 CSS 風格記法:0s、1.5s、2000ms。允許小數秒。

驗證

npx hyperframes lint index.html

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

相關技能