تصدير أصول التصميم باستخدام وكيل يمكن للمصمم مراسلته

إن مسار تصدير الأصول هو السلسلة الممتدة من ملف التصميم إلى ملفات يمكن لعملية البناء استخدامها: تصدير، وتغيير الحجم، وتحسين، وإعادة تسمية، ووضع في المكان المناسب. إنه تمامًا نوع العمل المتكرر والمكثف على الملفات الذي يبرع فيه وكيل البرمجة، ونوع العمل الذي يتعطل تحديدًا لأن المصمم مضطر لطلب تشغيله من مهندس. ووجود وكيل مثبت في مجلد الأصول، ويمكن الوصول إليه في غرفة، يلغي هذا العائق.

The request

"@assets export the icon set from the design file at 1x, 2x and 3x, optimise, and put them in /public/icons. Post a contact sheet."

ما يفعله الوكيل

1. يستدعي واجهة برمجة التطبيقات (API) لأداة التصميم لجلب مكونات الأيقونات الحالية.
2. يصدّر الملفات بالمقاييس الثلاثة إلى مجلد مؤقت.
3. يُشغّل أداة التحسين المثبتة مسبقًا على الجهاز.
4. يعيد التسمية وفقًا للاصطلاح المتبع في المشروع، والمكتوب في ملف README.md الخاص بالمجلد.
5. ينقل الملفات إلى /public/icons، مستبدلًا المجموعة السابقة.
6. يُنشئ صورة لوحة معاينة وينشرها في الغرفة مع ذكر عددها.

يرى المصمم كل خطوة في الخط الزمني ولوحة المعاينة في النهاية. الوقت الإجمالي: دقيقة تقريبًا.

ما يتوقف مؤقتًا

تقرأ الخطوة 1 رمز الـ token الخاص بواجهة برمجة تطبيقات أداة التصميم. يُعد هذا إجراءً يخص بيانات الاعتماد، لذا يتوقف مؤقتًا بانتظار المالك في المرة الأولى، مع ظهور بطاقة توضح من قدّم الطلب وما يريد الوكيل قراءته. يوافق المالك؛ ولا يغادر الـ token الجهاز أبدًا ولا يراه المصمم مطلقًا. راجع four actions an agent should always ask before doing.

إذا أراد الوكيل أيضًا إجراء commit ودفع الأيقونات الجديدة إلى main، فسيتوقف ذلك مؤقتًا أيضًا. تسمح معظم الفرق له بإجراء commit إلى فرع وفتح pull request بدلًا من ذلك، وهو ما لا يتوقف مؤقتًا.

الإعداد

• وكيل واحد، مجلد واحد. ثبّت assets في دليل أصول التصميم داخل مستودع الموقع، أو في مجلد مخصص للتصديرات إذا كنت تفضل إبقاء الوكيل بعيدًا عن الكود البرمجي.
• دوّن الاصطلاحات. ملف README.md يتضمن خطة التسمية والأحجام والتنسيقات ومسارات الوجهة. يقرأه الوكيل في كل مرة.
• وضع الأذونات acceptEdits. كتابة الملفات هي صلب المهمة؛ بينما تظل الأوامر بحاجة إلى إذن. راجع permission modes, explained.
• منح دائم للمصممين. موافقة واحدة لكل منهم، ثم يمكنهم الطلب بحرية.
• أبقِ الـ token على الجهاز، في موقع التهيئة المعتاد للأداة. لا تلصقه في الطلب أو في ملف README.

حالات متنوعة

لماذا غرفة وليس سكربت

يقتصر السكربت على إجراء التصدير. أما الغرفة فتتيح للشخص الذي يلاحظ التغيير تشغيله، ومتابعته، والحصول على النتيجة، دون الحاجة إلى نافذة أوامر أو تذكرة دعم أو مهندس في المسار بالنسبة للحالات الروتينية، بينما تظل الحالات غير الروتينية (بيانات الاعتماد، وعمليات الحذف، والدفع) تتوقف بانتظار المالك. كما أنها تترك سجلًا يوضح من صدّر ماذا ومتى. راجع coding agents do more than code.

الأسئلة الشائعة

هل يحتاج المصمم إلى الوصول لواجهة برمجة تطبيقات أداة التصميم؟ لا. يوجد الـ token على جهاز المالك ويستخدمه الوكيل هناك. يطلب المصمم، ويوافق المالك على قراءة بيانات الاعتماد.

هل يمكن للوكيل فتح pull request؟ نعم، إذا كان دليل الوكيل داخل المستودع ويمتلك وصولًا إلى git على الجهاز. فتح PR على فرع لا يتوقف مؤقتًا؛ بينما يتوقف الدفع إلى فرع مشترك.

ماذا لو أراد المصمم تغيير خطة التسمية؟ عدّل ملف README في المجلد، أو اطلب من الوكيل ذلك. فهو يقرأ الاصطلاحات من جديد مع كل طلب.

لا يستغرق التصدير سوى دقيقة من العمل. كان الانتظار هو المشكلة. Give your assets agent a room.