mirror of
https://github.com/nextlevelbuilder/ui-ux-pro-max-skill.git
synced 2026-11-18 16:23:38 +00:00
docs: add Japanese README (#555)
Adds README.ja.md translated from the current English README and wires the Japanese entry into the language switcher of every locale README. Approved in review.
This commit is contained in:
parent
713eef51b0
commit
dd9a1b4cf9
@ -3,6 +3,7 @@
|
||||
<p align="center">
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.az.md">🇦🇿 Azərbaycanca</a> |
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.id.md">🇮🇩 Bahasa Indonesia</a> |
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.ja.md">🇯🇵 日本語</a> |
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.ko.md">🇰🇷 한국어</a> |
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.vi.md">🇻🇳 Tiếng Việt</a> |
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.zh.md">🇨🇳 简体中文</a> |
|
||||
|
||||
@ -2,6 +2,7 @@
|
||||
|
||||
<p align="center">
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.id.md">🇮🇩 Bahasa Indonesia</a> |
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.ja.md">🇯🇵 日本語</a> |
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.ko.md">🇰🇷 한국어</a> |
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.vi.md">🇻🇳 Tiếng Việt</a> |
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.zh.md">🇨🇳 简体中文</a> |
|
||||
|
||||
791
README.ja.md
Normal file
791
README.ja.md
Normal file
@ -0,0 +1,791 @@
|
||||
# [UI UX Pro Max](https://uupm.cc)
|
||||
|
||||
<p align="center">
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.az.md">🇦🇿 Azərbaycanca</a> |
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.id.md">🇮🇩 Bahasa Indonesia</a> |
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.ja.md">🇯🇵 日本語</a> |
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.ko.md">🇰🇷 한국어</a> |
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.vi.md">🇻🇳 Tiếng Việt</a> |
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.zh.md">🇨🇳 简体中文</a> |
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.md">🇺🇸 English</a>
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/releases"><img src="https://img.shields.io/github/v/release/nextlevelbuilder/ui-ux-pro-max-skill?style=for-the-badge&color=blue" alt="GitHub Release"></a>
|
||||
<img src="https://img.shields.io/badge/reasoning_rules-192-green?style=for-the-badge" alt="192 Reasoning Rules">
|
||||
<img src="https://img.shields.io/badge/UI_styles-79_searchable-purple?style=for-the-badge" alt="79 searchable UI styles">
|
||||
<img src="https://img.shields.io/badge/python-3.x-yellow?style=for-the-badge&logo=python&logoColor=white" alt="Python 3.x">
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/LICENSE"><img src="https://img.shields.io/github/license/nextlevelbuilder/ui-ux-pro-max-skill?style=for-the-badge&color=green" alt="License"></a>
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
<a href="https://www.npmjs.com/package/ui-ux-pro-max-cli"><img src="https://img.shields.io/npm/v/ui-ux-pro-max-cli?style=flat-square&logo=npm&label=CLI" alt="npm"></a>
|
||||
<a href="https://www.npmjs.com/package/ui-ux-pro-max-cli"><img src="https://img.shields.io/npm/dm/ui-ux-pro-max-cli?style=flat-square&label=downloads" alt="npm downloads"></a>
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/stargazers"><img src="https://img.shields.io/github/stars/nextlevelbuilder/ui-ux-pro-max-skill?style=flat-square&logo=github" alt="GitHub stars"></a>
|
||||
<a href="https://paypal.me/uiuxpromax"><img src="https://img.shields.io/badge/PayPal-Support%20Development-00457C?style=flat-square&logo=paypal&logoColor=white" alt="PayPal"></a>
|
||||
</p>
|
||||
|
||||
An AI skill that provides design intelligence for building professional UI/UX across multiple platforms and frameworks.
|
||||
複数のプラットフォームとフレームワークで、プロフェッショナルな UI/UX を構築するためのデザインインテリジェンスを提供する AI スキルです。
|
||||
|
||||
<p align="center">
|
||||
<a href="https://uupm.cc">
|
||||
<img src="screenshots/website.png" alt="UI UX Pro Max" width="800">
|
||||
</a>
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
<b>役に立ったと感じたら、プロジェクトへのご支援をご検討ください:</b><br><br>
|
||||
<a href="https://paypal.me/uiuxpromax"><img src="https://img.shields.io/badge/PayPal-Donate-00457C?style=for-the-badge&logo=paypal&logoColor=white" alt="PayPal Donate"></a>
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
<i>その他のプロジェクト</i><br>
|
||||
<a href="https://nextlevelbuilder.io">NextLevelBuilder.io</a> | <a href="https://goclaw.sh">GoClaw.sh</a> | <a href="https://agentkit.best">AgentKit.best</a> | <a href="https://tose.sh">TOSE.sh</a>
|
||||
</p>
|
||||
|
||||
---
|
||||
|
||||
<p align="center">
|
||||
<span>新しいスキルもぜひご覧ください:</span>
|
||||
<br/>
|
||||
<a href="https://github.com/viettranx/3dviz-pro-max" target="_blank">
|
||||
<picture>
|
||||
<source media="(prefers-color-scheme: dark)" srcset="https://cdn.nextlevelbuilder.io/skills/3dviz/wordmark-dark.svg">
|
||||
<img src="https://cdn.nextlevelbuilder.io/skills/3dviz/wordmark.svg" alt="3Dviz Pro Max" height="56">
|
||||
</picture>
|
||||
</a>
|
||||
</p>
|
||||
|
||||
<p align="center"><b>アイデアを、探索したくなる 3D シーンに。</b></p>
|
||||
|
||||
<p align="center">
|
||||
<img src="https://cdn.nextlevelbuilder.io/skills/3dviz/harness-village.gif" width="800" alt="Harness Village:カメラナビゲーションと動き回る生き物がいるファンタジーの村">
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
<sub><b>ビジュアルのインスピレーションであり、ベンチマークではありません。</b> このスキルが存在する<i>前に</i>録画された、作者提供のプロジェクトです。UI にはベトナム語が含まれています。過去の映像であり、英語のデモでもスキルの実行時テストでもありません。<a href="https://github.com/viettranx/3dviz-pro-max/blob/main/docs/demos/README.md">メディアの出所</a>をご覧ください。</sub>
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
🤌 Web サイト:<a href="https://3dviz.dev/" target="_blank">https://3dviz.dev/</a>
|
||||
</p>
|
||||
|
||||
---
|
||||
|
||||
## v2.0 の新機能
|
||||
|
||||
### インテリジェントなデザインシステム生成
|
||||
|
||||
v2.0 の目玉機能は **Design System Generator** です。プロジェクトの要件を分析し、ニーズに合わせた完全なデザインシステムを数秒で生成する、AI を活用した推論エンジンです。
|
||||
|
||||
```
|
||||
+----------------------------------------------------------------------------------------+
|
||||
| TARGET: Serenity Spa - RECOMMENDED DESIGN SYSTEM |
|
||||
+----------------------------------------------------------------------------------------+
|
||||
| |
|
||||
| PATTERN: Hero-Centric + Social Proof |
|
||||
| Conversion: Emotion-driven with trust elements |
|
||||
| CTA: Above fold, repeated after testimonials |
|
||||
| Sections: |
|
||||
| 1. Hero |
|
||||
| 2. Services |
|
||||
| 3. Testimonials |
|
||||
| 4. Booking |
|
||||
| 5. Contact |
|
||||
| |
|
||||
| STYLE: Soft UI Evolution |
|
||||
| Keywords: Soft shadows, subtle depth, calming, premium feel, organic shapes |
|
||||
| Best For: Wellness, beauty, lifestyle brands, premium services |
|
||||
| Performance: cost:low | Accessibility: risk:conditional; verify requirements |
|
||||
| |
|
||||
| COLORS: |
|
||||
| Primary: #E8B4B8 (Soft Pink) |
|
||||
| Secondary: #A8D5BA (Sage Green) |
|
||||
| CTA: #D4AF37 (Gold) |
|
||||
| Background: #FFF5F5 (Warm White) |
|
||||
| Text: #2D3436 (Charcoal) |
|
||||
| Notes: Calming palette with gold accents for luxury feel |
|
||||
| |
|
||||
| TYPOGRAPHY: Cormorant Garamond / Montserrat |
|
||||
| Mood: Elegant, calming, sophisticated |
|
||||
| Best For: Luxury brands, wellness, beauty, editorial |
|
||||
| Google Fonts: https://fonts.google.com/share?selection.family=... |
|
||||
| |
|
||||
| KEY EFFECTS: |
|
||||
| Soft shadows + Context-appropriate transitions + Gentle hover states |
|
||||
| |
|
||||
| AVOID (Anti-patterns): |
|
||||
| Bright neon colors + Harsh animations + Dark mode + AI purple/pink gradients |
|
||||
| |
|
||||
| PRE-DELIVERY CHECKLIST: |
|
||||
| [ ] No emojis as icons (use SVG: Heroicons/Lucide) |
|
||||
| [ ] cursor-pointer on all clickable elements |
|
||||
| [ ] Interaction timing follows the platform, component, and user preference |
|
||||
| [ ] Light mode: text contrast 4.5:1 minimum |
|
||||
| [ ] Focus states visible for keyboard nav |
|
||||
| [ ] prefers-reduced-motion respected |
|
||||
| [ ] Text, chips, and badges reflow without clipping or broken labels |
|
||||
| [ ] Responsive: 375px, 768px, 1024px, 1440px |
|
||||
| |
|
||||
+----------------------------------------------------------------------------------------+
|
||||
```
|
||||
|
||||
### デザインシステム生成の仕組み
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ 1. USER REQUEST │
|
||||
│ "Build a landing page for my beauty spa" │
|
||||
└─────────────────────────────────────────────────────────────────┘
|
||||
│
|
||||
▼
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ 2. MULTI-DOMAIN SEARCH (5 parallel searches) │
|
||||
│ • Product type matching (192 categories) │
|
||||
│ • Style recommendations (79 searchable; 50 active) │
|
||||
│ • Color palette selection (192 palettes) │
|
||||
│ • Landing page patterns (34 patterns) │
|
||||
│ • Typography pairing (74 font combinations) │
|
||||
└─────────────────────────────────────────────────────────────────┘
|
||||
│
|
||||
▼
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ 3. REASONING ENGINE │
|
||||
│ • Match product → UI category rules │
|
||||
│ • Apply style priorities (BM25 ranking) │
|
||||
│ • Filter anti-patterns for industry │
|
||||
│ • Process decision rules (JSON conditions) │
|
||||
└─────────────────────────────────────────────────────────────────┘
|
||||
│
|
||||
▼
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ 4. COMPLETE DESIGN SYSTEM OUTPUT │
|
||||
│ Pattern + Style + Colors + Typography + Effects │
|
||||
│ + Anti-patterns to avoid + Pre-delivery checklist │
|
||||
└─────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### 192 の業界別推論ルール
|
||||
|
||||
推論エンジンには、次の分野向けの専用ルールが含まれています:
|
||||
|
||||
| カテゴリ | 例 |
|
||||
|----------|----------|
|
||||
| **テック & SaaS** | SaaS、Micro SaaS、B2B サービス、開発者ツール / IDE、AI/チャットボットプラットフォーム、サイバーセキュリティプラットフォーム |
|
||||
| **金融** | フィンテック/暗号資産、銀行、保険、個人の家計管理、請求書・課金ツール |
|
||||
| **ヘルスケア** | 医療クリニック、薬局、歯科、動物病院、メンタルヘルス、服薬リマインダー |
|
||||
| **E コマース** | 一般、ラグジュアリー、マーケットプレイス (P2P)、サブスクリプションボックス、フードデリバリー |
|
||||
| **サービス** | 美容/スパ、レストラン、ホテル、法律、ホームサービス、予約・アポイントメント |
|
||||
| **クリエイティブ** | ポートフォリオ、エージェンシー、写真、ゲーム、音楽ストリーミング、写真/動画編集 |
|
||||
| **ライフスタイル** | 習慣トラッカー、レシピ・料理、瞑想、天気、日記、気分トラッカー |
|
||||
| **新興テック** | Web3/NFT、空間コンピューティング、量子コンピューティング、自律型ドローン群 |
|
||||
|
||||
各ルールには次の内容が含まれます:
|
||||
- **Recommended Pattern** - ランディングページの構成
|
||||
- **Style Priority** - 最も適した UI スタイル
|
||||
- **Color Mood** - 業界にふさわしいパレット
|
||||
- **Typography Mood** - フォントの個性のマッチング
|
||||
- **Key Effects** - アニメーションとインタラクション
|
||||
- **Anti-Patterns** - やってはいけないこと(例:銀行向けの「AI purple/pink gradients」)
|
||||
|
||||
## 機能
|
||||
|
||||
- **79 の検索可能な UI スタイル(うち 50 が有効)** - Glassmorphism、Claymorphism、Minimalism、Brutalism、Neumorphism、Bento Grid、Dark Mode、AI-Native UI など
|
||||
- **192 のカラーパレット** - 192 のプロダクトタイプと 1:1 で対応した業界別のパレット
|
||||
- **74 のフォントペアリング** - Google Fonts のインポート付きで厳選したタイポグラフィの組み合わせ
|
||||
- **25 のチャートタイプ** - ダッシュボードや分析向けの推奨
|
||||
- **22 の技術スタック** - React、Next.js、Astro、Vue、Nuxt.js、Nuxt UI、Svelte、SwiftUI、React Native、Flutter、HTML+Tailwind、shadcn/ui、Jetpack Compose、Angular、Laravel、Three.js、JavaFX、WPF、WinUI 3、UWP、Avalonia、Uno Platform
|
||||
- **119 の UX ガイドライン** - ベストプラクティス、アンチパターン、アクセシビリティのルール、崩れにくいテキストレイアウト、コンパクトなラベル、キャンセル可能なインタラクション
|
||||
- **192 の推論ルール** - 業界別のデザインシステム生成(v2.0 の新機能)
|
||||
|
||||
### 崩れにくいテキストとコンパクトな UI
|
||||
|
||||
見出し、長いトークン、チップ、バッジ、中断されたマイクロインタラクションに関する、
|
||||
本番環境でよくある不具合もガイダンスでカバーするようになりました:
|
||||
|
||||
- 見出しのバランスの取れた折り返しはプログレッシブエンハンスメントであり、特定の単語が
|
||||
最終行に残ることを保証するものではありません。デザインは、幅、フォント、ロケールが変わっても、
|
||||
自然な折り返しで機能する必要があります。
|
||||
- 重要なテキストは、狭い幅、ブラウザのズーム、テキストの拡大、ユーザーによる間隔の上書きのもとでも、
|
||||
切れずにリフローする必要があります。長い URL や識別子は安全に折り返してかまいません。
|
||||
- チップやタグの集まりは、折り返すか、操作可能な `+n` の開示を使うべきです。コンパクトな
|
||||
ラベルは、可能な限り途切れずに表示されるべきです。やむを得ず省略する場合は、キーボード、ポインター、
|
||||
タッチのユーザーが完全な値にアクセスできる手段が必要です。
|
||||
- バッジの意味を色だけに頼ってはいけません。インタラクティブなチップには、ネイティブのセマンティクス、
|
||||
見えるフォーカス、プログラムから取得できる状態が必要です。ライブで変わるカウントには、意味のあるコンテキストが必要です。
|
||||
- 素早い操作によってアニメーションがキャンセルされることはあっても、最終的なセマンティックな状態、フォーカス、
|
||||
コンテンツは正しく保たれなければなりません。タイミングはプラットフォームとコンポーネントに合わせて選び、
|
||||
動きを減らす設定を尊重します。
|
||||
|
||||
### スタイルの分類
|
||||
|
||||
カタログには、安定した ID とエイリアスに裏付けられた **79 の検索可能なスタイル** が含まれています:
|
||||
|
||||
| ステータス | 数 | 検索時の動作 |
|
||||
|--------|------:|-----------------|
|
||||
| Active | 50 | 通常の推奨に含まれ、ギャラリーでデフォルトで表示されます |
|
||||
| Supplemental | 29 | 正確な指定や、明示的なバリアント/システムの意図がある場合に返されます。ギャラリーのステータスフィルターから利用できます |
|
||||
| Deprecated | 9 | 通常のランキングから除外されます。旧名称は正規のスタイルまたはランディングパターンにリダイレクトされます |
|
||||
|
||||
Active のセットには、43 の汎用的なビジュアルファミリー、2 つのモバイル専用スタイル、3 つの公式プラットフォーム/デザインシステム、1 つのプラットフォームマテリアル、1 つのコア分析スタイルが含まれます。現在の公式システムには Fluent 2、Shopify Polaris、Adobe Spectrum があります。Liquid Glass は Apple のプラットフォームマテリアルとして扱われ、Material 3 Expressive はモバイルの Material のバリアントのままで、Spectrum 2 は Supplemental です。ランディングページの構成は、BM25 のランキングでビジュアルスタイルと競合しないよう、34 パターンの別のランディングデータセットに分けられています。
|
||||
|
||||
完全な分類と、出所を考慮したメタデータについては [`styles.csv`](src/ui-ux-pro-max/data/styles.csv) をご覧ください。
|
||||
|
||||
## 💎 ベーシック版とプレミアム版の比較
|
||||
|
||||
オープンソース版とプレミアム版の違いについて、多くのご質問をいただいています。ワークフローに合ったものを選べるよう、詳しく説明します。
|
||||
|
||||
### 🟢 ベーシック版(このリポジトリ)
|
||||
* **完全なオープンソース:** 個人の開発者、趣味のプロジェクト、一般的なプロジェクトに最適です。
|
||||
* **コアの UI/UX インテリジェンス:** 79 の検索可能な UI スタイル(うち 50 が有効)、192 のプロダクトタイプ、カラーパレット、厳選したフォントペアリングをすべて利用できます。
|
||||
* **スマートな推奨:** 内蔵の BM25 検索エンジンにより、非常に精度の高いデザインのマッチングを行います。
|
||||
* **クロスプラットフォーム対応:** 22 の主要なフレームワーク(React、Vue、Tailwind、iOS、Android など)に対応したスタック別のガイドライン。
|
||||
* **デザインシステム生成:** CLI から、ニーズに合わせた UI のルール、パターン、ロジックをすぐに生成できます。
|
||||
|
||||
### 🟡 プレミアム版
|
||||
* **拡張されたブランドデザインスキル:** UI/UX にとどまらず、ブランドアイデンティティの生成、ロゴデザイン、コーポレートアイデンティティプログラム (CIP)、バナー、プレゼンテーションスライド、カスタムのアイコンまでカバーします。
|
||||
* **高度なアセット作成:** AI を活用した画像生成と深く統合し、プレースホルダーではなく実際のビジュアルアセットを作成します。
|
||||
* **エンタープライズ向けのアーキテクチャ:** 大規模なチームでの展開に向けた、より包括的でスケーラブルなデザイントークンのアーキテクチャ。
|
||||
* **優先サポート:** 中断のないデザインワークフロー全体を必要とするチームやプロフェッショナル向けの、専任の技術サポート。
|
||||
|
||||
👉 *プレミアム版へのアップグレードについて詳しくは、[uupm.cc](https://uupm.cc) をご覧ください。*
|
||||
|
||||
## インストール
|
||||
|
||||
### Claude Marketplace を使う (Claude Code)
|
||||
|
||||
2 つのコマンドで Claude Code に直接インストールできます:
|
||||
|
||||
```
|
||||
/plugin marketplace add nextlevelbuilder/ui-ux-pro-max-skill
|
||||
/plugin install ui-ux-pro-max@ui-ux-pro-max-skill
|
||||
```
|
||||
|
||||
### CLI を使う(推奨)
|
||||
|
||||
```bash
|
||||
# Install CLI globally
|
||||
npm install -g ui-ux-pro-max-cli
|
||||
|
||||
# Go to your project
|
||||
cd /path/to/your/project
|
||||
|
||||
# Install for your AI assistant
|
||||
uipro init --ai claude # Claude Code
|
||||
uipro init --ai cursor # Cursor
|
||||
uipro init --ai windsurf # Windsurf
|
||||
uipro init --ai antigravity # Antigravity
|
||||
uipro init --ai copilot # GitHub Copilot
|
||||
uipro init --ai kiro # Kiro
|
||||
uipro init --ai codex # Codex CLI
|
||||
uipro init --ai qoder # Qoder
|
||||
uipro init --ai roocode # Roo Code
|
||||
uipro init --ai gemini # Gemini CLI
|
||||
uipro init --ai trae # Trae
|
||||
uipro init --ai opencode # OpenCode
|
||||
uipro init --ai continue # Continue
|
||||
uipro init --ai codebuddy # CodeBuddy
|
||||
uipro init --ai droid # Droid (Factory)
|
||||
uipro init --ai kilocode # KiloCode
|
||||
uipro init --ai warp # Warp
|
||||
uipro init --ai augment # Augment
|
||||
uipro init --ai codewhale # CodeWhale
|
||||
uipro init --ai zcode # ZCode
|
||||
uipro init --ai kimi # Kimi Code
|
||||
uipro init --ai amazonq # Amazon Q Developer
|
||||
uipro init --ai openclaw # OpenClaw (.agents/skills/)
|
||||
uipro init --ai autoclaw # AutoClaw (skills/ or ~/.openclaw-autoclaw/skills)
|
||||
uipro init --ai universal # Universal / Agent Standard (.agents/skills/)
|
||||
uipro init --ai all # All assistants
|
||||
```
|
||||
|
||||
npm パッケージの名前は `ui-ux-pro-max-cli` で、インストールされるコマンドは引き続き `uipro` です。古い `uipro-cli` のリリースは更新されておらず、現在のアセットには使わないでください。
|
||||
|
||||
### グローバルインストール(すべてのプロジェクトで利用可能)
|
||||
|
||||
```bash
|
||||
uipro init --ai claude --global # Install to ~/.claude/skills/
|
||||
uipro init --ai cursor --global # Install to ~/.cursor/skills/
|
||||
uipro init --ai zcode --global # Install to ~/.zcode/skills/
|
||||
uipro init --ai kimi --global # Install to ~/.kimi-code/skills/
|
||||
uipro init --ai universal --global # Install to ~/.agents/skills/
|
||||
```
|
||||
|
||||
### その他の CLI コマンド
|
||||
|
||||
```bash
|
||||
uipro versions # List available versions
|
||||
uipro update # Refresh skill files from installed CLI package
|
||||
uipro update --global # Refresh global skill files from installed CLI package
|
||||
uipro init --offline # Compatibility flag; installs bundled templates
|
||||
uipro init --dry-run # Preview install actions without writing files
|
||||
uipro uninstall # Remove skill (auto-detect platform)
|
||||
uipro uninstall --ai claude # Remove specific platform
|
||||
uipro uninstall --global # Remove from global install
|
||||
```
|
||||
|
||||
## 前提条件
|
||||
|
||||
検索スクリプトには Python 3.x が必要です(標準ライブラリのみを使用します。スクリプトは何もインストールせず、ネットワーク通信も行いません)。
|
||||
|
||||
Python がインストールされているか確認します:
|
||||
|
||||
```bash
|
||||
python3 --version
|
||||
```
|
||||
|
||||
インストールされていない場合は、[python.org](https://www.python.org/downloads/) から、または OS のパッケージマネージャー(Homebrew、apt、winget)を使ってご自身でインストールしてください。これらのインストール手順は **人間のユーザーであるあなた** のためのものです。このスキルを使う AI エージェントがあなたのマシンにソフトウェアをインストールすることは決してなく、代わりにあなたに依頼するよう指示されています。
|
||||
|
||||
## 使い方
|
||||
|
||||
### スキルモード(自動で有効化)
|
||||
|
||||
**対応:** Claude Code、Cursor、Windsurf、Antigravity、Codex CLI、Continue、Gemini CLI、OpenCode、Qoder、CodeBuddy、Droid (Factory)、KiloCode、Warp、Augment、CodeWhale、ZCode、Kimi Code、Amazon Q Developer、OpenClaw、GitHub Copilot
|
||||
|
||||
UI/UX の作業を依頼すると、スキルが自動的に有効になります。普段どおりに話しかけるだけです:
|
||||
|
||||
```
|
||||
Build a landing page for my SaaS product
|
||||
```
|
||||
|
||||
> **Trae**: まず **SOLO** モードに切り替えてください。UI/UX のリクエストでスキルが有効になります。
|
||||
|
||||
### ワークフローモード(スラッシュコマンド)
|
||||
|
||||
**対応:** Kiro、Roo Code、KiloCode
|
||||
|
||||
スラッシュコマンドでスキルを呼び出します:
|
||||
|
||||
```
|
||||
/ui-ux-pro-max Build a landing page for my SaaS product
|
||||
```
|
||||
|
||||
### プロンプトの例
|
||||
|
||||
```
|
||||
Build a landing page for my SaaS product
|
||||
|
||||
Create a dashboard for healthcare analytics
|
||||
|
||||
Design a portfolio website with dark mode
|
||||
|
||||
Make a mobile app UI for e-commerce
|
||||
|
||||
Build a fintech banking app with dark theme
|
||||
```
|
||||
|
||||
### 既存のアプリにテーマを適用する
|
||||
|
||||
[スキルをインストール](#インストール)したら、AI アシスタントでアプリを開き、次のようなプロンプトを使ってください。ワークフローモードでは、先頭に `/ui-ux-pro-max` を付けてください。
|
||||
|
||||
```text
|
||||
Use the ui-ux-pro-max skill to retheme my existing React app.
|
||||
Target style: Minimalism & Swiss Style.
|
||||
First inspect the framework and styling-library versions, routes, components,
|
||||
styles, and existing theme tokens. Keep the current component structure,
|
||||
behavior, and business logic.
|
||||
Reuse and update the existing semantic tokens for colors, typography, spacing,
|
||||
radii, shadows, and interaction states; add missing tokens rather than creating
|
||||
a parallel theme system. Replace hard-coded styles one component at a time.
|
||||
Verify contrast, keyboard focus, responsive layouts, and all supported light/dark
|
||||
modes. Summarize changed files and any remaining hard-coded styles.
|
||||
```
|
||||
|
||||
`Minimalism & Swiss Style` は、お好みの[カタログのスタイル](src/ui-ux-pro-max/data/styles.csv)やビジュアルの方向性に置き換えてください。検索結果はデザインのガイダンスを提供するものであり、アプリを自動的に書き換えるものではありません。
|
||||
|
||||
**テーマ移行のチェックリスト:**
|
||||
|
||||
- **監査:** スタイルシート、インラインスタイル、`bg-blue-600` や `text-[#1e293b]` のようなユーティリティから、テーマに関するハードコードされた値を見つけます。
|
||||
- **対応付け:** アプリの既存のスタイリングシステムで、`background`、`surface`、`foreground`、`primary`、`border`、`ring` といったセマンティックな役割を再利用します。足りない役割は、インストールされているライブラリのバージョンの慣例に従って追加します。
|
||||
- **移行:** 小さなコンポーネント単位で、ハードコードされた値をトークンの参照に置き換えます。トークンを変更するだけでは、トークンを使っていないスタイルには反映されません。
|
||||
- **検証:** 各バッチのあとで、テキスト/UI のコントラスト、ホバー/フォーカス/無効の状態、レスポンシブレイアウト、対応しているすべてのテーマを確認します。
|
||||
|
||||
### 仕組み
|
||||
|
||||
1. **依頼する** - UI/UX のタスク(構築、デザイン、作成、実装、レビュー、修正、改善)を依頼します
|
||||
2. **デザインシステムの生成** - AI が推論エンジンを使って、完全なデザインシステムを自動的に生成します
|
||||
3. **スマートな推奨** - プロダクトタイプと要件に基づいて、最も適したスタイル、色、タイポグラフィを見つけます
|
||||
4. **コード生成** - 適切な色、フォント、余白、ベストプラクティスで UI を実装します
|
||||
5. **納品前のチェック** - よくある UI/UX のアンチパターンに照らして検証します
|
||||
|
||||
### 対応スタック
|
||||
|
||||
このスキルは、次のスタック向けのガイドラインを提供します:
|
||||
|
||||
| カテゴリ | スタック |
|
||||
|----------|--------|
|
||||
| **Web (HTML)** | HTML + Tailwind(デフォルト) |
|
||||
| **React エコシステム** | React、Next.js、shadcn/ui |
|
||||
| **Vue エコシステム** | Vue、Nuxt.js、Nuxt UI |
|
||||
| **Angular** | Angular |
|
||||
| **PHP** | Laravel (Blade、Livewire、Inertia.js) |
|
||||
| **その他の Web** | Svelte、Astro、Three.js |
|
||||
| **デスクトップ** | JavaFX、WPF、WinUI 3、Avalonia、Uno Platform、UWP |
|
||||
| **iOS** | SwiftUI |
|
||||
| **Android** | Jetpack Compose |
|
||||
| **クロスプラットフォーム** | React Native、Flutter |
|
||||
|
||||
プロンプトで使いたいスタックを伝えるだけです。指定しなければ HTML + Tailwind がデフォルトになります。
|
||||
|
||||
## 例
|
||||
|
||||
### ビフォー/アフター:運用ダッシュボード
|
||||
|
||||
シンプルな運用ダッシュボード([ビフォー](https://skill-fixture-before.theroost.dev))を、UI UX Pro Max が生成したデザインシステムだけを使ってスタイルを変更したものです([アフター](https://ui-ux-pro-max-after.theroost.dev))。生成には `search.py "internal operations dashboard" --design-system --density 8 --motion 3 --variance 4` を使っています。
|
||||
|
||||
*コミュニティから提供された参考例であり、スキルの公式デモ、ベンチマーク、実行時テストではありません。*
|
||||
|
||||
## デザインシステムコマンド(上級者向け)
|
||||
|
||||
デザインシステムジェネレーターに直接アクセスするには:
|
||||
|
||||
> 注:Continue でインストールした場合は、以下のコマンドの `.claude/skills/` を `.continue/skills/` に置き換えてください。Droid (Factory) では `.factory/skills/`、ZCode では `.zcode/skills/` を使います。Amazon Q Developer では `.amazonq/skills/` を使います(Amazon Q が自動で読み込むのは `.amazonq/rules/ui-ux-pro-max.md` のルールだけで、`.amazonq/skills/` 以下のデータとスクリプトは、そのルールが参照するファイルです)。
|
||||
|
||||
```bash
|
||||
# Generate design system with ASCII output
|
||||
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness" --design-system -p "Serenity Spa"
|
||||
|
||||
# Generate with Markdown output
|
||||
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "fintech banking" --design-system -f markdown
|
||||
|
||||
# Domain-specific search
|
||||
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "glassmorphism" --domain style
|
||||
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "elegant serif" --domain typography
|
||||
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "dashboard" --domain chart
|
||||
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "error summary validation" --domain ux
|
||||
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "decorative icon aria hidden" --domain icons
|
||||
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "icon button accessible label" --domain icons
|
||||
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "orphan heading line balance" --domain ux
|
||||
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "badge chip label wraps to second line" --domain ux
|
||||
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "rapid chip animation interrupted" --domain ux
|
||||
|
||||
# RTL / Arabic, Hebrew, Persian interfaces (style and product domains)
|
||||
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "dashboard" --domain style --rtl=full
|
||||
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "fintech" --domain product --rtl=partial
|
||||
|
||||
# Stack-specific guidelines
|
||||
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "form validation" --stack react
|
||||
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "responsive layout" --stack html-tailwind
|
||||
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "chip badge overflow nowrap" --stack html-tailwind
|
||||
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "tableview binding" --stack javafx
|
||||
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "atlantafx primer enterprise theme" --stack javafx
|
||||
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "enterprise tableview density permission" --stack javafx
|
||||
```
|
||||
|
||||
Web スタックの検索はバージョンを考慮します。古いメジャーバージョンを含まないクエリでは、現在の
|
||||
有効なガイダンスが返されます。明示的にレガシーな用語や古いメジャーバージョン(例:`Svelte 4`
|
||||
や `Next.js 15`)を指定すると、`Status` と `Applies To` でラベル付けされた、厳選したレガシーの行だけが返されます。
|
||||
該当するレガシーのガイダンスが用意されていない場合は、フレームワークの世代を混在させるのではなく、
|
||||
検索結果は空になります。
|
||||
|
||||
### RTL 互換性 (`--rtl`)
|
||||
|
||||
すべてのスタイルとプロダクトの行には、右から左に書く言語のインターフェース
|
||||
(アラビア語、ヘブライ語、ペルシャ語、ウルドゥー語)向けの `rtl_level` があります:
|
||||
|
||||
| レベル | 意味 |
|
||||
|-------|---------|
|
||||
| `full` | 方向に依存しません:レイアウトは反転してもそのまま機能します。 |
|
||||
| `partial` | きれいに反転しますが、個々のコンポーネントやモーションの調整が必要です。 |
|
||||
| `caveats` | スタイルやプロダクトが読む方向を前提としています(キネティックタイポグラフィ、LTR のタイムライン、コード/ターミナルの画面、地図や座席の並び順など)。 |
|
||||
|
||||
```bash
|
||||
# Only styles that mirror without extra work
|
||||
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "dashboard" --domain style --rtl=full
|
||||
|
||||
# All levels, filtered results still tagged with rtl_level
|
||||
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "mobile" --domain style --rtl
|
||||
```
|
||||
|
||||
`--rtl` には、明示的な `--domain style` または `--domain product` が必要です。フィルターは
|
||||
ランキングのあと、`-n/--max-results` による切り詰めの前に適用されるため、上限を小さくしても
|
||||
一致する行が隠れることはありません。`--design-system` や
|
||||
`--stack` と一緒に使うことはできません。
|
||||
|
||||
### デザインシステムの永続化(Master + Overrides パターン)
|
||||
|
||||
デザインシステムをファイルに保存して、**セッションをまたいだ階層的な取得** を行えます:
|
||||
|
||||
```bash
|
||||
# Generate and persist to design-system/myapp/MASTER.md
|
||||
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "SaaS dashboard" --design-system --persist -p "MyApp"
|
||||
|
||||
# Also create a page-specific override file
|
||||
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "SaaS dashboard" --design-system --persist -p "MyApp" --page "dashboard"
|
||||
```
|
||||
|
||||
これにより、次のような `design-system/` フォルダー構成が作成されます:
|
||||
|
||||
```
|
||||
design-system/
|
||||
└── myapp/ # One folder per project (slug of -p "MyApp")
|
||||
├── MASTER.md # Global Source of Truth (colors, typography, spacing, components)
|
||||
└── pages/
|
||||
└── dashboard.md # Page-specific overrides (only deviations from Master)
|
||||
```
|
||||
|
||||
**階層的な取得の仕組み:**
|
||||
1. 特定のページ(例:"Checkout")を作るときは、まず `design-system/[project-slug]/pages/checkout.md` を確認します
|
||||
2. ページのファイルが存在する場合、そのルールが Master ファイルを **上書き** します
|
||||
3. 存在しない場合は、`design-system/[project-slug]/MASTER.md` だけを使います
|
||||
|
||||
**コンテキストを考慮した取得のプロンプト:**
|
||||
```
|
||||
I am building the [Page Name] page. Please read design-system/[project-slug]/MASTER.md.
|
||||
Also check if design-system/[project-slug]/pages/[page-name].md exists.
|
||||
If the page file exists, prioritize its rules.
|
||||
If not, use the Master rules exclusively.
|
||||
Now, generate the code...
|
||||
```
|
||||
|
||||
## アーキテクチャとコントリビュート
|
||||
|
||||
### ユーザー向け
|
||||
|
||||
コードベースは **テンプレートベースの生成システム** を使うように再構成されました。プラットフォーム固有のファイル(`.cursor/`、`.windsurf/`、`.kiro/`、`.factory/` など)はすべて、CLI によって動的に生成されるようになりました。
|
||||
|
||||
**インストールには必ず CLI を使ってください:**
|
||||
|
||||
```bash
|
||||
npm install -g ui-ux-pro-max-cli
|
||||
uipro init --ai <platform>
|
||||
```
|
||||
|
||||
これにより、インストールした CLI パッケージに同梱された最新のテンプレートと、お使いの AI アシスタントに適したファイル構成が得られます。新しいリリースが公開されたら、まず npm パッケージを更新してください。
|
||||
|
||||
### コントリビューター向け
|
||||
|
||||
このプロジェクトにコントリビュートしたい場合:
|
||||
|
||||
```bash
|
||||
# 1. Clone the repository
|
||||
git clone https://github.com/nextlevelbuilder/ui-ux-pro-max-skill.git
|
||||
cd ui-ux-pro-max-skill
|
||||
|
||||
# 2. Understand the structure
|
||||
src/ui-ux-pro-max/ # Source of truth (data, scripts, templates)
|
||||
cli/ # CLI installer (generates files from templates)
|
||||
.claude/ # Local dev/test for Claude Code skill
|
||||
.factory/ # Local dev/test for Droid (Factory) skill
|
||||
|
||||
# 3. Make changes in src/ui-ux-pro-max/
|
||||
# - data/*.csv → Database files
|
||||
# - scripts/*.py → Search engine & design system
|
||||
# - templates/ → Platform-specific templates
|
||||
|
||||
# 4. Sync to CLI and test locally
|
||||
cd cli
|
||||
npm run sync:assets
|
||||
npm run check:assets
|
||||
npm run verify:data
|
||||
npm run typecheck
|
||||
|
||||
# 5. Build and test CLI
|
||||
# `npm run build` uses Bun when available and falls back to TypeScript compiler output after `npm ci`.
|
||||
npm run build
|
||||
node dist/index.js init --ai claude --offline # Test in a temp folder
|
||||
node dist/index.js init --ai claude --dry-run # Preview install actions (no writes)
|
||||
|
||||
# 6. Create PR (never push directly to main)
|
||||
git checkout -b feat/your-feature
|
||||
git commit -m "feat: description"
|
||||
git push -u origin feat/your-feature
|
||||
gh pr create
|
||||
```
|
||||
|
||||
詳しい開発ガイドラインについては [CLAUDE.md](CLAUDE.md) をご覧ください。
|
||||
|
||||
### カタログの出所と更新
|
||||
|
||||
コミット済みのカタログの概要には、現在 **1,934 の承認済み Google Fonts** と、
|
||||
公式のライセンスのメタデータが一致しない限り昇格されない **8 つのレビュー除外** が記録されています。
|
||||
アイコンのガイダンスは引き続き **105 の厳選した行**(100 の Phosphor の Web 向けの直接のインポートと、
|
||||
React Native/フォールバックのガイダンス)です。別に用意された
|
||||
**1,512 アイコンのアップストリームの Phosphor のマニフェスト** は、名前、
|
||||
ウェイト、React/SSR のインポートを検証するもので、アップストリームのパッケージ全体で検索結果があふれることはありません。
|
||||
|
||||
通常の開発とプルリクエストの CI は、ネットワークに依存しません。スナップショットのハッシュと
|
||||
生成されたカウントの検証を含む、完全なオフラインのゲートは次のコマンドで実行します:
|
||||
|
||||
```bash
|
||||
npm --prefix cli run verify:data
|
||||
# Or check only the generated catalog summary:
|
||||
npm --prefix cli run validate:catalog-summary
|
||||
```
|
||||
|
||||
更新の正規化も、コミット済みのフィクスチャに対して完全にオフラインで試すことができます。
|
||||
出力は一時的な候補ディレクトリに書き出され、正規のデータが
|
||||
置き換えられることはありません:
|
||||
|
||||
```bash
|
||||
candidate_dir="$(mktemp -d)"
|
||||
python3 scripts/refresh-google-fonts.py \
|
||||
--api-input src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-api.json \
|
||||
--metadata-input src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-metadata.json \
|
||||
--existing-csv src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-existing.csv \
|
||||
--overrides src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-overrides.json \
|
||||
--output-csv "$candidate_dir/google-fonts.csv" \
|
||||
--license-output "$candidate_dir/google-font-licenses.json" \
|
||||
--metadata-revision fixture-catalogs-v1 \
|
||||
--verified-at 2026-08-13 --expected-count 2 --approve-changes
|
||||
python3 scripts/refresh-icon-catalog.py \
|
||||
--input src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/phosphor-core.json \
|
||||
--package-json src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/phosphor-package.json \
|
||||
--react-package-json src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/phosphor-react-package.json \
|
||||
--react-exports-input src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/phosphor-react-exports.json \
|
||||
--curated-csv src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/icons-curated.csv \
|
||||
--output "$candidate_dir/phosphor-icons-upstream.json" \
|
||||
--verified-at 2026-08-13 --expected-count 2
|
||||
```
|
||||
|
||||
アップストリームからのライブの更新は、意図的に `refresh-catalogs.yml`
|
||||
ワークフローに分離されています。このワークフローは毎週月曜日の 03:17 UTC に実行されるほか、必要に応じて手動でも実行できます。
|
||||
GitHub Actions のシークレットとして `GOOGLE_FONTS_API_KEY` を設定し、ワークフローを実行して、
|
||||
レビュー用のアーティファクトをダウンロードしてください:
|
||||
|
||||
```bash
|
||||
gh workflow run refresh-catalogs.yml
|
||||
run_id="$(gh run list --workflow refresh-catalogs.yml --limit 1 --json databaseId --jq '.[0].databaseId')"
|
||||
gh run watch "$run_id"
|
||||
gh run download "$run_id" --name "catalog-refresh-review-$run_id"
|
||||
```
|
||||
|
||||
このワークフローは Google Fonts Developer API と、バージョンを固定した公式の Phosphor の
|
||||
パッケージを読み込み、候補と unified diff をアーティファクトに書き出します。リポジトリの権限は読み取り専用です。
|
||||
コミット、プッシュ、PR の作成、マージは一切行いません。候補のファイルを `src/ui-ux-pro-max/data/` に
|
||||
手動で昇格させる前に、変更レポート、除外、ライセンス、関連性の指標、オフラインのゲートを
|
||||
確認してください。
|
||||
|
||||
|
||||
## 自動リリース
|
||||
|
||||
このリポジトリでは、semantic-release と Conventional Commits を使って GitHub のリリースを自動的に作成しています:
|
||||
|
||||
- `dev` ブランチからは、`2.6.0-beta.1` のようなベータ版の GitHub プレリリースが作成されます。
|
||||
- `main` ブランチからは、`2.6.0` のような正式な安定版の GitHub リリースが作成されます。
|
||||
|
||||
リリースノートと `CHANGELOG.md` は、Conventional Commit のメッセージから生成されます。バージョン番号は、リリースの準備中に `skill.json`、`.claude-plugin/plugin.json`、`.claude-plugin/marketplace.json`、`cli/package.json`、`cli/package-lock.json` の間で同期されます。
|
||||
|
||||
正しくバージョンを上げるために、次のコミットタイプを使ってください:
|
||||
|
||||
- `fix:` -> パッチリリース
|
||||
- `feat:` -> マイナーリリース
|
||||
- `feat!:` または `BREAKING CHANGE:` -> メジャーリリース
|
||||
|
||||
リリースのワークフローは、GitHub のリリースにはデフォルトの `GITHUB_TOKEN` を使い、`ui-ux-pro-max-cli` を npm に公開するためにはリポジトリの `NPM_TOKEN` シークレットを使います。
|
||||
|
||||
## トラブルシューティング
|
||||
|
||||
### Claude Code で `response exceeded the ... output token maximum` と表示される
|
||||
|
||||
これは Claude Code の 1 回の応答に対する上限であり、UI/UX Pro Max のインストーラーや検索スクリプトのエラーではありません。まず、タスクを小さなステップに分け、大きな結果は少しずつファイルに書き出すよう Claude に依頼してください。
|
||||
|
||||
どうしても 1 回の応答を大きくする必要があり、使用中のモデルが対応している場合は、新しいセッションを始める前に Claude Code の出力トークンの上限を設定してください。例:
|
||||
|
||||
```bash
|
||||
# macOS, Linux, or WSL
|
||||
export CLAUDE_CODE_MAX_OUTPUT_TOKENS="64000"
|
||||
claude
|
||||
```
|
||||
|
||||
```powershell
|
||||
# Windows PowerShell
|
||||
$env:CLAUDE_CODE_MAX_OUTPUT_TOKENS = "64000"
|
||||
claude
|
||||
```
|
||||
|
||||
シェルの環境変数の変更は、そのシェルから起動したプログラムにしか適用されないため、変数を設定したら Claude Code を再起動してください。Claude Code は、使用中のモデルの出力上限を超える値を上限に丸めます。モデルやプロバイダーの上限はさまざまです。この値を大きくすると、レイテンシーや使用量が増えることもあり、自動コンパクションまでに使える実質的なコンテキストも少なくなります。公式の [Claude Code の環境変数のリファレンス](https://code.claude.com/docs/en/env-vars#variables)をご覧ください。
|
||||
|
||||
### `uipro: unknown command 'uninstall'` または `unknown command 'update'` と表示される
|
||||
|
||||
インストールされている `ui-ux-pro-max-cli` のバージョンが古くなっています。更新してから再試行してください:
|
||||
|
||||
```bash
|
||||
npm install -g ui-ux-pro-max-cli@latest
|
||||
uipro uninstall
|
||||
```
|
||||
|
||||
### `uipro uninstall` で "No installed AI skill directories detected" と表示される
|
||||
|
||||
コマンドを実行しているディレクトリとは別の場所にスキルがインストールされています。次のいずれかを行ってください:
|
||||
|
||||
```bash
|
||||
# Option A — run from the project root where you originally installed it
|
||||
cd /path/to/your/project
|
||||
uipro uninstall
|
||||
|
||||
# Option B — remove the global install
|
||||
uipro uninstall --global
|
||||
|
||||
# Option C — remove manually
|
||||
rm -rf .claude/skills/ui-ux-pro-max # Claude Code
|
||||
rm -rf .cursor/skills/ui-ux-pro-max # Cursor
|
||||
rm -rf .windsurf/skills/ui-ux-pro-max # Windsurf
|
||||
rm -rf .agents/skills/ui-ux-pro-max # Antigravity / Codex
|
||||
```
|
||||
|
||||
### Claude.ai の "Upload a skill" ダイアログで "Zip contains too many files (maximum 200)" と表示される
|
||||
|
||||
GitHub リポジトリの ZIP 全体をアップロードしないでください。これはソースコード、CLI のアセット、ドキュメント、プレビュー、複数の同梱スキルを含む開発用のチェックアウトなので、Claude の 200 ファイルのアップロード上限を超えてしまいます。Claude のスキルのアップロード用の成果物ではなく、このプロジェクトでは現在、Claude.ai に手動でアップロードするための ZIP を別途公開していません。
|
||||
|
||||
Claude Code では、Marketplace からインストールしてください:
|
||||
|
||||
```bash
|
||||
/plugin marketplace add nextlevelbuilder/ui-ux-pro-max-skill
|
||||
/plugin install ui-ux-pro-max@ui-ux-pro-max-skill
|
||||
```
|
||||
|
||||
または CLI のインストーラーを使ってください:
|
||||
|
||||
```bash
|
||||
npx ui-ux-pro-max-cli init --ai claude
|
||||
```
|
||||
|
||||
### Claude Marketplace からのインストールが "Zip file contains a symbolic link" で失敗する
|
||||
|
||||
これは v2.5.1 より前のバージョンの既知の問題です。リポジトリが内部でシンボリックリンクを使っていたため、一部のインストールツールで処理できませんでした。**解決策:** 代わりに CLI のインストーラーを使ってください:
|
||||
|
||||
```bash
|
||||
npm install -g ui-ux-pro-max-cli
|
||||
uipro init --ai claude
|
||||
```
|
||||
|
||||
または、この問題が解決される次のリリースをお待ちください。
|
||||
|
||||
### `npm install -g ui-ux-pro-max-cli` が権限エラーで失敗する
|
||||
|
||||
Node のバージョンマネージャーを使う(推奨)か、グローバルインストールをまったく行わないでください:
|
||||
|
||||
```bash
|
||||
# npx without installing globally
|
||||
npx ui-ux-pro-max-cli init --ai claude
|
||||
```
|
||||
|
||||
### デザインシステムのコマンドを実行すると Python が見つからない
|
||||
|
||||
検索スクリプトには Python 3.x が必要です。[python.org](https://www.python.org/downloads/) から、または OS のパッケージマネージャー(Homebrew、apt、winget)を使って手動でインストールしてください。AI エージェントがあなたの代わりにインストールすることはなく、代わりにあなたに依頼するよう指示されています。
|
||||
|
||||
### デザインシステムの出力が途中で切れる / フィールドが省略される
|
||||
|
||||
人が読む形式の出力では、長いフィールドは 300 文字で省略されます。省略されていない完全なデータを得るには `--json` を使ってください:
|
||||
|
||||
```bash
|
||||
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "SaaS" --domain style --json
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## スターの推移
|
||||
|
||||
[](https://star-history.dera.page/#nextlevelbuilder/ui-ux-pro-max-skill&Date)
|
||||
|
||||
## ライセンス
|
||||
|
||||
このプロジェクトは [MIT License](LICENSE) のもとでライセンスされています。
|
||||
|
||||
## 対応エージェント
|
||||
|
||||
このスキルは次のエージェントで動作します:
|
||||
- [Claude Code](https://claude.com/product/claude-code)
|
||||
- [AdaL](https://sylph.ai/) - 自己進化する AI コーディングエージェント ([Docs](https://docs.sylph.ai/) | [GitHub](https://github.com/SylphAI-Inc/adal-cli))
|
||||
@ -2,6 +2,7 @@
|
||||
|
||||
<p align="center">
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.id.md">🇮🇩 Bahasa Indonesia</a> |
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.ja.md">🇯🇵 日本語</a> |
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.ko.md">🇰🇷 한국어</a> |
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.vi.md">🇻🇳 Tiếng Việt</a> |
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.zh.md">🇨🇳 简体中文</a> |
|
||||
|
||||
@ -3,6 +3,7 @@
|
||||
<p align="center">
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.az.md">🇦🇿 Azərbaycanca</a> |
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.id.md">🇮🇩 Bahasa Indonesia</a> |
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.ja.md">🇯🇵 日本語</a> |
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.ko.md">🇰🇷 한국어</a> |
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.vi.md">🇻🇳 Tiếng Việt</a> |
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.zh.md">🇨🇳 简体中文</a> |
|
||||
|
||||
@ -2,6 +2,7 @@
|
||||
|
||||
<p align="center">
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.id.md">🇮🇩 Bahasa Indonesia</a> |
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.ja.md">🇯🇵 日本語</a> |
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.ko.md">🇰🇷 한국어</a> |
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.vi.md">🇻🇳 Tiếng Việt</a> |
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.zh.md">🇨🇳 简体中文</a> |
|
||||
|
||||
@ -2,6 +2,7 @@
|
||||
|
||||
<p align="center">
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.id.md">🇮🇩 Bahasa Indonesia</a> |
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.ja.md">🇯🇵 日本語</a> |
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.ko.md">🇰🇷 한국어</a> |
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.vi.md">🇻🇳 Tiếng Việt</a> |
|
||||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.zh.md">🇨🇳 简体中文</a> |
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user