Communitygithub.com

demoscene-intro

建立一個尺寸受限的 Demoscene 開場動畫(64k 或 4k/8k/16k/32k 預算),作為單一自包含的 HTML 檔案,包含即時 WebGL 圖形、合成 WebAudio 配樂,以及編排好的攝影機與字幕。

demoscene-intro 是什麼?

此技能用於在瀏覽器中生成一個完全自包含的 Demoscene 開場動畫,所有內容(圖形、音效)均以程式碼合成,無任何外部請求。預設總體預算為 65,536 位元組(64KB),但支援 4k、8k、16k 及 32k 等更小預算,並為音樂程式碼分配獨立子預算(預設 16,384 位元組)。使用者只需描述場景與氛圍(例如「緩慢飛行穿越淹沒的大教堂,伴隨 ambient 配樂,小於 64KB」),此技能便會制定規格、提醒常見陷阱,並提供檢查工具來驗證成果。支援 CLI 腳本檢查檔案大小、音訊峰值與空值、攝影機路徑碰撞檢測等。輸出為一個 HTML 檔案,並在使用者的瀏覽器中直接開啟,以便他們即時觀看並聆聽。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/LukaszDygon/demoscene/tree/HEAD/skill/demoscene-intro

在你喜歡的 AI 中提問

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

說明文件

Demoscene 開場動畫

你正在創作一件藝術品,它恰好非常小巧。使用者的簡報就是藝術方向。你的任務是發揮工藝與創意,在預算範圍內實現它:簡報是底線,而非上限。

規格

  • 單一 HTML 檔案,無任何外部請求,且須在位元組預算內(預設 65,536)。請尊重使用者指定的任何預算:4k、8k、16k、32k。配樂程式碼擁有自己的子預算(預設 16,384,約為較小類別總預算的四分之一)。報告原始未壓縮的大小。僅在使用者所屬派對規則允許時,才可使用自解壓縮打包器;若使用,請明確說明。
  • 即時圖形(WebGL2)與合成配樂(WebAudio),均由程式碼生成。文字使用作業系統字型,並為 macOS、Windows 和 Linux 設定備援字型堆疊,因為嵌入字型會超出預算。
  • 點擊後約一秒內開始播放。 即時合成音訊,並使用短前瞻。瀏覽器會封鎖未經手勢觸發的音訊,因此請將起始畫面設計為作品的一部分,而非通用的「點擊開始」。音訊時鐘驅動視覺效果。
  • 所有內容均以節拍和小節為單位與音樂同步。首先以小節為單位撰寫分鏡腳本:場景、攝影機、字幕、音樂段落。

使其獨一無二,而非千篇一律

最常見的失敗是僵硬、安全的作品:模板化的標題卡、全平面著色、軌道式攝影機、僅僅標示場景的字幕。根據簡報選擇技術:

  • 光線步進 SDF 與體積光適用於水下、雲朵、有機形體
  • 網格適用於建築與角色
  • 單一片段著色器適用於 4k–16k
  • 2D Canvas 技巧、粒子與回饋緩衝區,用於支援特定視覺風格

將位元組花在視線焦點上:

  • 光線:霧、光柱、輝光、反射
  • 紋理與雜訊
  • 次要動態:漂浮、呼吸、對節拍的反應
  • 每個作品有一到兩個讓觀眾記住的標誌性時刻

提防該類型的慣用答案:最常見的進程、節奏、音色或後製效果,例如合成波必用 Am–F–C–G 和弦進行,或到處加上磁帶抖動、掃描線與綻光效果。根據此簡報的情緒與主題推導出節奏、調性、和聲、音色與後製,並至少做一個聽眾無法從類型標籤預測到的選擇。僅從其他開場動畫的資料夾結構中借鑑慣例,絕不借用它們的外觀或聲音。

將標題畫面、轉場和結束卡視為藝術的一部分。若簡報內容薄弱,請根據其精神進行創作,並告知使用者你添加了哪些內容。

合約(供檢查工具使用)

  • 將音樂保留在獨立的腳本中,其程式碼也能離線渲染:暴露 SONG.render() → Promise<AudioBuffer>,方法是在 OfflineAudioContext 上執行相同的排程器。這是測量你無法聽到的混音的方式。請參閱 references/audio.md。
  • 可選,適用於幾何體內的攝影機飛行: 定義 window.__probe = {dur, cam: t => [x,y,z], boxes: [[x0,y0,z0,x1,y1,z1], …]} 用於間隙檢查。

檢查你的作品

python3 <skill>/scripts/budget.py dist/x.html --total 65536 --music src/music.js --music-max 16384
node <skill>/scripts/check.mjs e2e dist/x.html         # 點擊 → 首次聲音時間、異常
node <skill>/scripts/check.mjs audio src/music.js      # 離線渲染:峰值、NaN、每四小節 RMS
node <skill>/scripts/check.mjs clearance dist/x.html   # 若定義了 __probe

不要截圖:使用者透過觀看動態且有聲音的作品來評斷,這就是視覺審查。透過推理程式碼來發現視覺問題:曝光與色彩數學、時間軸上每個時刻螢幕上顯示的內容,以及某個揭露效果是否過早可見。對於音訊,目標峰值為 0.5–0.95,無 NaN,且各段落音量須符合編曲。

交付

在使用者的瀏覽器中打開開場動畫,以便他們觀看並聆聽(open dist/x.html)。告知他們大小與預算的對比、時間軸、你超出簡報所發明的內容,以及你無法驗證的部分。你尚未聽到音樂,僅測量了它。

常見陷阱(曾耗費數小時)

  • 持續增長的音訊圖。 預先排程整首歌曲會讓數千個死節點保持存活。請逐小節排程並在完成後斷開節點(references/audio.md)。
  • 固定使用 44.1 kHz 的緩衝區 會在 48 kHz 的即時音訊環境中拋出錯誤。請使用 ctx.sampleRate。
  • 揭露效果洩漏。 巨大的主角物件會過早地從牆後、敞開的屋頂上方出現。請根據時間限制它們,或將其隱藏在其他物體後面。
  • 面部僅在正面觀看時可讀,且需停留約兩秒。
  • 字幕需要深色陰影或輝光,才能在明亮場景中保持可讀性。
  • -x**2 是 JavaScript 語法錯誤;請寫成 -(x**2)。

相關技能