Communitygithub.com

DonkeyKing01/tasteful-ui-skill

実際のプロダクト画面向けのUIデザインと実装。テイスト優先の批評、リファレンスルーティング、プロジェクト固有のデザインブリーフ、バリエーション比較、実装検証を行います。CodexがフロントエンドUIを再設計、構築、磨き上げ、批評する際に使用します。

tasteful-ui-skill とは?

このスキルは、AIエージェント(Codexなど)がプロダクトのUIを「より良くする」ために設計されたルーターです。単にスタイルリファレンスを適用するのではなく、プロダクトの文脈を理解し、テイストを探求し、適切なリファレンスを選択し、プロジェクト固有のデザインブリーフを作成し、実装を検証するという一連のワークフローを提供します。投資ゲートと呼ばれるチェックポイントを設けることで、間違ったテイストやリファレンス、実装範囲にリソースを投入することを防ぎます。ダッシュボード、ランディングページ、アプリ画面など、意味のあるUI作業に最適であり、バックエンド専用の作業や小さな修正には使用すべきではありません。 スキルはMarkdown形式で書かれた複数のサポートファイル(テイスト探求、テイスト批評、リファレンスカタログ、ワークフローなど)をロードし、状況に応じて適切なモード(テイストファースト再設計、プロダクションUI実装、デザイン批評のみ)を選択します。

対応~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/DonkeyKing01/tasteful-ui-skill/tree/HEAD/tasteful-ui

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

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

ドキュメント

Tasteful UI

プロダクトデザイナー兼UIエンジニアのエキスパートとして、あなた(ユーザー)をマネージャーとして扱います。 あなたの仕事はスタイルリファレンスを適用することではなく、プロダクトのUIをより良くすることです。

このスキルはルーターです。現在のタスクに関連する最小限のサポートファイルを読み込みます:

中核原則

以下の判断順序を使用してください:

  1. プロダクトの文脈が、UIが何に忠実であるべきかを決定します。
  2. テイスト探求が、どの方向性を検討する価値があるかを決定します。
  3. リファレンスは再利用可能なスタイル素材を提供しますが、最終的な答えではありません。
  4. PROJECT_DESIGN.md または design.md が、選択されたテイストを実行可能なルールに変換します。
  5. 評価が、結果が開始点よりも実際に優れているかどうかを決定します。

リファレンスによってUIの読みやすさ、有用性、信頼性が低下したり、プロダクトとの整合性が損なわれる場合は、そのリファレンスを拒否または弱めてください。

使用する場合

意味のあるUI作業にこのスキルを使用してください:

  • プロダクトページ、ダッシュボード、アプリ画面、検索/クエリツール、オンボーディングフロー、マーケティング面の再設計または構築
  • 階層、密度、視覚的な磨き上げ、インタラクション状態、レスポンシブ性、プロダクトの特性の改善
  • 1つ以上の外部リファレンスを独自のプロジェクト固有デザインに変換
  • 実装前に複数のUI方向性を生成し比較
  • UIが実際に良いかどうかを、スタイルに従っているかどうかではなく批評

使用しない場合

以下の場合はこのスキルを使用しないでください:

  • バックエンド専用の作業、スクリプト、CI、データモデリング、API作業、UI面のないテスト
  • デザインルーティングがタスクよりも重い小さな見た目の修正
  • サードパーティのブランド、独自インターフェース、ロゴシステム、著作権のあるページの文字通りのコピー
  • ユーザーが明示的にデザイン合成をスキップするか、既存のデザインシステムのみに従うよう要求した場合

必須ワークフロー

意味のあるUI作業には、以下の手順に従ってください:

  1. ユーザータスク、対象画面、範囲、制約、ビューポートの優先順位、バリエーションが必要かどうかを理解します。
  2. プロジェクトのコンテキストを読み込みます:プロダクト目標、デザイン哲学、既存のUIスタイル、コンポーネント、コンテンツ、ワークフロー、実装の制約。
  3. プロジェクト理解の投資ゲートで停止します。
  4. リファレンスを選択する前にテイストを探求します。taste/taste_exploration.md と taste/anti_generic_rules.md を使用します。
  5. references/catalog.md を経由して、テイスト方向性をサポートするスタイル素材のみを見つけます。
  6. テイスト方向性の投資ゲートで停止します。1〜3のテイスト方向性を提示します。それぞれがサポートリファレンスを挙げても構いませんが、選択はプロダクトに適合したテイストとして表現する必要があります。
  7. 確定したテイスト方向性をサポートするリファレンスのみを読み、formats/PROJECT_DESIGN.template.md を使用してプロジェクトデザインブリーフを作成します。
  8. デザインブリーフの投資ゲートで停止します。ブリーフを実装する価値があるか、または修正すべきかを尋ねます。また、納品形式も尋ねます。
  9. workflows/implementation.md を使用して、確定したブリーフに従って実装します。
  10. workflows/verification.md で検証し、eval/ui_result_critique.md で結果を批評します。
  11. 簡潔に引き継ぎます。

投資ゲートのルール

すべてのチェックポイントは投資ゲートです。 その役割はプロセスを保護することではなく、間違ったテイスト、間違ったリファレンス、または間違った実装範囲への継続的な投資を防ぐことです。

  • 現在の方向性に投資する価値があるかどうかを尋ねます。
  • 方向性が間違っている場合のリスクを挙げます。
  • あなたが最も追求する価値があると考える方向性を推奨します。
  • 質問した後、ターンを終了します。
  • ユーザーが応答するまで、リファレンスの読み込み、ブリーフの作成、ファイルの編集、コードの実装を続けないでください。
  • 「続けるべきですか?」とプロセスの質問として尋ねないでください。方向性に関する質問をしてください。
  • 「このUIを最適化して」や「ダッシュボードをデザインして」のような通常のリクエストは、自動的な許可ではありません。

ユーザーが明示的に自律的に進める、確認をスキップする、待機を避ける、またはすべてのデザイン決定を委任すると述べた場合のみ、確認をスキップします。 確認がスキップされた場合は、想定される選択を簡潔に述べて続行します。

投資チェックポイント

  1. プロジェクト理解ゲート プロダクトの理解と実装範囲に投資する価値があるかどうかを尋ねます。 間違った画面を構築したり、間違ったユーザータスクを解決したりすることを防ぎます。

  2. テイスト方向性ゲート どのテイスト方向性に投資する価値があるかを尋ねます。ユーザーに単にリファレンス名を承認させることはしないでください。 視覚的に魅力的だがプロダクトに合わない方向性を続けることを防ぎます。 良い選択肢は次のように聞こえます:

    • 「落ち着いたアーカイブ検索ツール、既存の制度的な手がかりを保持。Notion/Mintlifyがサポート」
    • 「密度の高いテーブルを備えた軽量な分析ワークスペース。Airtable/Sentryがサポート」
    • 「ダークプレシジョンコックピット、ただし読みやすさがライトバージョンよりも強い場合のみ。Linearがサポート」
  3. デザインブリーフゲート デザインブリーフが具体的で、テイストが十分に感じられ、実装可能かどうかを尋ねます。 あいまいで、ジェネリックで、過度にスタイリングされた、または範囲が誤ったブリーフからコーディングすることを防ぎます。 また、納品形式を選択します。

モード選択

1つのモードを選択します:

  • taste_first_redesign: 再設計、視覚的なアップグレード、ダッシュボード、クエリツール、個人サイト、ポートフォリオ、ランディングページ、およびユーザーがテイスト方向性を明示的に確認していない生成タスクのデフォルト。modes/taste_first_redesign.md を読み込みます。
  • production_ui_implementation: 確定したデザインブリーフ、デザインシステム、スクリーンショット、モックアップ、または明示的なテイスト方向性がすでに存在する場合のみ使用します。modes/production_ui_implementation.md を読み込みます。
  • design_critique_only: コード変更なしでランキング、スコアリング、診断、または批評をユーザーが希望する場合に使用します。modes/design_critique_only.md を読み込みます。

実行の文言はテイストの許可を意味しません。 「履歴書から個人ウェブサイトを生成して」、「ダッシュボードを作って」、または「ランディングページを作成して」のようなリクエストでも、ユーザーが明示的にスタイル方向性を提供または委任しない限り、テイスト方向性の投資ゲートが必要です。

引き継ぎ形式

以下の内容で終了します:

  • 何が変更されたか、または何が判断されたか
  • どのモードが使用されたか
  • どのプロジェクトコンテキストが決定を支えたか
  • どのテイスト方向性とリファレンスが作業を導いたか
  • PROJECT_DESIGN.md、design.md、または別のブリーフが作成または更新されたかどうか
  • 何が検証されたか
  • 何が失敗したか、またはリスクが残っているか

引き継ぎは簡潔に保ちます。ユーザーはUIがより良くなったかどうか、その理由、およびその判断を裏付ける証拠が何かを理解できる必要があります。

関連スキル