本文へスキップ

003 / DESIGN / IGUANA LAB ORIGINAL

Design Preflight

正規化したデザインと実装のデータをオフラインで比較し、レイアウト・タイポグラフィ・色のズレを根拠つきで返します。

FREELAB ORIGINAL

何をするものか

デザインの意図と実装を突き合わせるための道具です。昨日の実装と今日の実装を比べるスクリーンショット回帰とは、目的が違います。

v0.1 には、動作するオフラインの比較エンジンと、ライブ連携の仕様書が入っています。Figma の取得とブラウザ操作は仕様として書かれているだけで、まだ実装されていません。 このページでも、できることとできないことを分けて書いています。

使い方の流れ

  1. 対象の Figma フレームとバージョン、ページ、ビューポート、テーマ、インタラクションの状態を確定する
  2. ノードID と一意なセレクタの対応を明示的に作る。最初に名前が一致したものを黙って選ばない
  3. 正規化したスナップショットを比較する
BASH
node <skill-folder>/scripts/compare.mjs --design <design.json> --actual <actual.json> --json

同梱の例で動きを確かめられます。

BASH
npm run demo

結果の読み方

値が無い、対応していないプロパティ、取得条件が噛み合っていない——これらは WARN のままにします。ゼロで埋めたり PASS と呼んだりしないのが、この Skill の前提です。

FAIL は「測った差が規則の許容値を超えた」という意味であって、製品の欠陥が確定したという意味ではありません。

導入

配布元の掲載内容と照合したコマンドです。実行すると配布元のリポジトリから取得されます。コピーできたことと、導入できたことは別です。実行後に結果を確かめてください。

npx skills add https://github.com/iguanagonzaresu-lab/-skill- --skill design-preflight

必要なもの

  • Node.js 22 以上
  • 正規化済みのデザインデータと実装データ(design.json / actual.json)
  • ノードID と一意なセレクタの対応づけ。data属性のような安定した目印が望ましい

できること

  • 正規化済みのスナップショット同士を、オフラインで決まった規則にしたがって比較する
  • Layout / Typography / Color の3パックで、期待値・実測値・差分・許容値を保持した結果を返す
  • 差異ごとにノードID、セレクタ、視覚上のリスク、調査の方針、検証の手順を示す
  • PASS / WARN / FAIL を件数とカバー範囲つきで報告する

できないこと

配布元の SKILL.md に明記されている範囲外です。

  • v0.1 は Figma を取得しない。アプリの起動、ブラウザ操作、注釈つきスクリーンショットの生成、ピクセル差分を自動で行わない
  • 自動で直さない。対象のファイルを書き換えない。ネットワークを使わない
  • 形状、文言、見た目のスクリーンショット、トークンの同一性、レスポンシブ・モバイル、Safari、Storybook連携、PRコメントは v0.1 の範囲外
  • 寸法のズレから React の props やトークンの結び付けが誤っていると証明することはできない
  • 色が同じに見えることだけを根拠に、デザイントークンの欠落を主張しない
  • ライブ抽出やスクリーンショット確認を求められて実施していない場合、オフラインの結果が PASS でも全体は WARN

安全性について

以下は配布元の記述にある設計方針です。当方で実行して確かめた結果ではありません。導入前にご自身でコードを確認してください。

  • 実行環境のコードを動かさない。対象ファイルを変更しない
  • プラグインの導入、サービスの起動、デザインの変更、フォーム送信、スクリーンショットのアップロードを暗黙に行わない

関連する解説