پلاگین Claude Code

پلاگین Claude Code پرتو، هوش مصنوعی Claude را با دانش کامل سیستم طراحی مجهز می‌کند. به‌جای اینکه هر بار نام کامپوننت‌ها، قوانین RTL، یا سیستم رنگ را توضیح دهید، Claude این‌ها را از قبل می‌داند و کد صحیح تولید می‌کند.

قابلیت‌ها

نصب

مرحله 1 — دریافت پلاگین

هیچ remote عمومی برای checkout سورس یا URL عمومی برای بستهٔ سورس تأیید نشده است. از مسئول انتشار یک approved source remote همراه شناسهٔ کامل commit تغییرناپذیر و بازبینی‌شده، یا یک verified signed source bundle مشخص‌کنندهٔ همان commit کامل دریافت کنید. پیش از استفاده، امضای بسته و manifest شناسهٔ commit را بررسی و تأیید کنید. لینک مستندات و پکیج npm، remote دریافت سورس نیست. ارجاع‌های تاریخی انتشار، دستور دریافت نسخهٔ جاری نیستند.

در مسیر دلخواه، checkout همان commit تأییدشده را ایجاد کنید:

git clone <approved-source-remote> ~/parto-ui
cd ~/parto-ui
git checkout --detach <full-reviewed-commit-sha>
git status --porcelain # must print nothing

پلاگین در پوشهٔ claude-plugin/ همان checkout یا بستهٔ تأییدشده قرار دارد.

مرحله 2 — فعال‌سازی در پروژه

در ریشه پروژه Next.js خود، فایل .claude/settings.json را بسازید:

{
  "plugins": ["/Users/your-username/parto-ui/claude-plugin"]
}

مسیر را با مسیر واقعی روی دیسک خود جایگزین کنید. چند مثال:

// macOS / Linux
{ "plugins": ["/Users/ali/parto-ui/claude-plugin"] }

// Windows
{ "plugins": ["C:/Users/ali/parto-ui/claude-plugin"] }

مرحله 3 — تأیید نصب

Claude Code را ری‌استارت کنید، سپس این پیام را بفرستید:

کدام کامپوننت پرتو برای نمایش نرخ تعامل استفاده کنم؟

اگر Claude پاسخ دقیقی درباره EngagementRate و category prop داد، پلاگین فعال است.

آپدیت

پلاگین با نسخهٔ اصلی @partodata/ui که آموزش می‌دهد هماهنگ است: نسخهٔ 3 پلاگین (همین نسخه) برای @partodata/ui نسخهٔ 5 است. پروژه‌ای که هنوز روی نسخهٔ 4 است پلاگینِ checkout نسخهٔ 4 خود را نگه دارد تا ارتقا دهد، و سرور MCP را هم روی @partodata/mcp-server@2 ثابت کند (روی نسخهٔ 3: پلاگین checkout نسخهٔ 3 و @partodata/mcp-server@1).

برای به‌روزرسانی، شناسهٔ کامل commit بازبینی‌شدهٔ نسخهٔ جدید را از مسئول انتشار دریافت کنید. در checkout پاکِ remote تأییدشده اجرا کنید:

cd ~/parto-ui
git status --porcelain # must print nothing
git fetch origin <full-reviewed-commit-sha>
git checkout --detach <full-reviewed-commit-sha>

برای به‌روزرسانی بسته، تأیید امضا و شناسهٔ کامل commit بازبینی‌شده را طبق قرارداد بالا تکرار کنید و سپس مسیر پلاگین را تغییر دهید. به branch یا tag متغیر اتکا نکنید.

نصب سراسری (همه پروژه‌ها)

برای فعال‌سازی در تمام پروژه‌ها بدون تنظیم جداگانه، به فایل ~/.claude/settings.json اضافه کنید:

{
  "plugins": ["/Users/your-username/parto-ui/claude-plugin"]
}

دستورات آماده

/parto:setup — راه‌اندازی خودکار پروژه

پروژه را اسکن و تمام تنظیمات لازم را اعمال می‌کند:

/parto:setup

این دستور به‌صورت خودکار:

• خط @import '@partodata/ui/tailwind.css' را به CSS اصلی اضافه می‌کند
• transpilePackages را به next.config.mjs اضافه می‌کند
• نشانگرهای تیره‌ی پیش‌فرض (lang="fa" dir="rtl" className="dark" data-theme="dark") را روی <html> می‌گذارد
• در صورت تعویض تم، ThemeProvider را با attribute={['class', 'data-theme']} وصل می‌کند

/parto:component — کد آماده کامپوننت

/parto:component Account
/parto:component جدول با قابلیت سرچ برای لیست اینفلوئنسرها

کد کامل TypeScript با محتوای فارسی واقعی و تمام props تولید می‌کند.

/parto:review — بررسی کد

/parto:review
/parto:review app/components/dashboard.tsx

کد را بررسی می‌کند و دقیقاً خط‌هایی که مشکل دارند را با راه‌حل نمایش می‌دهد. سپس می‌پرسد «الان رفع کنم؟»

/parto:page — scaffold صفحه کامل

/parto:page dashboard
/parto:page list
/parto:page form
/parto:page detail

یک صفحه Next.js کامل با کامپوننت‌های پرتو، داده نمونه فارسی، و حالت‌های loading/empty تولید می‌کند. هر صفحه، مثل راهنمای AGENTS.md پکیج، یک قالب از @partodata/ui/templates است (DashboardPage، ListPage، FormPage، DetailPage)؛ صفحهٔ فهرست جست‌وجو، فیلترها، filtered و اقدام‌ها را به جایگاه‌های ListPage می‌دهد، با یک اقدام اصلی کارا در primaryAction و اقدام‌های ثانوی variant="default". هر چهار قالب در CI روی پکیج ساخته‌شده کامپایل می‌شوند و از قانون ESLint parto/page-primary-action می‌گذرند.

هشدار خودکار

پس از هر بار نوشتن فایل .tsx یا .jsx، پلاگین بدون استفاده از توکن اضافه بررسی می‌کند. نمونه هشدار:

⚠️  پرتو: 3 نقض در dashboard.tsx

🔴 RTL (2 مورد):
   خط 12: ml-4 (باید ms-4 باشد)
   خط 18: pr-6 (باید pe-6 باشد)

🟡 رنگ hardcode (1 مورد):
   خط 45: text-gray-500 (باید text-light باشد)

💡 برای رفع کامل: /parto:review

تنظیمات اختیاری پروژه

برای شخصی‌سازی رفتار پلاگین، فایل .claude/parto.local.md در ریشه پروژه بسازید:

## تنظیمات پرتو

- **نسخه پکیج**: 7.13.0
- **تم پیش‌فرض**: dark
- **پلتفرم‌های فعال**: instagram, telegram, youtube
- **نوع پروژه**: dashboard

این فایل را در .gitignore اضافه کنید — اطلاعات خصوصی هر توسعه‌دهنده است.

صفحات مرتبط

• نصب و راه‌اندازی — نصب پکیج در Next.js
• فارسی‌محور بودن — قوانین RTL که پلاگین اعمال می‌کند
• رنگ‌ها — سیستم رنگ سمانتیک که پلاگین آموزش می‌دهد