Communitygithub.com

oyi77/1ai-skills

將每週更新日誌 .md 轉換為使用 HyperFrames 完成的品牌化變更日誌影片。當使用者提供變更日誌/摘要 Markdown 並希望產出每週影片,或說出「變更日誌影片」時使用。自包含 — 字型、背景、詞彙表和腳本均隨技能提供。產出 1080 平方、約 45-60 秒的影片,包含動畫品牌模擬 UI。

1ai-skills 是什麼?

此技能將產品發行變更日誌轉換為精緻的影片作品,利用 HyperFrames HTML 渲染引擎生成 MP4。它專為希望以視覺化方式公告功能更新、效能改進與可靠性修復的產品團隊設計,可自動解析 Markdown 結構中的主題與項目,並將其路由至視覺化註冊表中的適當動畫模擬 UI。技能支援 Claude Code / Cursor 等 AI 代理平台,透過內建腳本產生語音旁白(HeyGen TTS)、逐字時間戳記與字幕軌,並強制執行一系列品質關卡(hyperframes check、seam-gate verify)以確保零錯誤輸出。所有品牌資產(字型、背景影片、背景音樂)均隨技能打包,開發者只需提供變更日誌即可獲得約 45-60 秒的完整影片,從而節省大量手動影片編輯工作。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/oyi77/1ai-skills/tree/HEAD/content/hyperframes-changelog-video

在你喜歡的 AI 中提問

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

說明文件

概覽

此技能將發行變更日誌轉換為使用 HyperFrames HTML 渲染的拋光影片作品。當產品更新需要視覺化公告時使用 — 包含英雄框架、關鍵要點標註和背景圖案。它會根據您提供的變更日誌項目產出 MP4 檔案。

HyperFrames — 變更日誌影片

輸入:變更日誌 .md(主題 + 項目)。輸出:經過 lint 清理、符合 seam-gate-green 標準的 HyperFrames 專案。僅在被要求時才進行渲染。

使用時機

  • 使用者提供變更日誌/摘要 Markdown 並希望產出每週影片
  • 使用者說出 "changelog video" 或 "weekly digest video"
  • 使用者想要一個品牌化影片,包含動畫模擬 UI 和旁白

不應使用的情境

  • 使用者想要產品發布影片(使用 hyperframes-product-launch-video)
  • 使用者想要動態圖形(使用 hyperframes-motion-graphics)
  • 使用者想要講話人頭影片(使用 hyperframes-embedded-captions)

首要原則:可視化,不要列出

每個主題都應以實際 UI 的動畫模擬或忠實類比來說明體驗的變化 — 絕不使用文字要點。在撰寫腳本之前,先將每個主題/項目路由至視覺化註冊表中的對應項目。

工作流程

0 · 從技能資產引導(非協商)

mkdir -p project/assets/fonts
cp <SKILL_DIR>/assets/fonts/*.woff2 project/assets/fonts/
cp <SKILL_DIR>/assets/bgm.mp3 project/bgm.mp3
ffmpeg -y -stream_loop 15 -i <SKILL_DIR>/assets/bg-pattern.mp4 -t <TOTAL> \
  -vf "scale=1080:1080,fps=30,eq=saturation=0.72,[email protected]:t=fill" \
  -an -c:v libx264 -crf 20 -pix_fmt yuv420p project/assets/bg-pattern-<TOTAL>s.mp4
cp <SKILL_DIR>/examples/master-skeleton.html project/index.html

然後完整閱讀 references/build-spec.md — 它定義了品牌標記。

1 · 解析 + 編輯剪裁

  • 提取:週範圍、標題統計、主題、項目
  • 時間預算:總共 45-60 秒。 標題 ≤2 秒,片尾 ≤3.5 秒,4 個主題各約 9-12 秒
  • 每個主題保留一個英雄視覺化 + 最多 3 個口頭項目
  • 按故事順序排列主題:旗艦功能 → 產品表面 → 效能 → 可靠性

2 · 視覺化路由

對於每個主題,從視覺化註冊表中選擇表面,並撰寫一行:theme → surface → mock 執行的 2-4 個序列動作,每個動作都與腳本短語相關聯。

3 · 雙層腳本(口頭 vs 顯示)

將腳本撰寫為 token 行:對話式的語氣,每個技術術語攜帶一個 spoken 語音形式,而 display 保持標準拼寫。字幕顯示 display;旁白朗讀 spoken。

4 · 旁白 + 單字時間戳記

node scripts/heygen-tts.mjs ./vo-spoken.txt -o voiceover.mp3 --words vo-words.json --voice <voice_id>
node scripts/align-captions.mjs --tokens script-tokens.json --words vo-words.json --out captions.json

單字時間是硬性關卡。 在繼續之前,確認 vo-words.json 非空,並包含一個帶有每個單字 start/end 的 words: [...] 陣列。

5 · 構建

嚴格遵循 references/build-spec.md:品牌標記 + 字型 + 動畫背景編碼 + 場景骨架 + chrome + 字幕軌。然後按照順序:向量帳本 → seam-stamp → 依據旁白單字的內部節拍 → seam-gate 驗證。

字幕不是可選項。 在繼續之前,先從 captions.json 填入 LINES 陣列。

6 · 關卡(全部綠燈方可呈現)

  1. hyperframes check — 0 錯誤
  2. seam-gate.mjs verify — 0 失敗
  3. 重新啟動預覽伺服器,抽查 3-4 個節拍
  4. 除非使用者要求,否則不要渲染
  5. 字幕存在關卡 — 抽樣 3-4 幀,確認字幕軌可見

反合理化表格

合理化現實
"UI 變更使用要點投影片"以模擬表面展現變更的運作方式
"對於無法呈現的項目使用假 UI"誠實的檢查清單場景
"TTS 文字中使用純 'JSON'"詞彙表口頭形式;顯示保持標準
"猜測發音"詢問,然後擴充詞彙表
"念出所有變更日誌項目"每個主題 ≤3 項;摘要連結承載其餘內容
"到處使用綠色點綴"每個場景只有一個綠色時刻
"從先前影片的 index.html 開始"始終複製 master-skeleton.html
"空的 LINES 陣列沒問題"空的 LINES = 沒有字幕的成品 = 重新執行

驗證

  • hyperframes check 通過,0 錯誤
  • seam-gate.mjs verify 通過,0 失敗
  • 在 3 個以上抽樣幀中字幕軌可見
  • 單字時間戳記與音訊對齊
  • 品牌標記與 build-spec.md 相符
  • 僅在使用者明確要求時才渲染

Individual skills in this repo

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

oyi77/1ai-skills

The transition technique catalog for HyperFrames videos — five velocity-matched SEAMS (zoom-through, inverse zoom-through, cut-the-curve, waterfall cut, rack-focus blur-cut) plus in-scene techniques (waterfall entry, nudge curve). Covers partial-travel velocity matching, Z scale-sign rule, size-scaled blur, the 10/65/25 slide ratio, and the 2-3 transition budget. Read before authoring any transition, text-beat handoff, or kinetic text entry.

oyi77/1ai-skills

Add captions/subtitles to talking-head or launch videos using HyperFrames. Use when the user wants embedded captions, verbatim caption rails, or cinematic text behind the subject. Covers the drop/rail/embed caption model, the overlay law (captions are NOT a reserved band), matte occlusion for embedded climaxes, and word-timestamp alignment from TTS output.

oyi77/1ai-skills

Turn arbitrary text — an article, notes, a topic, a brief — into a faceless explainer video using HyperFrames. Use when the user wants a topic explainer, concept breakdown, how-to, or listicle with no product/website to capture. Every visual is invented per scene (typography, abstract graphics, diagrams, data-viz). Not a video built from a website (use hyperframes-product-launch-video).

oyi77/1ai-skills

The fallback HyperFrames workflow for anything that doesn't fit other skills — longer multi-scene pieces, brand/sizzle reels, title cards, static loops, freeform compositions. Input- and length-agnostic. Also the home of companion mode (co-create with the full toolbox). Use when no other HyperFrames skill matches, or when the user wants a freeform video.

oyi77/1ai-skills

Create short, unnarrated, design-led motion graphics (~under 10s) using HyperFrames. Use when the user wants kinetic type, stat/chart hits, logo stings, lower-thirds, animated tweets/headlines, or transparent overlay motion graphics. MP4 or transparent overlay output. Teaches seek-safe keyframe authoring and the 2-3 transition budget rule.

oyi77/1ai-skills

Turn a music track into a beat-synced HyperFrames video — lyric, slideshow, or kinetic promo. Use when the user provides an audio file, a video to pull audio from, or a mood brief for generated music. Music drives pacing. Teaches beat-map extraction, section-based scene planning, and audio-reactive visuals.

oyi77/1ai-skills

Create product launch videos from a URL, brief, or script using HyperFrames (HTML→MP4). Use when the user wants a product launch video, site tour, social clip featuring a product's own visuals, or marketing/promoting a product. Up to ~3 min (sweet spot 30-90s). Teaches the HyperFrames production loop: plan → write HTML → wire seekable animations → add media → lint → preview → render.

oyi77/1ai-skills

The Video Production Manager — manages ALL video production under 1ai-content. Delegates to HyperFrames, Remotion, AI video, and FFmpeg based on the task. Has memory via 1ai-hub brain, follows 1ai-rules, and reports to Content Director. Use when the user says 'make a video', 'create video', 'edit video', 'video strategy', or needs any video production work.

oyi77/1ai-skills

Agent skill at content/video/gen/SKILL.md

oyi77/1ai-skills

Use when track portfolio company KPIs, variances, returns analysis. Use when user says "monitor portfolio", "track KPIs", "portfolio returns".

oyi77/1ai-skills

Use when go-to-market planning — launch sequencing, channel strategy, audience building, PR outreach. Use when planning product launches, building launch checklists, or coordinating multi-channel campaigns.

oyi77/1ai-skills

Use when portfolio manager — capital allocation, risk management, and performance metrics tracking for trading strategies.

相關技能