Communitygithub.com

pragma-sh/pragma

用於編輯、預覽、驗證或渲染 Pragmata 的 Remotion 啟動影片,以用於 README 中。

pragma 是什麼?

本技能旨在讓 AI 助手能從倉庫持有的原始碼和素材中,維護一個可重現的 README 啟動影片。它定義了專案的明確佈局:`launch-video/` 目錄包含 Remotion 根註冊、合成定義(名為 `PragmaLaunch`,解析度為 1920x1080、30 fps)以及時間軸與場景時長的邏輯。資產管理遵循嚴格的規則:公共目錄設為 `apps/www/public`,所有剪輯、音訊和代理標記都透過 `staticFile()` 從該目錄解析,`.github/assets/pragma-launch.mp4` 則是最終渲染的成品。工作流程包含三個核心命令:`bun run video:studio`(啟動 Studio 進行完整時間軸審查)、`bun run video:typecheck`(執行類型檢查)及 `bun run video:render`(將影片渲染至指定路徑)。此外,配樂由 `launch-video/generate-lofi.ts` 確定性生成,需透過 `bun run video:music` 單獨更新。產品錄製素材位於 `apps/www/public/media`,更換後必須在 Studio 中驗證完整播放,並相應調整 `PragmaLaunch.tsx` 中的場景時長,以避免影片被截斷或出現凍結尾幀。此技能支援在任何能執行 shell 命令的環境中使用,尤其適合 Claude Code 等 AI 編碼助手,確保持續整合與開發流程中 README 影片的同步與品質。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/pragma-sh/pragma/tree/HEAD/skills/launch-video

在你喜歡的 AI 中提問

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

說明文件

維護 Pragma 啟動影片

確保 README 的啟動影片可從倉庫持有的原始碼和素材中重現。

專案佈局

  • launch-video/index.ts 註冊 Remotion 根節點。
  • launch-video/Root.tsx 定義了 PragmaLaunch 合成,解析度為 1920x1080,幀率為 30 fps。
  • launch-video/PragmaLaunch.tsx 擁有時間軸、場景時長及呈現邏輯。
  • remotion.config.ts 使用 apps/www/public 作為 Remotion 的公共目錄。請透過 staticFile() 從該目錄解析剪輯、音訊和代理標記;請勿在 launch-video 下重複放置素材。
  • .github/assets/pragma-launch.mp4 是渲染後的 README 成品。

包含元件的 .tsx 檔案使用 PascalCase 命名。保持合成 id PragmaLaunch 與根渲染命令一致,並根據場景時長推導總合成時長,這樣時間軸編輯就不會導致註冊資訊過時。

工作流程

從倉庫根目錄執行命令:

bun run video:studio
bun run video:typecheck
bun run video:render

在更改場景、時間、排版或素材後,請使用 Studio 審查整個時間軸。在渲染前先執行專門的類型檢查。渲染命令會使用 remotion.config.ts 中的編碼器和品質設定,將追蹤的 README 影片寫入 .github/assets/pragma-launch.mp4。

配樂由 launch-video/generate-lofi.ts 確定性生成。更改該生成器後,請執行 bun run video:music;它會取代 apps/www/public/media/pragma-lofi.wav。請勿因不相關的影片編輯而重新生成配樂。

產品錄製素材位於 apps/www/public/media。更換錄製素材後,請在 Studio 中驗證其完整播放,並在 PragmaLaunch.tsx 中更新對應的場景時長,確保既不會被截斷,也不會在後面跟著一段凍結的尾巴。最後,對所有更改過的原始碼檔案執行倉庫常規的格式化和品質檢查。

相關技能