003 / DESIGN / IGUANA LAB ORIGINAL
Design Preflight
正規化したデザインと実装のデータをオフラインで比較し、レイアウト・タイポグラフィ・色のズレを根拠つきで返します。
FREELAB ORIGINAL
何をするものか
デザインの意図と実装を突き合わせるための道具です。昨日の実装と今日の実装を比べるスクリーンショット回帰とは、目的が違います。
v0.1 には、動作するオフラインの比較エンジンと、ライブ連携の仕様書が入っています。Figma の取得とブラウザ操作は仕様として書かれているだけで、まだ実装されていません。 このページでも、できることとできないことを分けて書いています。
使い方の流れ
- 対象の Figma フレームとバージョン、ページ、ビューポート、テーマ、インタラクションの状態を確定する
- ノードID と一意なセレクタの対応を明示的に作る。最初に名前が一致したものを黙って選ばない
- 正規化したスナップショットを比較する
node <skill-folder>/scripts/compare.mjs --design <design.json> --actual <actual.json> --json同梱の例で動きを確かめられます。
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
安全性について
以下は配布元の記述にある設計方針です。当方で実行して確かめた結果ではありません。導入前にご自身でコードを確認してください。
- 実行環境のコードを動かさない。対象ファイルを変更しない
- プラグインの導入、サービスの起動、デザインの変更、フォーム送信、スクリーンショットのアップロードを暗黙に行わない
