Communitygithub.com

changelog-clips

將每個發布的變更製作成簡短的 UI 示範短片,直接來自網頁應用程式的真實畫面。提供獨立的無聲網頁、方形和直式 MP4/WebM 片段、結果海報與可編輯原始檔。

changelog-clips 是什麼?

changelog-clips 是一個專門為 AI 代理(如 Claude Code、Cursor)設計的技能,用於從真實網頁應用程式中,為每個已發布的變更自動生成簡短的 UI 示範短片。這項技能能產出無聲的 MP4/WebM 格式影片(網頁、方形、直式版本)、靜態結果海報,以及可編輯的原始檔,非常適合用於變更記錄媒體、版本說明動畫或單一功能更新片段。它支援多種開發環境,依賴 Node 20+、ffmpeg 和 Chrome,並透過 Puppeteer 捕獲瀏覽器畫面。工作流程會先讀取版本說明並檢查產品,然後撰寫 PRODUCT.md 和 STORY.md 記錄每個片段的細節。接著複製參考檔案、調整捕獲設定 (capture.json)、執行螢幕捕獲與片段建立腳本 (build-clip.mjs),最後透過 render.mjs 和 export-clips.mjs 輸出成品。該技能嚴格要求使用真實產品畫面與資料,禁止發明 UI、使用偽造矩形、文字修補或狀態間交叉淡出。內建校對機制 (critique.md 和 REVIEW.md),確保每個分數不低於 8 分,否則需要修正。預設產出三種尺寸的獨立短片,而非從同一影片裁剪。它非常適合節省手動錄製時間,並確保每次發布都有高品質的視覺媒體。

相容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/omnigami-ai/plugins/tree/main/plugins/omnigami-launch-films/skills/changelog-clips

在你喜歡的 AI 中提問

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

說明文件

變更記錄片段

明確的使用者指示優先於此工作流程。僅在授權的產品和範例資料上作業。 請勿要求提供密碼、API 金鑰、付款資料、政府識別碼、健康記錄或其他敏感資料。 在將缺失的本機相依項目安裝到工作專案之前,請先說明。網路存取僅限於 授權產品及其授權資產,以及已宣告的 npm 相依項目;請遵守存取控制。 一次只渲染一個工作並等待完成。將發布、傳送和部署行為保留在此任務之外。

一個原始面板、一個動作、其保留的結果,然後是宣告的 示範重置。保持攝影機固定,並在整個面板周圍保留均勻的邊距。在開始建置前請先閱讀 style.md,在評判前請先閱讀 critique.md。

輸入與設定

首先閱讀版本說明並檢查運作中的產品。僅收集他們無法提供的內容:要宣布的變更、一個示範 URL 或本機應用程式、安全的範例資料、品牌/字型檔案以及要求的尺寸。第一版涵蓋可見的網頁應用程式變更。保留純 API 的變更,而不是為其發明一個儀表板。請勿僅因為即將推出的預覽功能而宣告某個功能已發布。

檢查 Node 20+、ffmpeg 和 Chrome(scripts/chrome.mjs 或 CHROME_PATH)。在工作專案中安裝 puppeteer-core@^24(它運行在 Node 20 上;更新的主要版本可能需要更新的 Node)。SKILL_DIR 是包含此檔案的文件夾。

mkdir -p changelog-clips
cp -R "$SKILL_DIR/reference" changelog-clips/film
cp -R "$SKILL_DIR/scripts" changelog-clips/scripts
cp -R "$SKILL_DIR/music" changelog-clips/music
cd changelog-clips
npm init -y
npm install -D 'puppeteer-core@^24'

為每個變更建立一個獨立的 film 文件夾;reference 是外觀控制項,而 examples/compare-matching-stays/ 顯示了一個原生清單。在研究其格式後移除複製的擷取畫面,並用此產品的畫面取代。如果存在,請移除複製的 out/ 文件夾。保持每個 film 自包含。在後續版本中,重複使用品牌和未變更的片段;僅重新擷取已變更的動作。

產品與故事

撰寫 PRODUCT.md,記錄實際產品、品牌、資料權限以及每個發布聲明的來源。撰寫 STORY.md,每個片段一個條目:穩定的 ID、發布來源/日期、標題、變更前狀態、可達路由、實際控制項/動作、保留的結果、重置方法、擷取邊界以及預期的播放政策。每個獨立的片段必須在其自己的發布文字旁有意義。請勿將兩個變結合併到一個時間軸中。

使標題與所展示的完成狀態一致:選擇一個重播點並不等於執行一次重播,預覽一個已解析的行程也不等於保存一個行程。當實際結果就是那樣時,才說「選擇...」或「預覽...」;不要借用發布版本更廣泛的聲明來描述一個更狹隘的示範。

在決定一個變更之前,請在實際的觀看尺寸下測量其完整的原生元件和決定性的結果文字。在故事中記錄 CSS 尺寸、文字大小以及最終的 358 px 尺寸。要求兩個片段並不代表存在兩個合適的變更。保留不相容的項目並說明原因;絕不以帶有小字免責聲明的已完成手機/社交片段形式交付。如果存在一個合適的變更,請選擇另一個有確實文件記錄的變更。當要求多種形狀且使用者未指定變更名稱時,請在選擇之前,針對每個要求的形狀測量每個有文件記錄的候選項目,並優先選擇其完整元件能符合所有形狀的項目;僅在無任何項目符合時,才交付一個不完整的系列。如果沒有合適的,請回報產品限制,而不要發明 UI 或降低標準。

一個元件可能僅符合某些形狀。請在 clip.json 的 heldShapes 中宣告每個不支援的形狀及其測量原因(例如 {"4:3":"原生結果在 358 px 時為 10.7 px;下限為 12"})。painter、preflight 和 exporter 將跳過該保留形狀,同時檢查並交付相容的形狀。清單將此標記為 部分;突出報告每個缺失的要求形狀。一個不完整的系列並非通過的三形狀證明。如果每個形狀都被保留,請交付測量結果/報告,而不是影片。

展示該計劃以供審查,除非使用者要求無人值守作業。預設為 1200 × 900 網頁、1080 × 1080 方形和 1080 × 1350 直式。這些是獨立的構圖,而非從同一部影片裁剪而來。一個簡短的靜態發布標題位於社交媒體上的 UI 外部;網頁片段則使用相鄰的發布文字。

擷取與改編

  1. 找到一個包含動作及其結果的完整原生卡片或面板。在擷取之前先檢查其原生窄佈局。在 358 px 的觀看寬度下,已變更的標籤、值或結果必須約為 12 px 或更大。如果完整元件無法滿足此要求,請選擇應用程式實際具有的緊湊視圖,或回報限制。切勿為了影片而重繪或重新設定其樣式。
  2. 複製/改編 film/plans/capture.json 及其 capture-setup.mjs。設定其 URL、視埠、選擇器、範例設定和 inspect 證據。在 rects.before 中記錄 piece 和 target,並在結果出現後再次記錄。擷取整個表面的 before、hover、pressed、changed(仍懸停)和 result(指標已清除)。使用真實的滑鼠按下/釋放,以便應用程式提供其自己的按下效果。在擷取前執行 node scripts/centring.mjs film/plans/capture.json --no-crawl。
  3. 執行 node scripts/screens.mjs film/plans/capture.json film/captures。對應用程式自己的 CSS/Web 動畫影格使用 animate。包含足夠的邊界以容納最大的原生範圍;擷取工具會在動作之前測量區域。對於即時動作,一個簡短的明確 duration 會記錄證據,並伴隨 found: []:立即切換整個擷取。對於擷取工具無法搜尋的 JS 驅動動畫,請提供一個確定性的原生記錄;切勿用淡出或由靜止畫面組合成的動畫來取代。
  4. 將產品的授權字型複製到 film/fonts/,設定 film/clip.json,並執行 node scripts/build-clip.mjs film film/clip.json。選項如下所示。它從 captures/screens.json 推導出整個表面的幾何形狀、游標目標和原生影格繫結,取樣原生背景,寫入 config.js,並對每個形狀執行原生尺寸檢查。失敗則保留該項目:在匯出前停止。在使用每個擷取畫面之前進行審查。提供的參考已經有其設定,因此重新建置它是可選的。
{
  "id": "new-view", "title": "您的發布標題", "kind": "panel",
  "paper": "#F7F4EE", "ink": "#17191F", "groundSource": "您批准的調色盤或取樣應用程式表面",
  "radius": 20, "clearOnExit": true, "primaryTextPx": 24,
  "font": {"family": "ProductSans", "file": "fonts/product.woff2", "weight": "300 900"}
}

primaryTextPx 是測量到的決定性結果文字的原生 CSS 尺寸,而非 film 發明的目標。paper 來自此產品,而非上面的範例。radius 是以 CSS 像素為單位的元件原生圓角半徑。clearOnExit 會保持懸停狀態,直到指標離開真實目標。改編這些欄位以及 config.js 中可選的 timing 物件;保留 film.js 中的固定攝影機、整個表面繪製器。原生動畫影格以其擷取時的 fps 播放。如果動作持續時間較長,請將游標的離開和重置時間往後移,以便動作完成,並且穩定的結果至少能閱讀一秒;參考範例會保留超過四秒的時間。不要截斷實際的處理過程,或將排入佇列的請求描繪成已完成。

將靜止的指標保持在關鍵標籤之外。優先選擇可見的控制項本身作為 rects.target;對於帶有標籤的行,clip.json 可以設定 "targetFraction": [0.72, 0.5] 以選擇該實際點擊區域內的一個清晰點(預設為 [0.5, 0.5])。改編 capture-setup.mjs,以便在按下/釋放之前,將真實滑鼠移動到目標邊界框的相同比例位置。擷取和 film 必須使用相同的點;僅移動繪製的指標會錯誤呈現原生的按下動作。在解碼的電話寬度動作影格中檢查它。

審查與交付

node scripts/render.mjs film --all --check --check-fresh --stress --phone --times key --sheet --review --out film/out
node scripts/export-clips.mjs film

這些交付命令會完成。對於無人值守作業,請等待兩者完成,完成審查,並回報匯出的 film/out/index.html 播放器和媒體路徑。互動式預覽是一個有人值守的編輯工具:node scripts/preview.mjs film 會啟動一個持續運行的伺服器,直到用 Ctrl-C 停止。當有人使用它時,才單獨執行它;切勿將其附加到無人值守的前景交付/檢查命令之後。

export-clips.mjs 會首先檢查每個形狀,並在 film 檢查失敗時拒絕新的影片匯出。然後它會將無聲的 30 fps H.264 MP4、VP9 WebM 和結果 PNG 渲染到 film/out/。其可選的 --poster <seconds> 參數會選擇一個穩定的結果(預設為 3.5)。它會寫入一個本機播放器,包含相鄰上下文、暫停/播放和減少動畫處理。電影的重置是有標籤的;它不是一個無縫的產品循環。將靜態結果海報保留給減少動畫的偏好設定。標籤出現在重置之前,並在結束前保持可見;也請檢查解碼的最後一幀和第一幀。

以每種形狀閱讀每個全尺寸的 UI 變更條、懸停/按下/釋放和重置;在這些事件處檢查解碼的 MP4 影格。使用 critique.md 評分,然後在可能的情況下找一位新的審查者。修正來源並僅重複受影響的檢查。沒有低於 8 分的分數;在兩次失敗的修正回合後,報告剩餘的缺陷,而不是隱藏它。壓力檢查涵蓋繪製的文字,因此請在 358 px 處分別檢查擷取的原生文字。

交付可編輯的 film,包含所有本機擷取/字型與授權、MP4/WebM/海報路徑、發布說明、來源聲明、重新產生命令和包含分數與限制的 REVIEW.md。開啟完成的 MP4 進行審查。目標是讓網頁片段低於 1 MB,同時優先保持可讀性;報告實際位元組數和經過時間。

預設循環是無聲的。music/README.md 解釋了包含的可選歌曲(使用 AI 製作,選取 A 版本)。切勿用合成的配樂來替代。提供的或選擇的歌曲使用內建適配器;保留用於嵌入的無聲匯出。

不變規則

  • 僅使用真實產品擷取和使用者自己的/範例資料。沒有發明的 UI、浮動矩形、文字修補、狀態間的交叉淡出或偽造的處理。
  • 完整的原生封閉區域、均勻的相對邊距、固定比例和攝影機。沒有額外的點擊漣漪或設備模擬。
  • seek(t, values) 僅從參數繪製;ctx.reset() 每個影格,CPU 支援的主/輔助畫布,準備好的本機圖片。繪製器中沒有時鐘、隨機呼叫、計時器或網路。
  • film 中的每個文字都是一個 template.fields 條目。關鍵的原生文字必須能夠獨立於繪製副本的壓力檢查來閱讀。
  • 重置絕不能假裝取消購買、傳送或不可逆的動作。使用明確標記的範例狀態重置,或播放一次並保留真實結果。

Ostlery 是一個為 omnigami 範例虛構的公司。

此技能屬於 omnigami,© 2026 Auberon LLC。您可以將它所產出的內容用於任何用途,包含商業用途,並可變更此技能供您自己使用;請勿重新散布或銷售此技能。 完整條款:LICENSE.md

Individual skills in this repo

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

相關技能