變更記錄片段
明確的使用者指示優先於此工作流程。僅在授權的產品和範例資料上作業。 請勿要求提供密碼、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 外部;網頁片段則使用相鄰的發布文字。
擷取與改編
- 找到一個包含動作及其結果的完整原生卡片或面板。在擷取之前先檢查其原生窄佈局。在 358 px 的觀看寬度下,已變更的標籤、值或結果必須約為 12 px 或更大。如果完整元件無法滿足此要求,請選擇應用程式實際具有的緊湊視圖,或回報限制。切勿為了影片而重繪或重新設定其樣式。
- 複製/改編
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。 - 執行
node scripts/screens.mjs film/plans/capture.json film/captures。對應用程式自己的 CSS/Web 動畫影格使用animate。包含足夠的邊界以容納最大的原生範圍;擷取工具會在動作之前測量區域。對於即時動作,一個簡短的明確duration會記錄證據,並伴隨found: []:立即切換整個擷取。對於擷取工具無法搜尋的 JS 驅動動畫,請提供一個確定性的原生記錄;切勿用淡出或由靜止畫面組合成的動畫來取代。 - 將產品的授權字型複製到
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