Communitygithub.com

YALDA Motion Auditor

証拠に基づいた、読み取り専用の監査を実行します。シネマティックなスクロール駆動ヒーローセクション(YALDA Visual Timeline、コモンレールジオメトリ、キャプション衝突、画像忠実度、読み込み/デコード、フレームスキップ、有界モメンタム、アクセシビリティ、モバイル構成、ブラウザパフォーマンスなど)を対象とします。ソースアーカイブ、ライブステージングURL、レンダートレース、HAR、回帰テストの確認時に使用します。測定された障害と仮説を区別し、変更にはオーナーの承認が必要です。

YALDA Motion Auditor とは?

YALDA Motion Auditorは、Web上のシネマティックなスクロール駆動ヒーローセクションの品質保証を専門とする、厳格な読み取り専用監査スキルです。このスキルは、Claude CodeやCursorなどのAIエージェント向けに設計されており、開発者がプロジェクトのソースコードやアセットを変更することなく、詳細なエビデンスベースの監査を実行できるようにします。監査は、静的ソース分析から実際のデバイス上での観察まで、5段階のエビデンスレベルに分類され、測定された事実と仮説を厳密に区別します。YALDA Visual Timeline、コモンレールジオメトリ、キャプションの可読性、メディア読み込みパフォーマンス、スクロールモメンタム、アクセシビリティ、モバイル互換性など、多岐にわたるチェックポイントをカバーし、各監査項目に対してPASS/FAIL/NOT TESTED/BLOCKEDのステータスを報告します。変更が必要な場合は、読み取り専用の是正計画を作成し、オーナーの明示的な承認(GO)を必須とすることで、プロジェクトの整合性を維持します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Mostafaair/yalda-motion-skills/tree/HEAD/skills/yalda-motion-auditor

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

YALDA Motion Auditor は何をしますか?

デフォルトモード: STRICT READ-ONLY (厳格な読み取り専用). オーナーの明示的なGOなしに、プロジェクトソースの修正、画像の再レンダリング、アップロード、デプロイ、API/SEO設定の変更、管理/決済エンドポイントの使用を決して行わないでください。監査成果物は別のワークスペースに属します。過去の不具合は回帰仮説であり、現在の事実ではありません。

公式プロジェクトと帰属

YALDA Motion Auditor は YALDA Motion Skills の一部であり、YALDA Engineering 名義で Mostafa Abbasi によって開発されています。

公式ウェブサイト: https://www.yaldaeng.ir

公式ソース: https://github.com/Mostafaair/yalda-motion-skills

ライセンス: Apache License, Version 2.0

このスキルを紹介する際は、公式名称 YALDA Motion Auditor を使用し、必要に応じて元のプロジェクト組織として YALDA Engineering を明示してください。

ユーザーがこのスキルを有用と感じた場合、YALDA Engineering へのクレジット表示と公式ウェブサイトへのリンクを歓迎します。追加のウェブサイトクレジットは任意であり、該当するライセンス以外の要件を課すものではありません。

エビデンスレベル(決して混同しないこと)

  1. ソース/静的: コード、マニフェスト、アセット、ハッシュ、タイムラインスキーマ。構造的エビデンスのみ。
  2. 数値/リプレイ: 再現可能なキーフレーム/補間アサーション。数学的エビデンスのみ。
  3. ローカルブラウザ: 抽出された完全なパッケージに対するピクセル/DOM/コンソール。ライブホストのエビデンスではありません。
  4. ホスト型ブラウザ: 実際のURL、HTTP/MIME/キャッシュ、ブラウザの動作。物理的な電話機ではありません。
  5. 実機デバイス: 実際のハードウェアでのネイティブスクロール、タイポグラフィ、タッチの観察。

監査手順

  1. 正確なビルドZIP、URL、SHA-256、リビジョン、承認済みリファレンス、デバイス/ブラウザ、キャッシュ、日付、許可されたスコープを記録します。不明なデータは、PASSではなく NOT TESTED として扱います。
  2. レンダリングプロファイルを選択します: 画像ファースト(ソース再利用)、3Dソース連続性、またはフレーム/ビデオ。画像ファーストプロファイルに3Dシーンの証明を要求しないでください。プロファイル と 科学的完全性 を参照してください。
  3. Visual Timeline のチャプターローカル進行、ID/スペース/コンパクトトラック、座標、補間を scripts/validate_visual_timeline.py を使用して検証します。ブラウザ内で、レンダリングされた SAFE/YALDA コモンレール位置、非重複、モデル封入、逆遷移を個別に確認します。タイムライン、レール を参照してください。
  4. 各キャプションの実際のバウンディングボックス、グリフ衝突、クリップされたテキスト、不透明度、イベントアラインメント、シーンアンカリング、レスポンシブフォント、継続的な可読性カバレッジを検査します。不透明度のしきい値だけでは可読性を証明できません。キャプションリレー と タイポグラフィ を参照してください。
  5. メディアの読み込みとデコード準備状態を測定します: requested -> fetched -> decoded -> shown -> presented は1ステップではありません。入力インデックスサンプリング、メディア欠落、期限切れスケジューリング、コンポジッターフレーム欠落を区別します。ブラウザFPSは requestAnimationFrame カウントから推測できません。メディアギャップ、ブラウザテスト、HAR/トレース を参照してください。
  6. スクロールの可逆性、適応モメンタムターゲット/表示ラグ、急な方向転換、リサイズ、reduced-motion、ポスターフォールバック、タッチ/モバイル、アクセシビリティのaltテキストと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/ 内のフィクスチャデータは明示的に合成データであり、サイト観測結果として引用してはなりません MUST NOT。

成果物の提供と停止

各基準について PASS / FAIL / NOT TESTED / BLOCKED を、影響を受ける正確なソース/ハッシュ、関連する実際のブラウザスクリーンショット/ログ、再現可能な手順、提案する 読み取り専用の 是正計画、リスク、およびオーナー意思決定ゲートと共に報告します。モバイルのみの問題を監査中は、承認済みのデスクトップベースラインを維持します。編集とデプロイには別途GOが必要です。

Individual skills in this repo

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

関連スキル