スキル自身の言葉で
既存のフロントエンドコードベース(React + Vite、Next.js、Angular、Vue)を、extract-static-html、extract-design-md、upload-to-stitchの3つのスキルを連結してStitch Designに変換します。稼働中のアプリやビルド済みのWebディレクトリをStitchに移行し、そこで反復作業を行いたいデザイナーや開発者を対象としています。
このワークフローは、自己完結型のHTMLファイルを1つ抽出し、.stitch/DESIGN.mdにデザインシステムを書き出し、Stitch内にデザインシステムを作成した後、そのページのルートパスをタイトルにしたスクリーンとしてHTMLをアップロードします。これは保存、移行、アップロードのリクエストに対する必須のパスであり、HTMLの検証は任意で、実行を止めることはありません。
生成されるもの
- 1つの自己完結型HTMLファイル、例えば/path/to/extracted/standalone.htmlです。
- DESIGN.mdとして記述されたデザインシステムの説明です。
- Stitchにアップロードされたスクリーンで、その名前とタイトルはアプリケーション内でどのルートから来たかを示します。
仕組み
- 01自己完結型HTMLファイルを抽出する
extract-static-htmlスキルに処理を引き渡します。これはビルド出力または稼働中の開発サーバー(Viteやng serveなどのAngular CLI)から動作し、1つのスタンドアロンHTMLファイルを生成します。
- 02停止せずに検証を提供する
抽出後、ユーザーがブラウザで自分自身で確認できるよう、ファイルの場所を伝えます。そして実行はいずれにせよ次のステップへ続きます。
- 03ソースをデザインシステムに分析する
extract-design-mdスキルはプロジェクトのコンポーネント、スタイルシート、テーマ設定を読み取り、その結果をデザインシステムファイルとして書き出します。
- 04Stitchでデザインシステムを作成する
manage-design-systemスキルはDESIGN.mdをアップロードし、必要なスキーマを指定してcreate_design_system_from_design_mdを呼び出します。
- 05HTMLをスクリーンとしてアップロードする
同じアップロードスクリプトが、Stitch APIキーとprojectIdを使ってスタンドアロンHTMLを送信します。titleの引数にはページのルートが設定されるため、Stitch上でそのスクリーンを識別できます。