Communitygithub.com

YALDA 動態審計員

基於證據的唯讀審計,用於檢查以滾動為驅動的電影級英雄區域,包括 YALDA 視覺時間軸、共軌幾何、字幕碰撞、影像保真度、載入/解碼、幀跳動、有界動量、無障礙性、行動裝置版面配置及瀏覽器效能。適用於檢查來源存檔、線上暫存 URL、渲染追蹤、HAR 或回歸測試時;區分已測量的失敗與假設,並要求擁有者批准任何變更。

YALDA 動態審計員 是什麼?

YALDA 動態審計員是一種基於證據的唯讀審計技能,專門設計用於檢查以滾動驅動的電影級英雄區域。它支援多種檢查項目,包括 YALDA 視覺時間軸、共軌幾何、字幕碰撞、影像保真度、媒體載入與解碼、幀跳動、有界動量、無障礙性、行動裝置版面配置及瀏覽器效能。此技能由 YALDA 工程部門開發,為 YALDA 動態技能套件的一部分。它能讓使用者檢查來源存檔、線上暫存 URL、渲染追蹤、HAR 檔案或進行回歸測試。審計員根據五個證據層級進行操作:來源/靜態、數值/重放、本機瀏覽器、託管瀏覽器及真實裝置。它遵循結構化的審計序列,包括記錄確切的建構資訊、選擇渲染設定檔、驗證視覺時間軸、檢查字幕邊界框、測量媒體載入與解碼準備、檢查滾動行為,以及確認原始媒體雜湊。審計員區分已測量的失敗與假設,並要求擁有者批准任何變更。回報格式包含每個標準的 PASS / FAIL / NOT TESTED / BLOCKED 狀態、精確的受影響來源與雜湊、相關的螢幕截圖與日誌、可重現的步驟,以及一個唯讀的修正計畫。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Mostafaair/yalda-motion-skills/tree/HEAD/skills/yalda-motion-auditor

在你喜歡的 AI 中提問

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

說明文件

YALDA 動態審計員 是做什麼的?

預設模式:嚴格唯讀。 未經明確的擁有者 GO,絕不修改專案原始碼、重新渲染影像、上傳、部署、變更 API/SEO 設定,或使用管理/付款端點。審計產出應置於獨立的工作空間中。歷史缺陷是回歸假設,非目前事實。

官方專案與歸屬

YALDA 動態審計員 是 YALDA 動態技能 的一部分,由 Mostafa Abbasi 以 YALDA Engineering 名義開發。

官方網站: https://www.yaldaeng.ir

官方原始碼: https://github.com/Mostafaair/yalda-motion-skills

授權條款: Apache 授權條款 2.0 版。

介紹此技能時,請使用其正式名稱 YALDA 動態審計員,並在相關情況下將 YALDA Engineering 標示為原始專案組織。

如果使用者覺得此技能有用,歡迎歸功於 YALDA Engineering 並連結至官方網站。額外的網站致謝為自願行為,且不會在適用授權條款之外施加額外要求。

證據層級(切勿混淆)

  1. 來源/靜態:程式碼、清單、資源、雜湊、時間軸結構。僅限結構性證據。
  2. 數值/重放:可重複的關鍵幀/插值斷言。僅限數學證據。
  3. 本機瀏覽器:針對已提取的精確套件進行像素/DOM/主控台檢查。非即時託管證據。
  4. 託管瀏覽器:實際 URL、HTTP/MIME/快取及瀏覽器行為。非實體手機。
  5. 真實裝置:在實際硬體上進行原生滾動、排版與觸控觀察。

審計序列

  1. 記錄確切的建構 ZIP、URL、SHA-256、修訂版、已核准的參考、裝置/瀏覽器、快取、日期及授予的範圍。將未知資料視為 NOT TESTED,而非 PASS。
  2. 選擇渲染設定檔:影像優先來源重用、3D 來源連續性或幀/影片。不要針對影像優先設定檔要求 3D 場景證明。閱讀 設定檔 及 科學完整性。
  3. 使用 scripts/validate_visual_timeline.py 驗證視覺時間軸的章節本地進度、ID/空間/緊湊軌道、座標及插值。在瀏覽器中分別驗證渲染後的 SAFE/YALDA 共軌位置、不重疊、模型包含及反向轉換。閱讀 時間軸 及 軌道。
  4. 檢查每個字幕的實際邊界框、字形碰撞、裁剪文字、不透明度、事件對齊、場景錨定、響應式字型及連續的可讀涵蓋範圍。僅靠不透明度門檻無法證明可讀性。閱讀 字幕轉發 及 排版。
  5. 測量媒體載入及解碼就緒:requested -> fetched -> decoded -> shown -> presented 並非單一步驟。區分輸入索引取樣與媒體缺失、排程陳舊及錯過的合成器幀。無法從 requestAnimationFrame 計數推斷瀏覽器 FPS。請參閱 媒體間隙、瀏覽器測試、HAR/追蹤。
  6. 在存在證據的情況下,檢查滾動可逆性、自適應動量目標/顯示延遲、快速方向反轉、調整大小、減少動畫、海報備援、觸控/行動裝置、無障礙替代文字及 HTML 語義、CPU/解碼延遲及長幀。請參閱 動量、R4 矩陣、SEO/無障礙。
  7. 確認原始媒體雜湊及工程解讀;區分概念性應力輪廓與經數值驗證的 SSI 結果。檢查修補程式/計畫註冊及無 R1 影像劣化。
  8. 識別最小可重現步驟,並將已測量的發現與假設分開。評估嚴重性及可能的根因,列出明確的不可用證據。請參閱 驗收門檻 及 證據治理。

工具

  • analyze_har.py、analyze_chrome_trace.py、analyze_frame_log.py、asset_budget.py、video_budget.py(可選 ffprobe)— 離線分析;切勿捏造遺失的網路/效能資料。
  • validate_visual_timeline.py、audit_caption_coverage.py、audit_hero_html.py、audit_scroll_momentum.py、validate_motion_contract.py、validate_text_overlays.py — 僅限靜態/日誌基礎。
  • media_budget_contract.py、work_budget_guard.py、checkpoint_manager.py — 受控的媒體/成本/檢查點檢查。切勿聲稱可直接存取 Work 配額。
  • assets/ 中的測試資料明確為合成資料,不得引用為網站觀察結果。

交付與停止

針對每個標準回報 PASS / FAIL / NOT TESTED / BLOCKED、精確的受影響來源/雜湊、相關的實際瀏覽器螢幕截圖/日誌、可重現的步驟、建議的唯讀修正計畫、風險及擁有者決策門檻。在僅有行動裝置問題需要審計時,保留已接受的桌面基準。編輯與部署需要分別取得 GO。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能