フロントエンドスタイル抽出ツール は何をしますか?
目的
ソースフロントエンドから、証拠に基づいたフレームワーク非依存のポータブルデザインシステムバンドル v1.0.0 を作成します。出力は frontend-style-adapter へのハンドオフ契約であり、ソースコードのコピーやピクセルパーフェクトなクローンを作成するものではありません。
バンドルを作成する前に references/CONTRACT.md を読んでください。調査中は references/INSPECTION_CHECKLIST.md を参照してください。スタイル値をでっち上げたり、推測されたパターンを観察された事実として表現したりしないでください。
入力
- ソース: リポジトリルート / ワークスペース、選択されたディレクトリ、またはアクセス可能なレンダリング済みWebサイト。
- オプション: 特定のページ/コンポーネント、テーマ、ブレークポイント、デザインの忠実度、出力パス。
- デフォルト: ソース = 現在のリポジトリ; スコープ = リポジトリ内で発見可能な代表的な共有UI + ルート/ページ; 出力 = ソースリポジトリ内の
design-system/portable/(ユーザーが別の場所を要求しない限り)。 - アクセス可能なソースCSSや計算済みスタイルのないパブリックURLは、視覚のみのソースです。ツールで測定できない限り、正確なピクセル/色/間隔の測定値は推測としてマークします。環境がWebサイトを開けない場合は、分析を捏造するのではなく、その制限を説明します。
ワークフロー
- ソースを変更せずに方向性を確認します。 gitの状態、プロジェクト構造、パッケージマニフェスト、フレームワークとスタイリングスタック、ルート/ページ構造、グローバルスタイル、テーマプロバイダー、コンポーネントライブラリ、デザイントークンを確認します。
AGENTS.mdとリポジトリの指示を尊重します。.env、シークレット、無関係なデータを決して読み取らないでください。 - オプションのヒューリスティックインベントリを実行します (stdlib のみ; 信頼性のあるCSSパーサーではありません):
python3 <skill-root>/scripts/style_inventory.py <source-root> --out <temporary-path>/style-inventory.json可能であれば、リポジトリ外の一時的なパスを使用します。サマリを読み、重要な主張をコードやレンダリングされたUIで直接検証します。 - 代表的なUIをサンプリングします: グローバルシェル、ナビゲーション、見出し/テキスト、ボタン、フィールド/フォーム、カード、テーブル、モーダル、アラート、ローディング/空/エラー状態。デスクトップとモバイル、ホバー/フォーカス/無効、ライト/ダーク(サポートされている場合)を検査します。一般的なルートと珍しいルートの両方をサンプリングします。検査したサーフェスとスキップしたサーフェスを記録します。
- ルールの階層を解決します: 明示的なトークン/設定 → 共有コンポーネント → 繰り返しのページパターン → 例外的な1回限りのパターン。単一ページのレイアウトをグローバルルールと誤解しないでください。意味がある場合はセマンティックトークンとエイリアス(例:
var(--brand-primary))を保持し、実際の解決値は検証された場合のみ記載します。 - 来歴を記録します: 各トークンと各構造化ルールには、
origin、confidence、具体的なevidenceが必要です。ファイルパス + 行/シンボル、計算済みスタイルの観察、スクリーンショット/ビューポート参照を優先します。サポートされていない推論はすべてそのようにラベル付けする必要があります。制限事項、未検査のページ、依存関係/アセットライセンスの不確実性があれば記載します。 - 選択した出力パスにバンドルを作成します。 必須ファイル:
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/を参照して形式を確認し、すべての例のコンテンツをソース固有の観察結果に置き換えます。フレームワーク固有の実装のみの説明ではなく、ポータブルな言語(コンポーネント契約と設計意図)を使用します。 - 検証します:
python3 <skill-root>/scripts/validate_bundle.py <bundle-path>。すべてのエラーを修正します。不明または信頼性の低い項目を手動で検査します。ブラウザやスクリーンショットの比較が行われていない場合、視覚的な忠実度がテストされたと主張しないでください。 - 報告します: ソースと調査したサーフェス、フレームワーク/スタイリング方法、出力パス、トークン/ルール数、カバレッジ/不確実性、検証結果、およびハンドオフの使用法:
frontend-style-adapterをデザインシステムパスで呼び出します。
厳格な制約
- デザイン言語を抽出します。ビジネスロジック、コピー、プロプライエタリアセット、実装内部は抽出しません。
- アプリのソースを変更したり、パッケージをインストールしたり、設定を書き換えたり、自動コミットしたりしないでください。リクエストされたバンドルの作成は許可されています。
- ユーザーが明示的に許可し、権利が明確でない限り、ロゴ、フォントバイナリ、ライセンスされた画像/アイコンをバンドルにコピーしないでください。代わりに、それらの外観、元の参照、ライセンスに関する注意事項を説明します。
.env、資格情報、ユーザーデータ、ライブAPI応答、またはシークレットを転送しないでください。- 別々のダーク/ライトテーマとレスポンシブルールが存在する場合はそれらを保持し、単一のスタイルに平坦化しないでください。
- 正確な実装の詳細は
evidence/メモに属し、要件はクロスフレームワークでポータブルなままにします。 - 量よりも明確さを優先します。価値の高い文書化されたパターンは、何百ものサポートされていないトークンよりも優れています。
- 実行可能なUI/ブラウザが利用できない場合は、マニフェストに
visualVerification: "not_performed"と報告します。
完了条件
バンドルが検証され、エクスポートされたすべての事実がトレース可能であり、グローバルルールが例外から分離され、アクセシビリティ/レスポンシブ状態が対応され、レポートが既知のギャップを記載していること。