‏spatie/guidelines-skills: استانداردهای کدنویسی Spatie برای دستیارهای هوش مصنوعی

یکی از بزرگ‌ترین چالش‌هایی که تیم‌های توسعه‌دهنده با دستیارهای هوش مصنوعی دارن اینه که این ابزارها از قراردادها و استانداردهای اختصاصی تیم خبر ندارن. مثلاً AI ممکنه به جای ?string از string|null استفاده کنه، یا اسم کنترلرها رو به شکل اشتباه بنویسه. تیم Spatie برای حل این مشکل پکیج جدیدی به اسم spatie/guidelines-skills ساخته.

این پکیج در واقع همون دستورالعمل‌های کدنویسی معروف Spatie رو به فرمتی تبدیل می‌کنه که دستیارهای AI می‌تونن ازشون استفاده کنن. ایده اصلی روی مفهوم «Skills» بنا شده — Skills یه سری دستورالعمل‌های قابل‌استفاده مجدد هستن که بر اساس context به صورت خودکار فعال می‌شن. وقتی داری روی یه فایل PHP کار می‌کنی، مهارت مرتبط با PHP فعال می‌شه و AI طبق استانداردهای تیم کد می‌نویسه.

نسخه قبلی این ابزار یعنی spatie/boost-spatie-guidelines فقط با Laravel Boost کار می‌کرد. اما spatie/guidelines-skills روی پلتفرم skills.sh بنا شده و با طیف گسترده‌تری از ابزارها مثل Claude Code، Cursor، Codex و GitHub Copilot سازگاره.

این پکیج شامل چهار مجموعه مهارت اصلیه:

• spatie-laravel-php: جامع‌ترین مهارت که PSR-12، typed properties، constructor promotion، early returns، قراردادهای routing لاراول، نام‌گذاری کنترلرها، قوانین validation و Blade templates رو پوشش می‌ده.
• spatie-javascript: تنظیمات Prettier، استفاده از const به‌عنوان پیش‌فرض، strict equality، named functions و destructuring.
• spatie-version-control: نام‌گذاری ریپازیتوری، قراردادهای branching، استایل commit message و استراتژی merge (squash merge روی feature branchها).
• spatie-security: SSL، حفاظت CSRF، هش کردن پسورد، مجوزهای دیتابیس، hardening سرور و مدیریت credential.

نصب پکیج از دو روش ممکنه. اگه از Laravel Boost استفاده می‌کنی:

composer require spatie/guidelines-skills --dev
php artisan boost:install

و اگه می‌خوای مستقیم از skills.sh استفاده کنی:

npx skills add spatie/guidelines-skills

بعد از نصب، Skills به صورت خودکار روی فایل‌های مرتبط فعال می‌شن و دیگه نیازی نیست هر بار به AI یادآوری کنی که چه استانداردهایی رو رعایت کنه.

آپدیت نگه داشتن مهارت‌ها هم ساده‌ست. هر وقت Spatie دستورالعمل‌هاشو به‌روز کنه، می‌تونی با composer update یا دوباره اجرا کردن دستور npx skills آخرین تغییرات رو بگیری.

اگه قبلاً از spatie/boost-spatie-guidelines استفاده می‌کردی، می‌تونی مستقیم با این پکیج جایگزینش کنی چون همه قابلیت‌های قبلی رو داره، به علاوه اینکه دیگه محدود به Boost نیست.

نکات کلیدی:

• spatie/guidelines-skills استانداردهای کدنویسی Spatie رو به دستیارهای AI یاد می‌ده
• از پلتفرم skills.sh استفاده می‌کنه و با Claude Code، Cursor، Codex و Copilot کار می‌کنه
• چهار مهارت برای PHP/Laravel، جاوااسکریپت، version control و امنیت داره
• Skills بر اساس context به صورت خودکار فعال می‌شن، بدون نیاز به تنظیم دستی
• جایگزین کامل پکیج قدیمی boost-spatie-guidelines و مستقل از Laravel Boost