‏Claude Skills: اتوماسیون کدنویسی تکراری در لاراول

پروژه‌ای که روی API تیکت‌ماتیک با کتابخانه Saloon ساخته شده بود، یه الگوی تکراری داشت: برای هر endpoint جدید باید چهار فایل مجزا می‌ساختی. این کار نه سخت بود، نه پیچیده — فقط خسته‌کننده و وقت‌گیر.

جریان کار قبلی برای یه endpoint ساده مثل «گرفتن سفارش» این‌طوری بود: اول یه کلاس GetOrderParams برای نگه‌داشتن پارامترهای درخواست، بعد یه DTO از نوع spatie/laravel-data برای parse کردن پاسخ API، سپس کلاس Request خود Saloon که همه چیز رو به هم وصل می‌کرد، و در آخر یه متد روی Resource که نتیجه نهایی رو می‌داد. حاصل این chain یه کال تمیز بود:

app(TicketShop::class)->orders()->get(new GetOrderParams(123));

Claude Skills یه قابلیته که مجموعه‌ای از دستورالعمل‌های قابل‌استفاده مجدد برای دستیارهای AI کدنویسی تعریف می‌کنه و بر اساس context به‌صورت خودکار فعال می‌شه. تیم یه اسکیل اختصاصی برای Saloon نوشت: Claude یه‌سری سوال می‌پرسه، بعد فایل‌ها رو در مسیر درست می‌سازه، namespace‌ها رو درست می‌کنه، فیلدهای اجباری و اختیاری رو جدا می‌کنه، DTOها رو می‌سازه، و حتی Laravel Pint رو برای فرمت‌دهی اجرا می‌کنه. وقتی یه endpoint پانزده property داشته باشه، این اتوماسیون واقعاً تفاوت ایجاد می‌کنه.

اسکیل مربوط به Saloon تنها اتوماسیون پروژه نبود. پروژه به‌صورت یه پکیج لاراول طراحی شده که اپ‌های دیگه روش ساخته می‌شن. به همین خاطر یه کلاس Shop وجود داره که کامپوننت‌های Livewire رو در یه آرایه ثبت می‌کنه و هر کامپوننت به یه case از enum ShopComponent ربط داده می‌شه. این ساختار به اپ‌های مختلف اجازه می‌ده فیچرها رو غیرفعال کنن یا پیاده‌سازی سفارشی جایگزین کنن. برای ساختن هر صفحه جدید هم باید کامپوننت Livewire، قالب Blade، case جدید در enum و ثبت در کلاس Shop انجام می‌شد — یه اسکیل جداگانه این مسیر رو هم خودکار کرد.

اسکیل سومی هم برای review کردن pull requestها نوشته شده. قبل از اینکه PR به همکار برسه، Claude مواردی مثل رشته‌های ترجمه‌نشده یا نام‌گذاری ناسازگار رو بررسی می‌کنه و کنوانسیون‌های کدبیس رو حفظ می‌کنه.

در حدود ۹ مورد از ۱۰ مورد نتیجه کاملاً درسته. اون ۱۰ درصد باقی‌مانده معمولاً به خاطر کافی نبودن context ورودیه. بنابراین مرور کد تولیدشده هنوز هم ضروریه — اما حجم کار تکراری به شکل چشمگیری کاهش پیدا کرده.

نکات کلیدی:

• Claude Skills مجموعه‌ای از دستورالعمل‌هاست که دستیار AI رو برای یه کار خاص آموزش می‌ده و هر بار نیاز به توضیح مجدد نیست
• برای هر endpoint در Saloon باید چهار فایل ساخت؛ این اسکیل همه رو یک‌جا و در مسیر درست تولید می‌کنه
• ساختار پکیجی پروژه نیاز به ثبت دستی کامپوننت‌های Livewire داشت که اسکیل دومی این کار رو خودکار کرد
• اسکیل سوم PR‌ها رو قبل از مرور انسانی بررسی می‌کنه تا خطاهای رایج گرفته بشن
• کد تولیدشده رو همیشه باید بررسی کرد؛ در ۱۰٪ موارد به دلیل context ناقص اشتباهاتی وجود داره