ساخت و توسعهی دیزاینسیستم فارسی
تجربهی ۲۱۵ کامیت ساخت کاشی در یک اسکیل: از توکن و RTL تا دادههای ایرانی، دسترسپذیری، تست تصویری و انتشار نسخه.
لایسنس شخصی: برای استفادهی خودتان، روی همهی دستگاهها و ابزارهایتان
ساختن کامپوننت سخت نیست؛ سختی در جزئیاتی است که فقط در محصول فارسی پیدا میشوند: رقمهایی که عرضشان عوض میشود، «ي» و «ك» عربی که جستوجو را خراب میکنند، شمارههایی که وسط متن راستبهچپ جابهجا میشوند، تقویم شمسی، قالب کارت و شبا، نیمفاصله، و تیمی که نمیتواند بهروزرسانی کند چون یک نسخهی جزئی اسم یک prop را عوض کرده.
این اسکیل از ساخت کاشی بیرون آمده: یک دیزاینسیستم متنباز فارسی با بیش از ۸۰ کامپوننت، ۴۸۰۰ آیکون، پکیج React و وبکامپوننت، کیت فیگما و سرور MCP. هر قاعدهی آن پشتش یک باگ واقعی یا یک تصمیم سنجیده است که در طول ۲۱۵ کامیت گرفته شده.
دستیار شما با این اسکیل میداند توکنها را چند لایه بسازد، CSS را فقط با logical properties بنویسد، ورودیهای ایرانی را با الگوریتم درست اعتبارسنجی کند، متنها را دوزبانه نگه دارد، کنتراست را در بیلد چک کند و نسخه را بدون شکستن کار تیمها منتشر کند. سه اسکریپت بررسی RTL، متن فارسی و کنتراست هم همراهش است.
از نزدیک ببینید
دیزاینسیستم فارسی از صفر تا انتشار؛ با تجربهی ۲۱۵ کامیت ساخت کاشی
چه چیزهایی داخل این اسکیل است
روند کامل: ممیزی، توکن سهلایه، CSS راستبهچپ، تایپوگرافی فارسی، دادههای ایرانی، کامپوننت، انتشار
اسکریپت rtl_audit: پیدا کردن margin-left، text-align: left، translateX و دهها خطای رایج RTL با راهحل
اسکریپت fa_text_lint: ی و ک عربی، نیمفاصله، رقم و نشانهی لاتین و عبارتهای اداری در متنها
اسکریپت contrast_check: سنجش WCAG 2.2 AA برای همهی جفتهای توکن در هر تم
کتابخانهی آمادهی persian-utils: کد ملی، شناسهی ملی، کارت، شبا، موبایل، کد پستی، رقم، پول و تاریخ شمسی
چکلیست کامپوننت: حالتها، کیبورد، ARIA، پیامهای fa/en، وبکامپوننت، بودجهی حجم، تست تصویری
قواعد انتشار: changesets، deprecate بهجای حذف، تست مصرفکننده در Next.js، llms.txt و MCP
کجا به کارتان میآید
برای یک محصول یا سازمان ایرانی، از توکنها تا اولین نسخهی منتشرشده، بدون تکرار اشتباههایی که بقیه یک بار کردهاند.
کامپوننتهای انگلیسیمحور را ممیزی و به راستبهچپ واقعی، رقم فارسی و ورودیهای ایرانی تبدیل کنید.
هر کامپوننت جدید با همهی حالتها، دسترسپذیری، پیامهای دوزبانه، مستندات و تست ساخته میشود.
اسکریپتها مشکلها را با شمارهی خط و راهحل پیدا میکنند؛ دستیار اصلاحشان میکند.
شما میگویید، اسکیل انجام میدهد
روی ابزار خودتان نصب کنید
یک فایل zip برای همهی ابزارها. ابزارتان را انتخاب کنید و دستورها را کپی کنید.
- فایل zip را از کتابخانهی حسابتان دانلود کنید
فایل building-persian-design-systems.zip با مشخصات لایسنس شما ساخته میشود. نیازی به استخراج دستی نیست.
- برای همهی پروژهها (پیشنهادی)
اسکیل در پوشهی شخصی نصب میشود و در هر پروژهای در دسترس است.
macOS / Linuxmkdir -p ~/.claude/skills && unzip -o ~/Downloads/building-persian-design-systems.zip -d ~/.claude/skills/Windows (PowerShell)Expand-Archive -Force $HOME\Downloads\building-persian-design-systems.zip $HOME\.claude\skills - یا فقط برای یک پروژه
داخل ریشهی پروژه اجرا کنید. اگر پوشه را کامیت کنید، اعضای تیمی که لایسنس دارند هم آن را میبینند.
mkdir -p .claude/skills && unzip -o ~/Downloads/building-persian-design-systems.zip -d .claude/skills/ - بررسی و استفاده
Claude Code را دوباره باز کنید. هر وقت کارتان به این اسکیل مربوط باشد Claude خودش آن را فعال میکند. برای اجرای مستقیم بنویسید /building-persian-design-systems یا بپرسید «چه اسکیلهایی داری؟».
claude
- اجرای کد را روشن کنید
در Settings › Capabilities گزینهی Code execution and file creation را فعال کنید. اسکیلها روی پلنهای Pro، Max، Team و Enterprise کار میکنند.
- فایل zip را بارگذاری کنید
به Customize › Skills بروید، روی + و بعد Upload a skill بزنید و همان building-persian-design-systems.zip را بدون استخراج انتخاب کنید.
- اسکیل را روشن کنید
کلید کنار اسکیل را فعال کنید. از این به بعد در گفتگوها هر وقت لازم باشد خودکار استفاده میشود.
اسکیلهای بارگذاریشده در Claude.ai با Claude Code همگام نمیشوند؛ برای هر کدام جدا نصب کنید.
- نصب برای همهی پروژههاmacOS / Linux
mkdir -p ~/.codex/skills && unzip -o ~/Downloads/building-persian-design-systems.zip -d ~/.codex/skills/Windows (PowerShell)Expand-Archive -Force $HOME\Downloads\building-persian-design-systems.zip $HOME\.codex\skills - یا فقط برای یک مخزن
Codex اسکیلهای داخل مخزن را هم میخواند (پوشهی استاندارد .agents/skills).
mkdir -p .agents/skills && unzip -o ~/Downloads/building-persian-design-systems.zip -d .agents/skills/ - Codex را دوباره اجرا کنید
بعد از ریاستارت، اسکیل در فهرست /skills دیده میشود. برای صدا زدن مستقیم بنویسید $building-persian-design-systems یا کار را عادی توضیح دهید.
codex
- اگر قبلاً برای Claude Code یا Codex نصب کردهاید، کاری لازم نیست
Cursor پوشههای ~/.claude/skills و ~/.codex/skills را هم میخواند.
- نصب مستقیمهمهی پروژهها
mkdir -p ~/.cursor/skills && unzip -o ~/Downloads/building-persian-design-systems.zip -d ~/.cursor/skills/فقط این پروژهmkdir -p .cursor/skills && unzip -o ~/Downloads/building-persian-design-systems.zip -d .cursor/skills/ - استفاده
در چت Agent بنویسید /building-persian-design-systems یا اجازه دهید Agent خودش آن را انتخاب کند.
- نصبهمهی پروژهها
mkdir -p ~/.gemini/skills && unzip -o ~/Downloads/building-persian-design-systems.zip -d ~/.gemini/skills/فقط این پروژهmkdir -p .gemini/skills && unzip -o ~/Downloads/building-persian-design-systems.zip -d .gemini/skills/ - بررسی
در Gemini CLI دستور /skills list را بزنید تا اسکیل را ببینید.
/skills list
اگر نسخهی شما پوشهی بالا را نمیشناسد، همان فایل را در ~/.agents/skills استخراج کنید.
- ابزارهای سازگار با استاندارد Agent Skills
هر ابزاری که پوشهای با SKILL.md را میخواند، کافی است همین zip را در پوشهی اسکیلهای آن ابزار (معمولاً .agents/skills) استخراج کنید.
mkdir -p .agents/skills && unzip -o ~/Downloads/building-persian-design-systems.zip -d .agents/skills/ - ابزارهای بدون پشتیبانی از اسکیل
محتوای SKILL.md را در دستورالعمل پروژه (AGENTS.md، custom instructions یا Project knowledge) بگذارید و فایلهای کمکی را کنار پروژه نگه دارید.
پیشنیاز: Node.js 18 یا بالاتر برای اسکریپتها. بدون وابستگی خارجی.
نسخهها
v1.0.0
۱۷ آبان ۱۴۰۵انتشار اول: روند کامل، rtl_audit، fa_text_lint، contrast_check و persian-utils.
سوالهای این اسکیل
فقط برای کسانی است که از کاشی استفاده میکنند؟
با چه فریمورکهایی کار میکند؟
چرا از بقیهی اسکیلها گرانتر است؟
ساخت و توسعهی دیزاینسیستم فارسی
تجربهی ۲۱۵ کامیت ساخت کاشی در یک اسکیل: از توکن و RTL تا دادههای ایرانی، دسترسپذیری، تست تصویری و انتشار نسخه.