اسکریپت در اسکیل؛ کی کد بنویسیم و کی دستورالعمل

اسکیل می‌تواند فقط متن باشد، ولی قوی‌ترین اسکیل‌ها اسکریپت هم دارند: کدی که دستیار اجرا می‌کند و فقط خروجی‌اش را می‌خواند. اسکیل طراحی آیکون این سایت اسکریپتی دارد که هر SVG را بررسی می‌کند؛ اسکیل یوایکس رایتر اسکریپتی که کل پروژه را برای خطاهای املایی می‌گردد.

سؤال این است: کدام بخش کار را به اسکریپت بدهیم و کدام را به قضاوت مدل؟

#یک قاعده‌ی ساده

اگر کار قابل‌اندازه‌گیری است، اسکریپت. اگر قضاوت لازم دارد، دستورالعمل.

#چرا اسکریپت بهتر است؟

سه دلیل:

1. ثبات: اسکریپت هر بار همان نتیجه را می‌دهد. مدل ممکن است یک بار نیم‌فاصله‌ای را ببیند و بار بعد نبیند.
2. حافظه: دستیار لازم نیست اسکریپت را بخواند؛ فقط اجرایش می‌کند و چند خط خروجی می‌گیرد. توضیح همان قواعد ممکن است صدها خط حافظه بگیرد.
3. تست‌پذیری: اسکریپت را می‌شود جدا تست کرد. دستورالعمل را فقط با اجرای کامل.

#اسکریپت خوب برای اسکیل

اسکریپتی که مدل اجرا می‌کند با اسکریپت معمولی فرق دارد، چون خواننده‌ی خروجی‌اش یک مدل است:

• خطای روشن با راه‌حل. «خط ۱۲: «ي» عربی؛ به «ی» تبدیل کنید» بهتر از «Error: invalid char».
• بدون وابستگی اضافه. اسکریپت‌های اسکیل‌های این سایت فقط با Node اجرا می‌شوند و هیچ بسته‌ای نصب نمی‌کنند.
• کد خروج معنادار. صفر یعنی موفق، غیرصفر یعنی مشکل؛ تا دستیار بدون خواندن کل خروجی بفهمد چه شد.
• عدد جادویی ندارد. هر عدد ثابت توضیح دارد: چرا ۱٫۵ و نه ۲.
• مسیرها با /. حتی روی ویندوز.

$ node scripts/check_icon.mjs camera.svg
FAIL camera.svg
  ✗ stroke-width 2 — use 1.5 for main lines, 1.1–1.3 for fine details
  ✗ hard-coded colour — use currentColor so the icon follows text colour and theme
  ✗ geometry spans 1.2, 4, 18.2, 17 — stroke centres must stay inside 2.75…17.25

1 file(s), 3 error(s), 0 warning(s)

#چرخه‌ی بازخورد

قدرت واقعی اسکریپت وقتی معلوم می‌شود که در یک چرخه قرار بگیرد: بساز ← بررسی کن ← اصلاح کن ← دوباره بررسی کن. در دستورالعمل اسکیل صریح بنویسید: «اسکریپت را اجرا کن و تا وقتی خطا دارد اصلاح کن.» این‌طوری دستیار بدون دخالت شما به نتیجه‌ی درست می‌رسد.

#یک هشدار

اسکریپت جای قضاوت را نمی‌گیرد. اسکریپت املا می‌تواند بگوید «می‌باشد» در متن هست، ولی نمی‌تواند بگوید دکمه‌ی «تایید» برای این صفحه مبهم است. بهترین اسکیل‌ها هر دو را دارند: اسکریپت برای مکانیک، دستورالعمل برای معنا.

برای بقیه‌ی اصول، ۹ اصل نوشتن یک اسکیل حرفه‌ای را ببینید.