Communityコーディング&開発github.com

jovd83/design-fidelity-auditor

CSS、Tailwind、JSX、TSX、Vue、Angularコードにおけるデザインシステムからの逸脱を監査します。

design-fidelity-auditor とは?

このスキルは、フロントエンド実装が指定されたデザインシステムに準拠しているかを自動的に監査します。CSS、Tailwind CSS、JSX/TSX(React)、Vue、Angularなど、複数のフレームワークとスタイリング手法に対応しており、デザインの一貫性を保ち、デザインシステムからの「ドリフト」(逸脱)を早期に発見するのに役立ちます。開発者はこのツールを使って、コードベース全体をスキャンし、カラーパレット、タイポグラフィ、スペーシングなどのデザイントークンが適切に使用されているかを確認できます。対応プラットフォームはClaude Code、Cline、Roo、Cursor、Windsurf、Gemini Code Assist、Lovable、Copilot Chat、Continue.dev、Aider、CodeGPT、PraisonAIなど多岐にわたります。仕組みとしては、スキルがデザインシステムの定義ファイル(例:tailwind.config.jsやテーマJSON)を読み込み、コード内のスタイルやクラス名がその定義に従っているかをチェックします。違反があった場合は、ファイルパスと該当箇所を示す形でレポートを生成するため、修正作業を効率的に進められます。

対応~Claude Code~Codex CLI~Cursor
npx skills add jovd83/design-fidelity-auditor

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

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

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

ドキュメント

design-fidelity-auditor は何をしますか?

CSS、Tailwind、JSX、TSX、Vue、Angularコードにおけるデザインシステムからの逸脱を監査します。

概要

jovd83/design-fidelity-auditor は、フロントエンドコードベースを分析し、定義されたデザインシステムからの逸脱(ドリフト)を特定するためのスキルです。これにより、UIの一貫性を維持し、デザインと実装の乖離を防ぎます。

対応プラットフォーム

  • Claude Code
  • Cline
  • Roo
  • Cursor
  • Windsurf
  • Gemini Code Assist
  • Lovable
  • Copilot Chat
  • Continue.dev
  • Aider
  • CodeGPT
  • PraisonAI

使用方法

  1. プロジェクトのルートにデザインシステムの定義ファイルを配置します(例:design-tokens.json)。
  2. スキルを実行すると、以下の要素が自動的にチェックされます。
    • CSSプロパティとカスタムプロパティ
    • Tailwind CSSのクラス名と設定
    • インラインスタイル
    • コンポーネントのprops
  3. 監査結果は、ファイルパスと具体的な違反箇所を含むレポートとして出力されます。

設定

監査のカスタマイズには、プロジェクトルートに .design-fidelity-auditor.json ファイルを作成します。

{
  "tokenFiles": ["design-tokens.json"],
  "ignorePaths": ["node_modules", "dist"],
  "strictMode": true
}

出力例

違反が3件見つかりました:
1. src/components/Button.tsx:23 - 未定義のカラートークン `#ff6600` が使用されています。
2. src/styles/global.css:45 - フォントファミリー `"Arial"` はデザインシステムに含まれていません。
3. src/views/Dashboard.vue:12 - スペーシングに `margin: 15px` が使われています。推奨: `margin: 16px`(トークン `spacing-4`)。

制限事項

  • 動的に生成されるクラス名やスタイルは完全には検出できません。
  • デザインシステムの定義ファイルは手動で用意する必要があります。

ライセンス

MIT

関連スキル