From dd9a1b4cf9f67ca2e326f646d93e101b2778db30 Mon Sep 17 00:00:00 2001 From: Ikko Eltociear Ashimine Date: Wed, 4 Nov 2026 16:05:53 +0900 Subject: [PATCH] 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. --- README.az.md | 1 + README.id.md | 1 + README.ja.md | 791 +++++++++++++++++++++++++++++++++++++++++++++++++++ README.ko.md | 1 + README.md | 1 + README.vi.md | 1 + README.zh.md | 1 + 7 files changed, 797 insertions(+) create mode 100644 README.ja.md diff --git a/README.az.md b/README.az.md index a412dcd..8b04520 100644 --- a/README.az.md +++ b/README.az.md @@ -3,6 +3,7 @@

🇊🇿 Azərbaycanca | 🇮🇩 Bahasa Indonesia | + 🇯🇵 日本語 | 🇰🇷 한국얎 | 🇻🇳 Tiếng Việt | 🇚🇳 简䜓䞭文 | diff --git a/README.id.md b/README.id.md index 7b8cd7b..43769fb 100644 --- a/README.id.md +++ b/README.id.md @@ -2,6 +2,7 @@

🇮🇩 Bahasa Indonesia | + 🇯🇵 日本語 | 🇰🇷 한국얎 | 🇻🇳 Tiếng Việt | 🇚🇳 简䜓䞭文 | diff --git a/README.ja.md b/README.ja.md new file mode 100644 index 0000000..d3baed0 --- /dev/null +++ b/README.ja.md @@ -0,0 +1,791 @@ +# [UI UX Pro Max](https://uupm.cc) + +

+ 🇊🇿 Azərbaycanca | + 🇮🇩 Bahasa Indonesia | + 🇯🇵 日本語 | + 🇰🇷 한국얎 | + 🇻🇳 Tiếng Việt | + 🇚🇳 简䜓䞭文 | + 🇺🇞 English +

+ +

+ GitHub Release + 192 Reasoning Rules + 79 searchable UI styles + Python 3.x + License +

+ +

+ npm + npm downloads + GitHub stars + PayPal +

+ +An AI skill that provides design intelligence for building professional UI/UX across multiple platforms and frameworks. +耇数のプラットフォヌムずフレヌムワヌクで、プロフェッショナルな UI/UX を構築するためのデザむンむンテリゞェンスを提䟛する AI スキルです。 + +

+ + UI UX Pro Max + +

+ +

+ 圹に立ったず感じたら、プロゞェクトぞのご支揎をご怜蚎ください

+ PayPal Donate +

+ +

+ その他のプロゞェクト
+ NextLevelBuilder.io | GoClaw.sh | AgentKit.best | TOSE.sh +

+ +--- + +

+ 新しいスキルもぜひご芧ください +
+ + + + 3Dviz Pro Max + + +

+ +

アむデアを、探玢したくなる 3D シヌンに。

+ +

+ Harness Villageカメラナビゲヌションず動き回る生き物がいるファンタゞヌの村 +

+ +

+ ビゞュアルのむンスピレヌションであり、ベンチマヌクではありたせん。 このスキルが存圚する前に録画された、䜜者提䟛のプロゞェクトです。UI にはベトナム語が含たれおいたす。過去の映像であり、英語のデモでもスキルの実行時テストでもありたせん。メディアの出所をご芧ください。 +

+ +

+ 🀌 Web サむトhttps://3dviz.dev/ +

+ +--- + +## 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 +``` + +これにより、むンストヌルした 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 +``` + +--- + +## スタヌの掚移 + +[![Star History Chart](https://star-history.dera.page/svg?repos=nextlevelbuilder/ui-ux-pro-max-skill&type=Date)](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)) diff --git a/README.ko.md b/README.ko.md index 10b3163..b318441 100644 --- a/README.ko.md +++ b/README.ko.md @@ -2,6 +2,7 @@

🇮🇩 Bahasa Indonesia | + 🇯🇵 日本語 | 🇰🇷 한국얎 | 🇻🇳 Tiếng Việt | 🇚🇳 简䜓䞭文 | diff --git a/README.md b/README.md index 0a09139..de6da11 100755 --- a/README.md +++ b/README.md @@ -3,6 +3,7 @@

🇊🇿 Azərbaycanca | 🇮🇩 Bahasa Indonesia | + 🇯🇵 日本語 | 🇰🇷 한국얎 | 🇻🇳 Tiếng Việt | 🇚🇳 简䜓䞭文 | diff --git a/README.vi.md b/README.vi.md index ad70eef..38fc7cd 100644 --- a/README.vi.md +++ b/README.vi.md @@ -2,6 +2,7 @@

🇮🇩 Bahasa Indonesia | + 🇯🇵 日本語 | 🇰🇷 한국얎 | 🇻🇳 Tiếng Việt | 🇚🇳 简䜓䞭文 | diff --git a/README.zh.md b/README.zh.md index 2b11f96..18abbc6 100644 --- a/README.zh.md +++ b/README.zh.md @@ -2,6 +2,7 @@

🇮🇩 Bahasa Indonesia | + 🇯🇵 日本語 | 🇰🇷 한국얎 | 🇻🇳 Tiếng Việt | 🇚🇳 简䜓䞭文 |