‏TanStack Intent 0.5: نگهداری اسکیل‌های ایجنت راحت‌تر شد

Intent ابزاری از TanStack هست که بهت اجازه می‌ده agent skill (یعنی فایل‌های راهنمایی که به ایجنت‌های کدنویسی یاد می‌دن چطور با کتابخونه کار کنن) رو داخل پکیج npm منتشر کنی. اینطوری راهنما همراه همون نسخه‌ای از کتابخونه نصب می‌شه که توضیحش می‌ده. نویسنده می‌گه این کار مشکل «رسوندن» راهنما رو حل می‌کنه، ولی مشکل «نگه‌داشتنش» سر جاش می‌مونه.

مثال خود مقاله اینه: اسم یه export رو عوض می‌کنی، تایپ‌ها و تست‌ها رو درست می‌کنی و نسخه می‌دی، ولی یه گوشه از پکیج یه اسکیل هنوز به ایجنت می‌گه از اسم قدیمی استفاده کن. نسخهٔ 0.5 برای همین یه روند کامل برای maintainer اضافه کرده. با دستور intent maintainer setup مخزن آماده می‌شه، اسکیل‌های موجود بدون تغییر محتوا ثبت می‌شن و یه workflow برای CI هم ساخته می‌شه.

مهم‌ترین قابلیت جدید intent validate هست که نمونه‌کدهای JavaScript و TypeScript داخل SKILL.md رو، شامل JSX و TSX، با کامپایلر TypeScript و بدون اجرا چک می‌کنه. export‌های گم‌شده، آپشن‌های نامعتبر، تایپ‌های ناجور و خطای سینتکس رو با اسم فایل و شمارهٔ خط گزارش می‌ده و برای importهای deprecated هم هشدار می‌ده. لازم نیست هر تیکه کد یه برنامهٔ کامل باشه. این چک به TypeScript 5.0 یا بالاتر نیاز داره و نویسنده تأکید می‌کنه که رد شدن ازش یعنی API درست صدا زده شده، نه اینکه رفتار زمان اجرا هم درسته.

قابلیت بعدی intent maintainer review هست. این دستور نشون می‌ده کدوم راهنماها تحت تأثیر تغییرات سورس قرار گرفتن و کدوم تغییرها اصلاً راهنمایی ندارن. بعد تو ثبت می‌کنی که اسکیل رو آپدیت کردی یا چرا هنوز درسته. این تصمیم به محتوای همون سورس و اسکیل گره می‌خوره؛ یعنی اگه چیزی عوض نشده دوباره ازت سؤال نمی‌شه، و اگه عوض شده تأیید قبلی حساب نمی‌شه.

تو CI هم چک‌های آماده برای validation، ناهمخوانی فایل‌های تولیدی و بازبینی‌های معطل اضافه شده. دستور تازهٔ intent repair هم اصلاح‌های بی‌دردسر frontmatter رو با --write اعمال می‌کنه یا با --patch یه پچ می‌سازه، ولی تغییر نمونه‌کدها رو به عهدهٔ خود maintainer می‌ذاره. از طرف دیگه حالا Intent به‌صورت یه پکیج واحد و بدون وابستگی جدا نصب می‌شه و hookهای ایجنت از CLI نصب‌شدهٔ محلی استفاده می‌کنن، پس شروع جلسه‌ها سریع‌تره.

اگه از نسخه‌های قبلی میای، intent scaffold حذف شده و جاش رو همین روند maintainer گرفته. maintainer adopt هم حذف شده و کارش رو maintainer setup انجام می‌ده. برای گرفتن runner جدید باید hookها رو دوباره با intent hooks install نصب کنی.

نکات کلیدی:

• intent validate نمونه‌کدهای JS/TS داخل SKILL.md رو با کامپایلر TypeScript و بدون اجرا چک می‌کنه
• این چک به TypeScript 5.0 یا بالاتر نیاز داره
• intent maintainer review اسکیل‌های متأثر از تغییرات سورس رو مشخص می‌کنه و تصمیم‌ها رو ثبت می‌کنه
• intent repair فقط اصلاح‌های قطعی frontmatter رو خودکار اعمال می‌کنه، نه تغییر کدها رو
• intent scaffold و maintainer adopt تو نسخهٔ 0.5 حذف شدن