mirror of
https://github.com/nextlevelbuilder/ui-ux-pro-max-skill.git
synced 2026-11-18 08:10:32 +00:00
770 lines
56 KiB
Markdown
770 lines
56 KiB
Markdown
# [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> |
|
||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.fr.md">🇫🇷 Français</a> |
|
||
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.fa.md">🇮🇷 فارسی</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-80_searchable-purple?style=for-the-badge" alt="80 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>
|
||
|
||
یک مهارت هوش مصنوعی که برای ساخت رابطهای کاربری حرفهای (UI) و تجربههای کاربری (UX) در پلتفرمها و فریمورکهای مختلف، هوشمندی و راهنماییهای تخصصی طراحی ارائه میکند.
|
||
|
||
<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>ایدهٔ خود را به یک صحنهٔ سهبعدی تبدیل کنید که ارزش کاوش داشته باشد.</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> این پروژهٔ ارائهشده توسط نویسنده، پیش از ایجاد این مهارت ضبط شده است؛ رابط کاربری آن شامل زبان ویتنامی است. این ویدئو صرفاً محتوایی تاریخی است، نه دموی انگلیسی یا آزمایش زمان اجرای مهارت. برای اطلاعات منبع رسانه به <a href="https://github.com/viettranx/3dviz-pro-max/blob/main/docs/demos/README.md">مستندات منشأ رسانه</a> مراجعه کنید.</sub>
|
||
</p>
|
||
|
||
<p align="center">
|
||
🤌 وبسایت: <a href="https://3dviz.dev/" target="_blank">https://3dviz.dev/</a>
|
||
</p>
|
||
|
||
---
|
||
|
||
## تازههای نسخهٔ 2.0
|
||
|
||
### تولید هوشمند سیستم طراحی
|
||
|
||
مهمترین قابلیت نسخهٔ 2.0، **مولد سیستم طراحی (Design System Generator)** است؛ یک موتور استدلال مبتنی بر هوش مصنوعی که نیازمندیهای پروژهٔ شما را تحلیل میکند و در چند ثانیه یک سیستم طراحی کامل و متناسب با همان پروژه میسازد.
|
||
|
||
نمونهٔ زیر یک سیستم طراحی پیشنهادی برای یک مرکز اسپا را نشان میدهد. ساختار، مقادیر و کدهای نمونه برای حفظ خوانایی و امکان مقایسه، بدون تغییر نگه داشته شدهاند:
|
||
|
||
```text
|
||
+----------------------------------------------------------------------------------------+
|
||
| 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 |
|
||
| |
|
||
+----------------------------------------------------------------------------------------+
|
||
```
|
||
|
||
### تولید سیستم طراحی چگونه کار میکند؟
|
||
|
||
```text
|
||
┌─────────────────────────────────────────────────────────────────┐
|
||
│ 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 (80 searchable; 51 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 │
|
||
└─────────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
### ۱۹۲ قانون استدلال متناسب با صنایع مختلف
|
||
|
||
موتور استدلال شامل قوانین تخصصی برای حوزههای زیر است:
|
||
|
||
| دستهبندی | نمونهها |
|
||
|----------|----------|
|
||
| **فناوری و SaaS** | SaaS، Micro SaaS، خدمات B2B، ابزار توسعهدهنده / IDE، پلتفرم هوش مصنوعی و چتبات، پلتفرم امنیت سایبری |
|
||
| **مالی** | فینتک/رمزارز، بانکداری، بیمه، مدیریت مالی شخصی، ابزار صدور فاکتور و صورتحساب |
|
||
| **سلامت و درمان** | کلینیک پزشکی، داروخانه، دندانپزشکی، دامپزشکی، سلامت روان، یادآور مصرف دارو |
|
||
| **تجارت الکترونیک** | فروشگاه عمومی، فروشگاه لوکس، بازارگاه (P2P)، جعبهٔ اشتراکی، تحویل غذا |
|
||
| **خدمات** | زیبایی/اسپا، رستوران، هتل، خدمات حقوقی، خدمات منزل، رزرو و نوبتدهی |
|
||
| **خلاقیت** | نمونهکار، آژانس، عکاسی، بازی، پخش موسیقی، ویرایش عکس/ویدئو |
|
||
| **سبک زندگی** | پیگیری عادتها، دستور پخت و آشپزی، مدیتیشن، آبوهوا، دفتر خاطرات، پیگیری خلقوخو |
|
||
| **فناوریهای نوظهور** | Web3/NFT، رایانش فضایی، رایانش کوانتومی، ناوگان پهپادهای خودران |
|
||
|
||
هر قانون شامل موارد زیر است:
|
||
|
||
- **الگوی پیشنهادی (Recommended Pattern):** ساختار صفحهٔ فرود
|
||
- **اولویت سبک (Style Priority):** سبکهای رابط کاربری که بیشترین تطابق را دارند
|
||
- **حالوهوای رنگ (Color Mood):** پالتهای متناسب با صنعت
|
||
- **حالوهوای تایپوگرافی (Typography Mood):** شخصیت و حسوحال فونت
|
||
- **جلوههای کلیدی (Key Effects):** انیمیشنها و تعاملها
|
||
- **الگوهای نامناسب (Anti-Patterns):** مواردی که نباید استفاده شوند؛ برای مثال، استفاده از گرادیانهای بنفش/صورتی هوش مصنوعی برای یک سامانهٔ بانکداری
|
||
|
||
## قابلیتها
|
||
|
||
- **۷۹ سبک رابط کاربری قابل جستوجو (۵۰ سبک فعال):** از جمله Glassmorphism، Claymorphism، Minimalism، Brutalism، Neumorphism، Bento Grid، Dark Mode، AI-Native UI و موارد دیگر
|
||
- **۱۹۲ پالت رنگ:** پالتهای اختصاصی هر صنعت که بهصورت یکبهیک با ۱۹۲ نوع محصول هماهنگ شدهاند
|
||
- **۷۴ ترکیب فونت:** ترکیبهای گزینششدهٔ تایپوگرافی همراه با امکان واردکردن فونت از Google Fonts
|
||
- **۲۵ نوع نمودار:** پیشنهادهایی برای داشبوردها و تحلیل داده
|
||
- **۲۲ پشتهٔ فناوری:** 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
|
||
- **۱۱۹ راهنمای UX:** بهترین روشها، الگوهای نامناسب، قواعد دسترسپذیری، چیدمان مقاوم متن، برچسبهای فشرده و تعاملهای قابل لغو
|
||
- **۱۹۲ قانون استدلال:** تولید سیستم طراحی متناسب با صنعت (قابلیت جدید در نسخهٔ 2.0)
|
||
|
||
### متن انعطافپذیر و رابط کاربری فشرده
|
||
|
||
راهنماها اکنون خطاهای رایج محیط واقعی محصول را نیز پوشش میدهند؛ از جمله مشکلات عنوانها، واژههای طولانی، چیپها، نشانها و تعاملهای کوتاه که ممکن است نیمهکاره قطع شوند:
|
||
|
||
- شکستن متعادل سطرهای عنوان، یک بهبود تدریجی است و تضمین نمیکند که واژهای مشخص حتماً در آخرین خط قرار بگیرد. طراحی باید با شکستن طبیعی متن در عرضها، فونتها و زبانهای مختلف نیز درست کار کند.
|
||
- متنهای ضروری نباید در عرضهای کم، بزرگنمایی مرورگر، تغییر مقیاس متن یا تنظیم فاصلهگذاری توسط کاربر بریده شوند. نشانیهای اینترنتی و شناسههای طولانی باید بتوانند بهشکل ایمن به سطر بعد منتقل شوند.
|
||
- مجموعهٔ چیپها و برچسبها باید به سطر بعد منتقل شوند یا امکان نمایش موارد بیشتر با گزینهای مانند `+n` داشته باشند. در صورت امکان، برچسب فشرده باید کامل نمایش داده شود؛ اگر کوتاهسازی اجتنابناپذیر است، کاربران صفحهکلید، ماوس و صفحهٔ لمسی باید راهی دسترسپذیر برای مشاهدهٔ مقدار کامل داشته باشند.
|
||
- معنای نشانها نباید فقط به رنگ وابسته باشد. چیپهای تعاملی باید معنای بومی و استاندارد، حالت تمرکز قابل مشاهده و وضعیت قابل تشخیص برای فناوریهای کمکی داشته باشند؛ شمارندههای زنده نیز باید زمینهٔ معناداری ارائه کنند.
|
||
- تعاملهای سریع ممکن است باعث لغو انیمیشن شوند، اما وضعیت معنایی نهایی، تمرکز و محتوا باید همچنان صحیح باقی بمانند. زمانبندی باید متناسب با پلتفرم و مؤلفه انتخاب شود و ترجیح کاربر برای کاهش حرکت نیز رعایت شود.
|
||
|
||
### دستهبندی سبکها
|
||
|
||
این کاتالوگ شامل **۷۹ سبک قابل جستوجو** است که با شناسهها و نامهای جایگزین پایدار پشتیبانی میشوند:
|
||
|
||
| وضعیت | تعداد | رفتار جستوجو |
|
||
|--------|------:|----------------|
|
||
| فعال (Active) | ۵۰ | در پیشنهادهای معمول قرار میگیرند و بهصورت پیشفرض در گالری نمایش داده میشوند |
|
||
| تکمیلی (Supplemental) | ۲۹ | برای درخواستهای دقیق یا اشارهٔ صریح به گونه/سیستم برگردانده میشوند؛ از طریق فیلتر وضعیت گالری نیز در دسترساند |
|
||
| منسوخ (Deprecated) | ۹ | از رتبهبندی معمول کنار گذاشته شدهاند؛ نامهای قدیمی به سبک یا الگوی صفحهٔ فرود مرجع هدایت میشوند |
|
||
|
||
مجموعهٔ فعال شامل ۴۳ خانوادهٔ بصری عمومی، ۲ سبک ویژهٔ موبایل، ۴ سیستم رسمی پلتفرم/طراحی، ۱ متریال پلتفرمی و ۱ سبک اصلی تحلیل داده است. سیستمهای رسمی فعلی شامل Fluent 2، Shopify Polaris، Adobe Spectrum و Apple Native Experience هستند؛ Liquid Glass بهعنوان متریال پلتفرم اپل در نظر گرفته شده، Material 3 Expressive همچنان یک گونهٔ موبایلی از Material است و Spectrum 2 در گروه سبکهای تکمیلی قرار دارد. ساختارهای صفحهٔ فرود در مجموعهدادهٔ جداگانهای با ۳۴ الگو نگهداری میشوند و در رتبهبندی BM25 با سبکهای بصری رقابت نمیکنند.
|
||
|
||
برای مشاهدهٔ دستهبندی کامل و فرادادههای دارای اطلاعات منشأ، فایل [`styles.csv`](src/ui-ux-pro-max/data/styles.csv) را ببینید.
|
||
|
||
## 💎 مقایسهٔ نسخهٔ پایه و نسخهٔ پریمیوم
|
||
|
||
بسیاری از کاربران دربارهٔ تفاوت نسخهٔ متنباز و نسخهٔ پریمیوم سؤال میکنند. در ادامه جزئیات آمده است تا بتوانید نسخهٔ مناسب جریان کاری خود را انتخاب کنید.
|
||
|
||
### 🟢 نسخهٔ پایه (همین مخزن)
|
||
|
||
- **کاملاً متنباز:** مناسب توسعهدهندگان مستقل، علاقهمندان و پروژههای معمول
|
||
- **هوشمندی اصلی UI/UX:** دسترسی کامل به ۷۹ سبک قابل جستوجو (۵۰ سبک فعال)، ۱۹۲ نوع محصول، پالتهای رنگ و ترکیبهای گزینششدهٔ فونت
|
||
- **پیشنهادهای هوشمند:** موتور جستوجوی داخلی BM25 برای تطبیق دقیق طراحی
|
||
- **پشتیبانی چندپلتفرمی:** راهنماهای اختصاصی برای ۲۲ فریمورک و فناوری اصلی (React، Vue، Tailwind، iOS، Android و غیره)
|
||
- **تولید سیستم طراحی:** تولید فوری قوانین، الگوها و منطق UI متناسب با پروژه از طریق CLI
|
||
|
||
### 🟡 نسخهٔ پریمیوم
|
||
|
||
- **مهارتهای گستردهتر طراحی برند:** فراتر از UI/UX؛ شامل تولید هویت برند، طراحی لوگو، برنامههای هویت سازمانی (CIP)، بنر، اسلاید ارائه و طراحی آیکون اختصاصی
|
||
- **ساخت پیشرفتهٔ داراییهای بصری:** یکپارچگی عمیق با تولید تصویر مبتنی بر هوش مصنوعی برای ساخت داراییهای بصری واقعی، نه صرفاً تصاویر جایگزین
|
||
- **معماری سازمانی:** معماری جامعتر و مقیاسپذیرتر توکنهای طراحی، مناسب استقرار در تیمهای بزرگ
|
||
- **پشتیبانی اولویتدار:** کمک فنی اختصاصی برای تیمها و متخصصانی که به جریان کاری طراحی کامل و بدون وقفه نیاز دارند
|
||
|
||
👉 *برای جزئیات بیشتر دربارهٔ ارتقا به نسخهٔ پریمیوم، به [uupm.cc](https://uupm.cc) مراجعه کنید.*
|
||
|
||
## نصب
|
||
|
||
### از طریق Claude Marketplace (Claude Code)
|
||
|
||
با اجرای دو دستور زیر، مستقیماً در Claude Code نصب کنید:
|
||
|
||
```text
|
||
/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 نصب نیست، آن را از [python.org](https://www.python.org/downloads/) یا با مدیر بستهٔ سیستمعامل خود (Homebrew، apt یا winget) نصب کنید. این مراحل نصب برای **شما، بهعنوان کاربر انسانی** هستند؛ عاملهای هوش مصنوعی که از این مهارت استفاده میکنند نباید خودسرانه نرمافزاری روی دستگاه شما نصب کنند و طبق دستورالعمل باید ابتدا از شما اجازه بخواهند.
|
||
|
||
## نحوهٔ استفاده
|
||
|
||
### حالت مهارت (فعالسازی خودکار)
|
||
|
||
**پشتیبانیشده:** 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 بهصورت خودکار فعال میشود. کافی است به زبان طبیعی درخواست خود را مطرح کنید:
|
||
|
||
```text
|
||
Build a landing page for my SaaS product
|
||
```
|
||
|
||
> **Trae:** ابتدا حالت **SOLO** را فعال کنید. سپس مهارت برای درخواستهای UI/UX فعال خواهد شد.
|
||
|
||
### حالت جریان کاری (فرمان اسلش)
|
||
|
||
**پشتیبانیشده:** Kiro، Roo Code و KiloCode
|
||
|
||
برای فراخوانی مهارت از فرمان اسلش استفاده کنید:
|
||
|
||
```text
|
||
/ui-ux-pro-max Build a landing page for my SaaS product
|
||
```
|
||
|
||
### نمونه درخواستها
|
||
|
||
```text
|
||
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
|
||
```
|
||
|
||
### اعمال یک تم روی برنامهٔ موجود
|
||
|
||
پس از [نصب مهارت](#نصب)، برنامهٔ خود را در دستیار هوش مصنوعی باز کنید و درخواستی مشابه نمونهٔ زیر بدهید. در حالت Workflow، عبارت `/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) یا جهتگیری بصری موردنظرتان جایگزین کنید. نتایج جستوجو راهنمای طراحی ارائه میکنند؛ اما بهصورت خودکار کد برنامهٔ شما را بازنویسی نمیکنند.
|
||
|
||
**چکلیست تغییر تم:**
|
||
|
||
- **بررسی (Audit):** مقادیر ثابت و hard-coded مرتبط با تم را در stylesheetها، استایلهای درونخطی و ابزارهایی مانند `bg-blue-600` یا `text-[#1e293b]` پیدا کنید.
|
||
- **نگاشت (Map):** نقشهای معنایی مانند `background`، `surface`، `foreground`، `primary`، `border` و `ring` را در سیستم استایل فعلی برنامه بهکار بگیرید. نقشهای لازم را مطابق قراردادهای نسخهٔ نصبشدهٔ کتابخانه اضافه کنید.
|
||
- **مهاجرت (Migrate):** مقادیر ثابت را در دستههای کوچک از مؤلفهها با ارجاع به توکنها جایگزین کنید. تغییر توکنها بهتنهایی روی استایلهایی که از آنها استفاده نمیکنند اثری ندارد.
|
||
- **اعتبارسنجی (Verify):** کنتراست متن و رابط، حالتهای hover/focus/disabled، چیدمان واکنشگرا و تمام تمهای پشتیبانیشده را پس از هر مرحله بررسی کنید.
|
||
|
||
### سازوکار عملکرد
|
||
|
||
1. **شما درخواست میدهید:** هر نوع کار UI/UX را درخواست میکنید (ساخت، طراحی، ایجاد، پیادهسازی، بازبینی، رفع اشکال یا بهبود).
|
||
2. **سیستم طراحی تولید میشود:** هوش مصنوعی با استفاده از موتور استدلال، بهطور خودکار یک سیستم طراحی کامل تولید میکند.
|
||
3. **پیشنهادهای هوشمند ارائه میشوند:** بر اساس نوع محصول و نیازمندیهای شما، سبکها، رنگها و تایپوگرافی مناسب انتخاب میشوند.
|
||
4. **کد تولید میشود:** رابط با رنگها، فونتها، فاصلهگذاری و بهترین روشهای طراحی پیادهسازی میشود.
|
||
5. **بررسیهای پیش از تحویل انجام میشوند:** خروجی از نظر الگوهای نامناسب رایج در UI/UX اعتبارسنجی میشود.
|
||
|
||
### پشتههای فناوری پشتیبانیشده
|
||
|
||
این مهارت برای فناوریهای زیر راهنمای اختصاصی ارائه میدهد:
|
||
|
||
| دستهبندی | فناوریها |
|
||
|----------|-----------|
|
||
| **وب (HTML)** | HTML + Tailwind (پیشفرض) |
|
||
| **اکوسیستم React** | React، Next.js، shadcn/ui |
|
||
| **اکوسیستم Vue** | Vue، Nuxt.js، Nuxt UI |
|
||
| **Angular** | Angular |
|
||
| **PHP** | Laravel (Blade، Livewire، Inertia.js) |
|
||
| **سایر فناوریهای وب** | 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
|
||
```
|
||
|
||
جستوجوی پشتههای وب با نسخهٔ فناوری سازگار است. جستوجوهایی که نسخهٔ قدیمیتری را مشخص نمیکنند، راهنمای فعال و فعلی را برمیگردانند. عبارتهای صریح قدیمی یا نسخههای پیشین (برای مثال `Svelte 4` یا `Next.js 15`) فقط ردیفهای گزینششدهٔ مربوط به نسخههای قدیمی را برمیگردانند و با برچسبهای `Status` و `Applies To` مشخص میشوند. اگر راهنمای قدیمی منطبق وجود نداشته باشد، بهجای ترکیب نسلهای مختلف فریمورک، نتیجهای برگردانده نمیشود.
|
||
|
||
### سازگاری RTL (`--rtl`)
|
||
|
||
هر ردیف سبک و محصول دارای مقدار `rtl_level` برای رابطهای راستبهچپ (عربی، عبری، فارسی و اردو) است:
|
||
|
||
| سطح | معنی |
|
||
|-----|------|
|
||
| `full` | مستقل از جهت نوشتار است؛ چیدمان بدون تغییر خاصی پس از آینهایشدن نیز درست کار میکند. |
|
||
| `partial` | بهخوبی آینهای میشود، اما برخی مؤلفهها و حرکتها به تنظیم نیاز دارند. |
|
||
| `caveats` | سبک یا محصول به جهت خواندن وابسته است؛ مانند تایپوگرافی جنبشی، خط زمانی چپبهراست، محیط کد/ترمینال، نقشهها و ترتیب صندلیها. |
|
||
|
||
```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/` را ایجاد میکند:
|
||
|
||
```text
|
||
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` استفاده کنید.
|
||
|
||
**نمونهٔ درخواست برای بازیابی آگاه از زمینه:**
|
||
|
||
```text
|
||
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...
|
||
```
|
||
|
||
## معماری و مشارکت در پروژه
|
||
|
||
### برای کاربران
|
||
|
||
ساختار کد پروژه بازطراحی شده تا از **سیستم تولید مبتنی بر قالب (Template-based)** استفاده کند. تمام فایلهای مخصوص پلتفرم (`.cursor/`، `.windsurf/`، `.kiro/`، `.factory/` و غیره) اکنون بهصورت پویا توسط CLI تولید میشوند.
|
||
|
||
**همیشه برای نصب از CLI استفاده کنید:**
|
||
|
||
```bash
|
||
npm install -g ui-ux-pro-max-cli
|
||
uipro init --ai <platform>
|
||
```
|
||
|
||
این روش تضمین میکند که جدیدترین قالبهای بستهبندیشده در نسخهٔ نصبشدهٔ CLI و ساختار فایل صحیح متناسب با دستیار هوش مصنوعی خود را دریافت کنید. پس از انتشار نسخهٔ جدید، ابتدا بستهٔ 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) را ببینید.
|
||
|
||
### منشأ کاتالوگ و بهروزرسانی آن
|
||
|
||
خلاصهٔ کاتالوگ ثبتشده در مخزن در حال حاضر شامل **۱٬۹۳۴ فونت تأییدشدهٔ Google Fonts** بهعلاوهٔ **۸ مورد کنارگذاشتهشده برای بازبینی** است که تا زمان تطبیق با فرادادهٔ رسمی مجوز، وارد مجموعهٔ اصلی نمیشوند. راهنمای آیکون همچنان شامل **۱۰۵ ردیف گزینششده** است (۱۰۰ مورد واردسازی مستقیم Phosphor برای وب بهعلاوهٔ راهنمای React Native و روش جایگزین). مانیفست جداگانهٔ **۱٬۵۱۲ آیکونی Phosphor در منبع بالادستی**، نامها، وزنها و واردسازی React/SSR را اعتبارسنجی میکند، بدون آنکه تمام بستهٔ بالادستی را وارد نتایج جستوجو کند.
|
||
|
||
توسعهٔ معمول و CI درخواستهای ادغام، مستقل از شبکه هستند. برای اجرای کامل بررسی آفلاین، همراه با هش snapshotها و اعتبارسنجی تعداد دادههای تولیدشده، دستور زیر را اجرا کنید:
|
||
|
||
```bash
|
||
npm --prefix cli run verify:data
|
||
# Or check only the generated catalog summary:
|
||
npm --prefix cli run validate:catalog-summary
|
||
```
|
||
|
||
نرمالسازی فرایند بهروزرسانی را میتوان بهطور کامل و آفلاین و با fixtureهای ثبتشده نیز آزمایش کرد. خروجیها در یک پوشهٔ موقت کاندید قرار میگیرند و هرگز جایگزین دادههای اصلی نمیشوند:
|
||
|
||
```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 طبق برنامه اجرا میشود و اجرای دستی آن نیز امکانپذیر است. مقدار `GOOGLE_FONTS_API_KEY` را بهعنوان secret در GitHub Actions تنظیم کنید، سپس جریان را اجرا کرده و خروجی بازبینی آن را دریافت کنید:
|
||
|
||
```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 را میخواند، فایلهای کاندید و diffهای یکپارچه را در یک artifact مینویسد و فقط مجوز خواندن مخزن را دارد. این فرایند هرگز commit یا push انجام نمیدهد، درخواست ادغام باز نمیکند و چیزی را ادغام نمیکند. پیش از انتقال دستی فایلهای کاندید به `src/ui-ux-pro-max/data/`، گزارش تغییرات، موارد کنارگذاشتهشده، مجوزها، معیارهای مرتبطبودن و بررسی آفلاین را بازبینی کنید.
|
||
|
||
## انتشارهای خودکار
|
||
|
||
این مخزن برای ایجاد خودکار نسخههای GitHub از semantic-release همراه با Conventional Commits استفاده میکند:
|
||
|
||
- شاخهٔ `dev` نسخههای آزمایشی GitHub مانند `2.6.0-beta.1` ایجاد میکند.
|
||
- شاخهٔ `main` نسخههای پایدار رسمی GitHub مانند `2.6.0` ایجاد میکند.
|
||
|
||
یادداشتهای انتشار و فایل `CHANGELOG.md` از پیامهای Conventional Commit تولید میشوند. شمارهٔ نسخهها هنگام آمادهسازی انتشار، در فایلهای `skill.json`، `.claude-plugin/plugin.json`، `.claude-plugin/marketplace.json`، `cli/package.json` و `cli/package-lock.json` همگامسازی میشوند.
|
||
|
||
برای افزایش صحیح شمارهٔ نسخه، از انواع commit زیر استفاده کنید:
|
||
|
||
- `fix:` ← انتشار patch
|
||
- `feat:` ← انتشار minor
|
||
- `feat!:` یا `BREAKING CHANGE:` ← انتشار major
|
||
|
||
جریان انتشار برای انتشارهای GitHub از `GITHUB_TOKEN` پیشفرض و برای انتشار بستهٔ `ui-ux-pro-max-cli` در npm از secret مخزن با نام `NPM_TOKEN` استفاده میکند.
|
||
|
||
## عیبیابی
|
||
|
||
### Claude Code پیام `response exceeded the ... output token maximum` را گزارش میکند
|
||
|
||
این پیام محدودیت تعداد توکن خروجی در یک پاسخ Claude Code است و به معنی وجود خطا در نصبکننده یا اسکریپتهای جستوجوی UI/UX Pro Max نیست. ابتدا از Claude بخواهید کار را به مراحل کوچکتر تقسیم کند و خروجیهای بزرگ را بهصورت تدریجی در فایلها بنویسد.
|
||
|
||
اگر واقعاً به یک پاسخ واحد و بزرگتر نیاز دارید و مدل فعال از آن پشتیبانی میکند، پیش از شروع یک نشست جدید، محدودیت توکن خروجی 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
|
||
```
|
||
|
||
تغییرات محیطی shell فقط روی برنامههایی اثر میگذارند که از همان shell اجرا میشوند؛ بنابراین پس از تنظیم متغیر، 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
|
||
```
|
||
|
||
### پنجرهٔ «Upload a skill» در Claude.ai پیام `Zip contains too many files (maximum 200)` را نشان میدهد
|
||
|
||
فایل ZIP کامل مخزن GitHub را بارگذاری نکنید. این فایل یک نسخهٔ توسعهای از مخزن است که کد منبع، داراییهای CLI، مستندات، پیشنمایشها و چند مهارت بستهبندیشده را در بر دارد؛ بنابراین از محدودیت ۲۰۰ فایل Claude بیشتر میشود. این فایل، خروجی مناسب بارگذاری مهارت در Claude نیست و این پروژه در حال حاضر ZIP جداگانهای برای بارگذاری دستی در Claude.ai منتشر نمیکند.
|
||
|
||
برای 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 شناختهشده است. مخزن در گذشته از symlinkها بهصورت داخلی استفاده میکرد که برخی ابزارهای نصب قادر به پردازش آنها نبودند. **راهحل:** بهجای آن از نصبکنندهٔ 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/) یا با مدیر بستهٔ سیستمعامل خود (Homebrew، apt یا winget) نصب کنید. عاملهای هوش مصنوعی نباید این نرمافزار را بهجای شما نصب کنند؛ طبق دستورالعمل، ابتدا باید از شما درخواست کنند.
|
||
|
||
### خروجی سیستم طراحی بریده میشود یا بعضی فیلدها ناقص هستند
|
||
|
||
خروجی قابل خواندن برای انسان، فیلدهای طولانیتر از ۳۰۰ نویسه را کوتاه میکند. برای دریافت دادهٔ کامل و بدون کوتاهسازی، از گزینهٔ `--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) منتشر شده است.
|
||
|
||
## عاملهای سازگار
|
||
|
||
این مهارت با موارد زیر کار میکند:
|
||
|
||
- [Claude Code](https://claude.com/product/claude-code)
|
||
- [AdaL](https://sylph.ai/) - عامل کدنویسی خودتکاملیاب ([مستندات](https://docs.sylph.ai/) | [GitHub](https://github.com/SylphAI-Inc/adal-cli))
|