Communitygithub.com

Tsuky44/player

実際のプロダクト表面に対するUIデザインと実装を行うスキルです。テイストファーストの批評、リファレンスルーティング、プロジェクト固有のデザインブリーフ、バリエーション比較、実装検証を行います。CodexがフロントエンドUIを再設計、構築、洗練、批評する際に使用します。

player とは?

Tsuky44/player スキルは、AIエージェント(Codexなど)が実際のプロダクト向けに高品質なフロントエンドUIを設計・実装するための包括的なワークフローを提供します。このスキルは、単なるスタイルの適用ではなく、プロダクトのコンテキストを理解し、テイスト(美的感覚)の探求から始め、外部リファレンスを適切に参照し、プロジェクト固有のデザインブリーフを合成し、実装後に結果を厳密に評価することを重視します。特に「投資ゲート」と呼ばれるチェックポイントを各工程に設けることで、間違ったテイストやリファレンス、実装範囲に過剰に投資するリスクを防ぎます。アプリ画面、ダッシュボード、ランディングページなど、意味のあるUI作業に最適ですが、バックエンドのみの作業や小さな修正には使用すべきではありません。複数のモード(テイストファースト再設計、プロダクションUI実装、デザイン批評のみ)を備え、状況に応じて適切なワークフローを選択できます。

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

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

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

ドキュメント

テイストフルな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がより良くなったかどうか、その理由、およびその判断を裏付ける証拠を認識できる必要があります。

関連スキル