‏راهنمای تازهٔ Anthropic برای نوشتن Claude Skills

Anthropic راهنمای best practiceهاش برای Claude skills رو به‌روز کرده. skill یعنی یه بستهٔ دستورالعمل، معمولاً یه فایل skill.md به‌همراه فایل‌های مرجع و اسکریپت، که به Claude یاد می‌ده یه کار تکراری رو همیشه یه‌جور انجام بده. به گفتهٔ این مقاله، اصلی‌ترین مشکل اینه که Claude وقتی یه فایل مرجع بلند رو باز می‌کنه، اغلب فقط حدود ۱۰۰ خط اولش رو می‌خونه تا ببینه ارزش خوندن کامل داره یا نه. یعنی اگه دستورهای مهمت پایین‌تر باشن، ممکنه هیچ‌وقت دیده نشن.

راه‌حلش اینه که بالای هر فایل مرجعِ بیشتر از ۱۰۰ خط یه فهرست مطالب بذاری که دقیقاً تیترهای واقعی فایل رو نشون بده. فایل‌های مرجع هم باید فقط یه سطح با skill.md فاصله داشته باشن. اگه skill.md به فایل A اشاره کنه و A به فایل B، احتمالش زیاده B نصفه خونده بشه. خود skill.md هم بهتره زیر حدود ۵۰۰ خط بمونه و بیشتر نقش فهرست کل skill رو بازی کنه.

مفهوم بعدی degrees of freedom هست، یعنی اینکه Claude تو هر مرحله چقدر دستش بازه. آزادی زیاد برای کارهایی مثل code review که راه درست به خود کد بستگی داره. آزادی متوسط برای کارهای قالب‌دار مثل گزارش هفتگی. آزادی کم، معمولاً یه اسکریپت ثابت، برای کارهای حساس مثل migration دیتابیس، صدور فاکتور یا پاک کردن اکانت. نویسنده می‌گه یه skill می‌تونه هر سه سطح رو تو مرحله‌های مختلفش داشته باشه. اسکریپت‌ها اجرا می‌شن نه خونده، پس از بودجهٔ توکن Claude هم چیزی کم نمی‌کنن.

یه skill روی مدل‌های مختلف یه‌جور رفتار نمی‌کنه، چون در اصل یه prompt هست. مدل‌های کوچیک‌تر به راهنمایی صریح و مرحله‌های شماره‌دار نیاز دارن. ولی مدل‌های reasoning جدیدتر اگه زیادی دستور بگیرن ممکنه بدتر کار کنن. توصیهٔ Anthropic اینه که هر skill رو روی تک‌تک مدل‌هایی که قراره باهاش کار کنن تست کنی و برای مدل‌های قوی‌تر دستورهای اضافه رو حذف کنی. اگه skill رو با بقیه به اشتراک می‌ذاری، مدل هدف رو هم تو YAML front matter بنویس.

برای کارهای چندمرحله‌ای که ترتیب توشون مهمه، Anthropic پیشنهاد می‌ده Claude یه چک‌لیست رو تو جوابش کپی کنه و قدم‌به‌قدم تیک بزنه. نکتهٔ مهم‌تر یه مرحلهٔ بررسی آخر کاره: مثلاً همهٔ ادعاها با منبع چک بشن و اگه citationها ناقص بودن، Claude برگرده به مرحلهٔ قبل. همین چرخهٔ «بنویس، چک کن، درست کن» می‌تونه به مرور خود skill رو هم بهتر کنه، چون Claude قانون جدید پیشنهاد می‌ده و یه آدم تأییدش می‌کنه.

آخرین نکته اینه که skill هیچ‌وقت نباید فرض کنه یه پکیج از قبل نصبه. خیلی از skillها روی لپ‌تاپ سازنده‌شون درست کار می‌کنن چون پیش‌نیازها ماه‌ها پیش نصب شده، ولی روی سیستم همکار یا یه session تازه خراب می‌شن. پس کنار هر اسکریپت یه خط نصب پکیج با اسم دقیقش بذار. اگه از قبل نصب باشه، Claude بدون هزینه ازش رد می‌شه.

نکات کلیدی:

• Claude اغلب فقط حدود ۱۰۰ خط اول فایل‌های بلند رو می‌خونه؛ فایل‌های بلندتر به فهرست مطالب نیاز دارن
• فایل‌های مرجع باید فقط یه سطح از skill.md فاصله داشته باشن
• بدنهٔ skill.md بهتره زیر حدود ۵۰۰ خط بمونه
• سه سطح آزادی: زیاد برای code review، متوسط برای قالب‌ها، کم (اسکریپت) برای پرداخت و حذف داده
• هر skill باید روی تک‌تک مدل‌های هدف تست بشه و مدل هدف تو YAML front matter ثبت بشه
• کنار هر اسکریپت یه مرحلهٔ نصب صریح پیش‌نیازها لازمه