Communitygithub.com

omd:feel — インターフェースのフィーリングを数値化

デザインやフロントエンド業界で「感覚」に頼っていたインターフェースの細部を、数値化されたルールとして適用(APPLY)または監査(AUDIT)するスキル。Jakub Krehelの哲学を継承し、HIG/Material/WCAG/DSトークン/実務者調査で拡張した17軸・113ルール(出典グレード付き)。モーションタイミング、イージング、同心円半径、tabular-nums、44pxターゲット、フォーカスリング、prefers-reduced-motionなどをカバー。

omd:feel — インターフェースのフィーリングを数値化 とは?

omd:feel は、UIの「フィーリング」を定量化し、チェック可能な数値ルールとして適用・監査するためのAIエージェントスキルです。Jakub Krehel の「優れたインターフェースは小さな要素の積み重ね」という哲学を土台に、W3C/WCAG、HIG、Material Design、デザインシステムトークン、実務者調査から導出された17軸・113のルールを、出典グレード(SPEC/DS/CONV/OP/FOLK)付きで提供します。ルールはAPPLY(新規UI作成・改修時のルール注入)とAUDIT(既存UIのスコアリングとレポート生成)の2つのワークフローで利用可能。例えば「フィーリングを良くして」「インタラクションを磨いて」「フィーリングチェック」「make this feel better」「polish the interactions」「インターフェースの細部を詰めて」「介面細節打磨」といった自然言語のトリガーに反応します。プロジェクトルートにDESIGN.mdがある場合、そのブランドトークンが最優先され、ルールはブランドが沈黙している軸のみを補完します。

対応~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/nococn/omd-feel/tree/HEAD

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

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

ドキュメント

omd:feel — インターフェースのフィーリングを数値化 は何をしますか?

業界が感覚(かんかく)で決めていたインターフェースの細部 — 「このくらいの速度」「このくらいの影」「このくらいの余白」 — を出典グレード付きでチェック可能な数値に置き換え、適用・監査するスキル。Jakub Krehel の "great interfaces are a collection of small things that compound" の命題を継承しつつ、どの数値に合わせるべきか/いつ間違っているかまで数値で答える。

核となる洞察: 品質とは、数十の小さな制約をそれぞれの許容範囲内に収めた積分である。600msのチェックボックスのチック、1pxのフォーカスリング、本文2.85:1のコントラスト、@media (hover:hover) ゲートなしのホバーリフト — ひとつひとつが「フィーリング」において測定可能な減点となる。このスキルはその減点を防ぐ。

全ルール(17軸・113個)は reference.md に、各数値の出典・tier・方法論は provenance.md にある。以下のチートシートは常に読み込まれる核であり、深い監査やエッジケースは reference を参照すること。

いつ使うか

  • APPLY — UIを新規作成・修正する際に、定量的フィーリングルールを注入する (「フィーリングよくして」「インタラクション磨いて」「細部適用」)
  • AUDIT — 既存のHTML/JSX/TSX/CSSをルール表と照合し、フィーリングスコア + BLOCK/WARN/FYI レポートを生成する (「フィーリングチェック」「この画面を監査して」)

UI作業でなければトリガーしない。コピー・情報構造のみの作業は対象外。

0. 出典グレード → 強制力 (このスキルの心臓)

すべてのルールは tier を持ち、tierが強制力を決める。これこそが「感覚を正直に数値化する」方法 — 仕様の数値はゲート、好みの数値は提案。

バッジTierAPPLYAUDIT severity
🟢 SPECspec-authoritative (W3C/WCAG・HIG・normative)強制BLOCK
🟢 DSds-token (コミットされたデザインシステムトークン)強制 (ブランドが上書きしない場合)BLOCK
🟡 CONVindustry-convention (独立した実務者≥2の収束)デフォルト値として適用WARN
⚪ OPsingle-opinion (信頼できる単独意見)提案のみFYI
⚪ FOLKfolklore-unverified (根拠追跡不能)提案 + tier明示FYI

分布: SPEC 61 · DS 24 · CONV 19 · OP 7 · FOLK 2 → 85/113 が spec・token 根拠(強制可能)。

DESIGN.md が常に優先される。 ブランドの DESIGN.md トークンがルールと競合する場合、ブランドトークンが権威を持つ。これらのルールはブランドが沈黙している場合のデフォルトであり、オーバーライドではない。プロジェクトルートに DESIGN.md があれば、omd:apply でまずトークンを読み、空の軸だけを feel ルールで埋める。

1. チートシート — 常に適用する核となる数値

tier 表記: 🟢=強制, 🟡=デフォルト, ⚪=提案。競合時は DESIGN.md > 🟢 > 🟡 > ⚪。

Motion & Timing

  • 日常UIのトランジション ~200ms (hover ≤150 · popover ~200 · overlay/modal ~300)。範囲150–300ms、>400ms = もっさり見える。🟡
  • durationは50msグリッドに量子化 (220/333ms禁止)。🟢
  • exit ≈ 0.8 × enter (開くときより閉じるときを速く)。🟢
  • 単一のグローバルduration禁止 — 移動面積/距離に比例させる。🟢

Easing & Springs

  • enter/ユーザートリガー = ease-out cubic-bezier(0,0,0.2,1) · exit = ease-in/accelerate · 既に見えているmorph = ease-in-out · スピナー/progress = linear。enterにease-in禁止。🟡
  • Apple = spring デフォルト (response 0.55, damping 0.825, bounce 0)、機能的なUIでは bounce <0.4。🟢
  • interruptible: インタラクティブ状態は transition/spring (再ターゲット可能)、ワンショット演出のみ @keyframes。🟢

Spacing · Radius · Rhythm

  • 8px base, 4px half-step (4·8·12·16·24·32·40·48·64)。🟢
  • 内側 padding ≤ 兄弟間の外部 gap。🟡
  • 同心円半径: outer = inner + padding。🟢
  • UIタイプスケール ~1.25(major third)。🟡

Shadow & Depth

  • レイヤードシャドウ 3–5層、光源は上方1つ。低高度=tight+sharp、高高度=diffuse+spread (Tailwind md→lg ランプ)。🟡/DS
  • ダークモードは影より明るい表面で深度を表現する。🟡

Typography

  • 本文 line-height 1.5、measure ~66ch (45–75)。🟢
  • display tracking −0.02~−0.03em、all-caps +0.05~0.1em、本文 ~0。🟡
  • 変化する数字には tabular-nums; 見出し text-wrap: balance、本文 pretty; レイアウトに antialiased。(seed/jakub) 🟡

Color & Contrast

  • テキスト 4.5:1(large 3:1) AA · 非テキスト/UI境界 3:1 · フォーカスリング 3:1 + 2px + ~2px offset。🟢
  • M3 state layer: hover 8% · focus 10% · pressed 10% · dragged 16%。🟢
  • disabled ~38% opacity。🟡

States & Feedback

  • データコンポーネントは5状態(empty/loading/error/content/skeleton)すべて定義。🟡
  • pressed: scale 0.96–0.97、150ms ease-out (下限 0.95)。DS/⚪
  • アイコン状態スワップ: scale+opacity+blur 4px→0、spring ~0.3。🟡

Targets & Pointer

  • タップターゲット 44pt(iOS/WCAG AAA) / 48dp(Material) / 24px(WCAG AA最小)、隣接ターゲット間 ≥8pt。🟢
  • cursor: インタラクティブ=pointer · 無効=not-allowed · ドラッグ=grab→grabbing · 編集=text。🟡

Scroll & Gesture

  • オーバーレイ/ネストスクローラーに overscroll-behavior: contain (スクロールチェーン・PTRをブロック)。🟢
  • スワイプ解除しきい値 ~30%距離またはvelocity flick。DS
  • scroll-snap: 長尺フォーム=proximity · カルーセル=mandatory。🟢

Response Time & Perceived Perf

  • 100ms = 即時 · 1s = 思考フローの限界 · 10s = 注意限界(% progress表示)。Doherty 400ms 天井。🟢
  • INP ≤200ms p75、フレーム予算 16.6ms。🟢
  • スピナーは予想待機 >1sの場合のみ; 表示したら最低500ms維持(点滅禁止)。レイアウトが分かっている場合は skeleton。🟡/DS

Layout Stability (CLS)

  • CLS ≤0.1 p75。メディアは width/height または aspect-ratio で予約。scrollbar-gutter: stable。font-display: optional(または swap)+metric override。入力500msウィンドウ外でコンテンツ上部への挿入禁止。🟢

Modals · Overlays · Z-index

  • role=dialog + aria-modal=true、開くときにダイアログへフォーカス、Tab trap、Escで閉じる、閉じる際にトリガーへフォーカス復元、背景 inert。scrim #000 ~32%。🟢
  • light-dismiss: 一時的/情報ダイアログはON、データ入力・破壊的アクションはOFF。🟢
  • z 階段: dropdown 1000 / sticky 1100 / fixed 1200 / backdrop 1300 / modal 1400 / popover 1500 / toast 1600 / tooltip 1700。オーバーレイはportal。(gap-fill)

Performance · Glass · A11y

  • アニメーションは transform/opacity(+filter)のみ、transition: all 禁止; will-change は transient (アイドル時に削除)。🟢
  • glass: backdrop-filter: blur(16px) saturate(180%) + 半透明 fill ~0.6 + 1px hairline + 不透明 fallback、テキスト ≥4.5:1。🟡/🟢
  • prefers-reduced-motion: reduce → cross-fade/即時遷移、大きな移動・parallax削除(小さなopacityは維持)。≤3 flashes/s。フォーカスアウトラインを代替なしで削除禁止(:focus-visible)。🟢

Form Validation

  • 一次検証は blur時、一度エラーになったフィールドは on-change(ライブ) に切り替え(修正即エラー解除)。非同期検証 debounce 300–500ms。🟡

2. APPLY ワークフロー

  1. コンテキスト検出 — プロジェクトルート/対象フォルダに DESIGN.md があるか? あれば omd:apply 手順でトークン(色・radius・spacing・motion・type)を先に読み込む。ブランドトークン = 権威。
  2. 空の軸を埋める — DESIGN.md が沈黙している軸のみ、チートシートのデフォルト値で埋める。深い軸(スクロール物理・glass・z階段・CLS)は reference.md の該当セクションを参照。
  3. tierを尊重 — 🟢はそのまま適用、🟡はデフォルト値(ブランド/リクエストが上書きすれば譲る)、⚪/FOLKは 「これは好みのヒューリスティックです」と明示して提案のみ。
  4. 出力に根拠を残す — 非自明な数値(例: exit 0.8×、focus offset 2px)は、なぜなのか + tier をコードコメントや説明に1行で残す。数値を発明しないこと — チートシート/referenceに無ければ reference を読むか、わからないと言う。
  5. prefers-reduced-motion は常に 付随 — モーションを入れたら reduce 分岐も一緒に入れる (A11yはオプションではない)。

3. AUDIT ワークフロー

omd:designer-review と同様の advisory (読み取り専用) パターン + feel 軸。呼び出し毎に DESIGN.md を再読み込み (キャッシュ禁止)。

  1. 入力: artifact_path(HTML/JSX/TSX/CSS) + (あれば) design_md_path + viewport。
  2. machine_check スキャン — reference.md の各ルール 🔍 machine_check を artifact に適用。例:
    • transition: all / >400ms duration / off-grid duration → 検出
    • タップターゲット <44px、フォーカスアウトライン削除、テキストコントラスト <4.5:1
    • aspect-ratio なしの <img>、aria-modal なしの modal、overscroll-behavior なしのオーバーレイ
  3. severity = tier マッピング — SPEC/DS 違反 = BLOCK、CONV = WARN、OP/FOLK = FYI。(severity inflation/deflation 禁止)
  4. feel-score — 適用可能な軸のうち in-band 比率: 🟢 in-band / 🟢 applicable をコア数値とし、WARN/FYI は補足。"feel-score 18/22 SPEC in-band, BLOCK 2, WARN 5"。
  5. 出力: <work_dir>/.reviews/feel-audit-round-<N>.md — issue毎に line ref + tier + machine_check 根拠 + fix(アクション可能)。line ref なしの issue・"looks good" rubber-stamp 禁止。
### [BLOCK] タップターゲット最小値未満 — アイコンボタン
- **場所:** `components/Toolbar.tsx:31`
- **ルール:** §8 Targets — 44pt/48dp/24px 最小 (🟢 SPEC, WCAG 2.5.8)
- **根拠:** `<button className="w-6 h-6">` → 24px、hit-slop なし
- **修正:** パディングで 44×44 のヒット領域を確保 (`p-2.5` + 視覚 24px アイコン維持)

4. ガードレール

  • ❌ folklore を spec のように提示禁止。 ⚪/FOLK は常に tier を明示する。 (corpus Appendix B の降格リスト — Hick-Hyman 0.155s/bit, Fitts ms/bit, rubberband 0.7, pressed 0.95 下限, exit 0.8×, stagger 80/100ms, optical 2px など — は数値ゲートとして強制せず、方向のみ借用。)
  • ❌ 数値の発明禁止。 チートシート/reference に無ければ reference を読むか、「わからない」と言う。
  • ❌ DESIGN.md を無視して汎用ベストプラクティスで上書き禁止。 ブランドトークンが優先。
  • ❌ モーションを入れて prefers-reduced-motion 分岐を欠落させるの禁止。
  • ❌ AUDIT で severity inflation (全部 BLOCK)・deflation (BLOCK を FYI に)・line ref なしの issue 禁止。
  • ❌ 数値変更が必要な場合、reference.md を手で修正せず corpus → ジェネレーターで再生成。

5. omd エコシステム関係

  • omd:apply — ブランド DESIGN.md トークンを適用。omd:feel はその上で、トークンが沈黙している フィーリング 層を埋める。
  • omd:designer-review — ブランド一貫性(タイポ/色予算/radius スケール)を監査。omd:feel AUDIT はその フィーリング軸のペア(モーションタイミング・ターゲット・CLS・a11y)。
  • omd:taste — ユーザーの 好み ダッシュボード(別概念)。繰り返される feel の決定が好みとして固まれば omd:remember に流す。

手動検証: transition: all 0.6s + <button class="w-5 h-5"> + prefers-reduced-motion 分岐なしのコンポーネントを AUDIT すると — BLOCK 最低3件(transition all=GPU SPEC, 20px ターゲット=WCAG SPEC, reduced-motion 欠落=a11y SPEC)が line ref 付きで表示され、feel-score がその分下がるべき。

関連スキル