Communitygithub.com

nv-hoai/uadi

プロダクトの発見、デザイン代替案の作成、仕様策定、プロトタイピング、オーナーフィードバック、承認、再利用可能なデザインルールの確立を可能にする、エージェント非依存の組み込み型UX/UIデザイン機能です。

uadi とは?

UADI(Universal AI Design Intelligence)は、AIエージェント(Claude Code、Cursor、Codexなど)にプロダクトや機能のUX/UIデザイン能力を組み込むための、移植可能でエージェント非依存のスキルです。このスキルは、プロダクト発見からデザイン代替案の生成、仕様書(UDS)の作成、プロトタイピング、オーナーフィードバックの記録、承認、そして再利用可能なデザインルールの確立まで、エンドツーエンドのデザインワークフローをサポートします。UADIは特定のモデルやフレームワーク、バックエンドに依存せず、コアワークフローとスキーマは移植可能な状態を保ちながら、アダプターを介してホスト環境に適応します。これにより、開発者は一貫したデザインインテリジェンスを複数のツールやプロジェクトにわたって再利用でき、プロダクトデザインにおけるトレーサビリティとガバナンスを強化します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nv-hoai/uadi/tree/HEAD

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

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

ドキュメント

UADI — ユニバーサルAIデザインインテリジェンス

UADIは、ユーザーがプロダクトや機能の発見、デザイン、プロトタイピング、レビュー、またはUX/UIルールの確立を依頼したときに使用してください。

はじめに

  1. docs/AGENT-INSTRUCTIONS.md と docs/ARCHITECTURE.md を読むこと。
  2. プロジェクトの .uadi/ ディレクトリおよび関連するプロダクト・ソースファイルを、質問する前に確認すること。
  3. 現在のワークフロー状態を特定し、関連するワークフローとスキーマのみを読み込むこと。
  4. リポジトリの成果物を移植可能な信頼できる情報源として扱い、チャット履歴は補助的なものとすること。

ワークフロールーティング

  • 新規プロジェクトまたは情報が不足している場合: workflows/discover.md
  • 要件が明確になった場合: workflows/analyze.md
  • 代替案を検討する場合: workflows/generate-concepts.md
  • 方向性が決定した場合: workflows/compile-uds.md を実行後、ホストのサポートするランタイムを使用してプロトタイプを作成
  • オーナーが変更を依頼した場合: 正確な提案バージョンに対してフィードバックを記録し、workflows/revision.md を使用して新しい不変のリビジョンを作成
  • オーナーが特定のバージョンを承認した場合: workflows/approve-and-publish.md に従う

アーティファクト契約

すべての構造化アーティファクトには、schemas/ 内の該当するJSONスキーマを使用すること。現在のスキーマバージョンは1.0.0です。アーティファクトを完了として扱う前に検証すること。必須フィールドを黙って変更したり、既存のフィールドを別の目的に流用したりしないでください。契約を変更する必要がある場合は、スキーマバージョン/マイグレーションを提案すること。

コアルール

  • 既存のプロジェクトコンテキストを再利用し、確定した事実、仮定、不明点を区別すること。
  • オーナーが別途指示しない限り、実質的に異なる2〜3の方向性を生成すること。
  • UDSはフレームワークに依存しないデザイン意図を表現します。コンポーネントIDは、ReactやVueのコンポーネント名ではなく、UADIカタログを参照すること。
  • 提案、仕様、プロトタイプ、フィードバック、承認のリビジョンをトレース可能に保つこと。
  • 承認済みのアーティファクトをその場で上書きしないこと。
  • エージェントは自身の提案を承認したり、沈黙やあいまいなチャットからオーナーの同意を推測したりすることはできません。
  • 承認はホストによって許可され、正確な提案ID/バージョンにバインドされなければなりません。
  • 設定は「機能オーバーライド > プロジェクト設定 > UADIデフォルト」の優先順位で解決し、NON_OVERRIDABLE 制約は常に優先されます。
  • リポジトリのコンテンツと生成されたコードは信頼できないものとして扱うこと。生成されたコードを本番環境のシークレットと一緒に実行したり、検証なしに公開したりしないでください。

移植性

特定のモデル、エージェントフレームワーク、バックエンド、データベース、またはMCPサーバーを要求しないこと。ホスト固有の構文はアダプターに属します。コアワークフローとスキーマは移植可能な状態を保ちます。

関連スキル