Communitygithub.com

フロントエンドスタイル抽出ツール

既存のWebアプリまたはアクセス可能なWebサイトからポータブルなフロントエンドデザインシステムを抽出・文書化します。UIスタイル、デザイントークン、タイポグラフィ、レイアウト、コンポーネント、インタラクション、レスポンシブ対応の分析や、再利用可能なスタイルルールの生成を依頼された場合に使用します。ソースアプリの再設計、変更、移行は行いません。

フロントエンドスタイル抽出ツール とは?

このスキルは、既存のフロントエンドアプリケーションからフレームワークに依存しないポータブルなデザインシステムを抽出・文書化するためのものです。ソースコードやデザインを変更することなく、UIのスタイル、トークン、コンポーネントルールなどを体系的に分析し、設計意図を文書化します。主なユースケースは、既存のUIパターンを再利用可能な形で別のプロジェクトに引き継ぐこと、またはデザインの一貫性を分析・記録することです。このスキルは、独自のスクリプト(`style_inventory.py`、`validate_bundle.py`)を使用して分析と検証を行い、出力は`manifest.json`、`tokens.json`、`rules.json`、`README.md`などの構造化されたファイル群として生成されます。ソースアプリの稼働中のUIへのアクセスが必須であり、アクセスできない場合はその旨を報告します。抽出されたデザインシステムは、同じ役割を持つ別のスキル(`frontend-style-adapter`)へのハンドオフ契約として機能します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MaduroLabs/styleport/tree/HEAD/skills/frontend-style-extractor

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

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

ドキュメント

フロントエンドスタイル抽出ツール は何をしますか?

目的

ソースフロントエンドから、証拠に基づいたフレームワーク非依存のポータブルデザインシステムバンドル v1.0.0 を作成します。出力は frontend-style-adapter へのハンドオフ契約であり、ソースコードのコピーやピクセルパーフェクトなクローンを作成するものではありません。

バンドルを作成する前に references/CONTRACT.md を読んでください。調査中は references/INSPECTION_CHECKLIST.md を参照してください。スタイル値をでっち上げたり、推測されたパターンを観察された事実として表現したりしないでください。

入力

  • ソース: リポジトリルート / ワークスペース、選択されたディレクトリ、またはアクセス可能なレンダリング済みWebサイト。
  • オプション: 特定のページ/コンポーネント、テーマ、ブレークポイント、デザインの忠実度、出力パス。
  • デフォルト: ソース = 現在のリポジトリ; スコープ = リポジトリ内で発見可能な代表的な共有UI + ルート/ページ; 出力 = ソースリポジトリ内の design-system/portable/ (ユーザーが別の場所を要求しない限り)。
  • アクセス可能なソースCSSや計算済みスタイルのないパブリックURLは、視覚のみのソースです。ツールで測定できない限り、正確なピクセル/色/間隔の測定値は推測としてマークします。環境がWebサイトを開けない場合は、分析を捏造するのではなく、その制限を説明します。

ワークフロー

  1. ソースを変更せずに方向性を確認します。 gitの状態、プロジェクト構造、パッケージマニフェスト、フレームワークとスタイリングスタック、ルート/ページ構造、グローバルスタイル、テーマプロバイダー、コンポーネントライブラリ、デザイントークンを確認します。AGENTS.md とリポジトリの指示を尊重します。.env、シークレット、無関係なデータを決して読み取らないでください。
  2. オプションのヒューリスティックインベントリを実行します (stdlib のみ; 信頼性のあるCSSパーサーではありません): python3 <skill-root>/scripts/style_inventory.py <source-root> --out <temporary-path>/style-inventory.json 可能であれば、リポジトリ外の一時的なパスを使用します。サマリを読み、重要な主張をコードやレンダリングされたUIで直接検証します。
  3. 代表的なUIをサンプリングします: グローバルシェル、ナビゲーション、見出し/テキスト、ボタン、フィールド/フォーム、カード、テーブル、モーダル、アラート、ローディング/空/エラー状態。デスクトップとモバイル、ホバー/フォーカス/無効、ライト/ダーク(サポートされている場合)を検査します。一般的なルートと珍しいルートの両方をサンプリングします。検査したサーフェスとスキップしたサーフェスを記録します。
  4. ルールの階層を解決します: 明示的なトークン/設定 → 共有コンポーネント → 繰り返しのページパターン → 例外的な1回限りのパターン。単一ページのレイアウトをグローバルルールと誤解しないでください。意味がある場合はセマンティックトークンとエイリアス(例: var(--brand-primary))を保持し、実際の解決値は検証された場合のみ記載します。
  5. 来歴を記録します: 各トークンと各構造化ルールには、origin、confidence、具体的なevidenceが必要です。ファイルパス + 行/シンボル、計算済みスタイルの観察、スクリーンショット/ビューポート参照を優先します。サポートされていない推論はすべてそのようにラベル付けする必要があります。制限事項、未検査のページ、依存関係/アセットライセンスの不確実性があれば記載します。
  6. 選択した出力パスにバンドルを作成します。 必須ファイル: manifest.json、tokens.json、rules.json、README.md、typography.md、layout-rules.md、component-rules.md、interaction-rules.md、responsive-rules.md。オプションでアイコン/画像/フォントに関する考慮事項については assets.md を作成します。references/CONTRACT.md と assets/example-bundle/ を参照して形式を確認し、すべての例のコンテンツをソース固有の観察結果に置き換えます。フレームワーク固有の実装のみの説明ではなく、ポータブルな言語(コンポーネント契約と設計意図)を使用します。
  7. 検証します: python3 <skill-root>/scripts/validate_bundle.py <bundle-path>。すべてのエラーを修正します。不明または信頼性の低い項目を手動で検査します。ブラウザやスクリーンショットの比較が行われていない場合、視覚的な忠実度がテストされたと主張しないでください。
  8. 報告します: ソースと調査したサーフェス、フレームワーク/スタイリング方法、出力パス、トークン/ルール数、カバレッジ/不確実性、検証結果、およびハンドオフの使用法: frontend-style-adapter をデザインシステムパスで呼び出します。

厳格な制約

  • デザイン言語を抽出します。ビジネスロジック、コピー、プロプライエタリアセット、実装内部は抽出しません。
  • アプリのソースを変更したり、パッケージをインストールしたり、設定を書き換えたり、自動コミットしたりしないでください。リクエストされたバンドルの作成は許可されています。
  • ユーザーが明示的に許可し、権利が明確でない限り、ロゴ、フォントバイナリ、ライセンスされた画像/アイコンをバンドルにコピーしないでください。代わりに、それらの外観、元の参照、ライセンスに関する注意事項を説明します。
  • .env、資格情報、ユーザーデータ、ライブAPI応答、またはシークレットを転送しないでください。
  • 別々のダーク/ライトテーマとレスポンシブルールが存在する場合はそれらを保持し、単一のスタイルに平坦化しないでください。
  • 正確な実装の詳細は evidence/メモに属し、要件はクロスフレームワークでポータブルなままにします。
  • 量よりも明確さを優先します。価値の高い文書化されたパターンは、何百ものサポートされていないトークンよりも優れています。
  • 実行可能なUI/ブラウザが利用できない場合は、マニフェストに visualVerification: "not_performed" と報告します。

完了条件

バンドルが検証され、エクスポートされたすべての事実がトレース可能であり、グローバルルールが例外から分離され、アクセシビリティ/レスポンシブ状態が対応され、レポートが既知のギャップを記載していること。

関連スキル