Communitygithub.com

aialchemylabs/ui-design-exploration

実装前のUIデザインの方向性を、既存プロダクトを基盤として探索・比較します。代替レイアウト、ビジュアルコンセプト、デザインハンドオフに使用し、プロダクションコードの変更や読み取り専用のデザインレビューと区別します。

ui-design-exploration とは?

このスキルは、実装に着手する前にUIデザインの代替案を体系的に探索・比較するためのものです。既存の画面、コンポーネント、デザイントークン、密度、コンテンツ、インタラクションの慣習を事前に調査し、製品のアイデンティティを維持しながら(再デザインが要求されていない限り)複数のデザイン方向性を生成します。主にClaude Codeなどのエージェント環境で使用され、Superdesignのような外部連携サービスが利用可能な場合はそれも活用しますが、サービスが利用できなくてもローカルHTMLや既存のデザインキャンバスを用いて成果物を作成できることが重要です。デザインの選択肢は、単なる色の変更ではなく、構造やインタラクションに実質的な違いを設け、各代替案が何を改善し、何を犠牲にするかを明確にします。最終的には、選択されたデザイン成果物と未解決の決定事項をハンドオフし、必要に応じて実装(frontend-ui-engineering)やデザインレビュー(plan-design-review)へルーティングします。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aialchemylabs/agents-skills/tree/HEAD/plugins/engineering/skills/ui-design-exploration

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

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

ドキュメント

UIデザイン探索 (UI Design Exploration)

指定されたタスクに対して、実用的なデザイン方向性を生成します。代替案を生成する前に、既存の画面、コンポーネント、トークン、密度、コンテンツ、インタラクションの慣習を調査してください。再デザインが明示的に要求されていない限り、製品のアイデンティティを維持します。

参考エビデンスの活用

タスクに外部リファレンスが関連する場合は、利用可能であればdesign-reference-researchを使用するか、関連する提供/デフォルトソースを直接調査してください。そのソースのカバレッジを消費し、ID、観察結果、不確実性をキャプチャします。完了した調査をやり直したり、調査されていないムードボードをエビデンスとして扱ったりしないでください。リファレンスが利用可能であっても、製品にすでに基づいた小さなタスクで調査を必須とするわけではありません。

有用な原則を、既存の製品アイデンティティを用いた独自の代替案に変換します。各重要な選択がどのようにユーザータスクとエビデンスに従っているかを説明します。プラットフォーム、タスク、制約によって矛盾するパターンを解決します。互換性のないナビゲーションシステムを混在させたり、他の製品のブランディングをコピーしたりしないでください。未知のインタラクション状態は、観察された動作を黙って発明するのではなく、検証すべき質問として先送りします。

代替案の枠組み設定

結果を実質的に変える選択のみを明確にします。ユーザータスク、コンテンツ階層、該当する状態、アクセシビリティ制約、対象サーフェスを特定します。代替案は色だけでなく、構造やインタラクションに実質的な違いを持たせます。リクエストに比例した少数を使用し、常に3つ生成したり、並列エージェントを必要としたりしないでください。

実装がすでに要求されていない限り、探索的な成果物はプロダクションコードとは別に保ちます。現実的なデータ、長いラベル、空/エラー状態、および選択肢を変えるレスポンシブレイアウトを使用します。各代替案が何を改善し、何を犠牲にするかを示します。スクリーンショットだけでは、フォーカス、ナビゲーション、永続性を特定できません。

利用可能なデザイン機能の活用

リポジトリネイティブのコンポーネントと利用可能なプレビュー/デザインツールを使用します。実用的な成果物は、ローカルHTML、既存のデザインキャンバス、注釈付きビジュアルのいずれでもかまいません。ホスト型ベンダーに依存する必要はありません。そのエビデンスなしに、デザインがレンダリングまたはテストされたと主張しないでください。

明示的に設定されたSuperdesign統合については、hosted-design.mdを読んでください。ワークフローは、そのサービスが利用できない場合でも機能する必要があります。デザイン作業の暗黙の前提条件として、最新のCLIをダウンロードしたり、アカウントを作成したり、ソースをアップロードしたりしないでください。

方向性のハンドオフ

タスクと制約に対して代替案を比較します。ユーザーが選択を要求した場合は、その決定のための実際の代替案を提示します。ユーザーがあなたに選択を許可した場合は、別の承認ゲートを導入するのではなく、理由とともに推奨して進めてください。

選択された成果物、再利用されたトークン/コンポーネント、レイアウトルール、レスポンシブ変更、インタラクション/フォーカス動作、意味のある状態、アセット、未解決の決定を提供します。受入基準と意図的な逸脱を、利用可能な場合は参照エビデンスIDに関連付けます。選択されなかった代替案は実装要件ではありません。選択されたデザインと動作する実装を区別します。許可された実装はfrontend-ui-engineeringにルーティングし、批評はplan-design-reviewにルーティングします。どちらもインストールする必要はありません。

上流のワークフローソースと通知については、provenance.mdをお読みください。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

関連スキル