screenshot-to-compose は何をしますか?
デザインを目視せずに、忠実にComposeで再現します。リファレンス画像が受け入れテストとなるため、使用するすべての数値は観測値(画像上で測定)または推論値(推定値を明示)のいずれかであり、完成した画面は最後にリファレンスと比較されます。
デザインが入力の場合
- スクリーンショット/モックアップのみ:以下の全フェーズを実行します。
- Figmaフレームがある場合:測定はスキップ(Figmaから値を読み取る)し、残りの工程を実行します。
- デザインがまだない場合:まず
app-design-studioスキルを使用し、その後このスキルに戻ってきます。
ワークフロー
ファイル(docs/design/)内で作業し、共有基盤ができた後に1画面ずつ処理します。画面のインベントリ全体を把握するまでは、何も実装しないでください。
- 調査。 リポジトリを最初に読み込みます(アーキテクチャ、テーマ、共有コンポーネント、既存の画面)。うまく機能している部分は維持します。前提条件をメモします。
- インベントリ作成。 リファレンス画像をそのまま
docs/design/reference/にコピーします(ケバブケースの名前を使用)。SCREEN_INVENTORY.mdを作成します:各画像 → 画面 + 状態、画面間のリンク、欠落しているリファレンス(リンクされているが画像がない画面)、ピクセルサイズとアスペクト比。すべての状態(ローディング、空、エラー、オフライン、パーミッション、プレミアム)を含めます。 - 測定。
scripts/measure_image.py shot.png --frame-dp 390 --sample x,y ...を実行し、px→dpのスケールとカラーサンプルを取得します(references/measuring.md参照)。ピクセルはdpではありません。特に指定がない限り390 dpのフレームを想定し、dp = px / (imageWidthPx / 390)と計算します。観測値と推論値を別々のカラムに記録します。 - デザインシステム。 測定した色をMaterial 3のロールにマッピングし、タイプスケール、シェイプ、スペーシングをテーマに設定します。画面ではテーマトークンのみを使用し(画面内に16進数カラーコードやサイズ、半径を直接書かない)。ライトテーマとダークテーマを定義します。ライトテーマのみ存在する場合は、レイアウトを変更せずにダークテーマを導出します。
- アセット(
references/assets.md)。アイコン:1つのファミリーから選択し、Iconifyから取得してscripts/svg_to_vectordrawable.pyで変換します。アートワーク:生成し、スクリーンショットからクロップしないでください。テキスト、ボタン、カード、リング、チャートは常にComposeで実装し、画像にしないでください。ソース、ライセンス、モデル、プロンプトをASSET_INVENTORY.mdに記録します。 - 計画。 画面ごとに事前に決定します:戻る動作、ネットワーク/オフラインクラス、パーミッション、小さな画面でのスクロールまたはフィット、モーション。
SCREEN_IMPLEMENTATION_PLAN.mdにビルド順序を書きます(これらの品質ルールはandroid-compose-quality-gateスキルにあります)。 - 実装。 共有基盤を最初に実装し、次に画面を実装します:不変のUI状態に対するステートレスコンポーザブル、Intentを持つViewModel、1ファイルにつき1コンポーザブル、すべてのテキストに文字列リソースを使用。独立したモジュールでファイルが重複しない場合のみ並列化します。カード、タイル、または密なテキストを構築する前に
references/compose-lessons.mdを読んでください。 - 比較(
references/verification.md)。画面をレンダリングし(エミュレータのスクリーンショットまたはRoborazzi)、scripts/compare_side_by_side.pyを使用してリファレンスと等幅で並べ、レイアウト、スペーシング、タイポグラフィ、色、シェイプ、アセットの差分をリストアップし、修正して繰り返します。その後、小型デバイス(360 x 526 dp)、長いテキスト/ドイツ語、RTL、ダークテーマ、フォントスケール1.3でチェックします。機能やレスポンシブ性をピクセル一致のために犠牲にしないでください。 - 納品。 リファレンス、プロンプト付きアセット、アイコンソース/ライセンス、インベントリ、比較ノートを最新に保ちます。画面は、動作かつビジュアル比較に合格した場合のみ完了とみなします。トピックごとにコミットします。
よくある失敗を防ぐルール
- リファレンススクリーンショットから画像をクロップしないでください(低解像度、圧縮、UIが埋め込まれている)。
- ネイティブUIをその画像で置き換えないでください。
- リファレンスがあいまいな場合にデザインをでっち上げないでください。最も合理的な推論を行い、推論値のカラムに書き込み、リファレンスに近づけてください。
- 画面が実行され比較されるまでは、完了したと主張しないでください。
- リポジトリやドキュメントにシークレット(APIキー)を含めないでください。画像サービスのキーは環境変数から取得します。
ファイル
references/measuring.md- pxからdpへの変換、カラーサンプリング、観測値と推論値のテーブルreferences/assets.md- IconifyからVectorDrawableへの変換、画像生成の順序とレビュー、エクスポートサイズ、その他のソースreferences/compose-lessons.md- 実際に時間を浪費する欠陥:兄弟カードの比率、Intrinsic measurementクラッシュ、幅のしきい値、自動サイズ調整テキストreferences/verification.md- エミュレータとRoborazziの比較ループ、およびデバイスマトリックスscripts/measure_image.py、scripts/svg_to_vectordrawable.py、scripts/compare_side_by_side.py(Python 3 + Pillow)