potato-skill: البدء السريع مع وكيل برمجة

Name: Potato
Author: Potato

صِف لـ Claude Code البيانات التي تحتاج إلى توسيمها، فيصمّم potato-skill الدراسة ثم يبنيها ويشغّلها كمهمة توسيم في Potato بواجهتها الخاصة.

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

قرارات التصميم التي تتخذها المهارة

potato-skill مهارة وكيل، أي حزمة من التعليمات والنصوص البرمجية المساعدة يحمّلها وكيل البرمجة عندما يحتاج إليها الطلب. وهي تتولى تصميم الدراسة وبناءها معًا، من مجموعة التسميات حتى البيانات المُصدَّرة:

ما الذي يُسأل عنه المُعلِّقون، وعلى أي مقياس
كم مُعلِّقًا يحتاج إليه كل عنصر
كيف يُدرَّب المُعلِّقون ويُتحقَّق من عملهم
الواجهة التي يراها المُعلِّقون
تشغيل المهمة والمرور عليها كما يفعل المُعلِّق
تصدير النتائج بالصيغة التي تحتاج إليها الخطوة التالية

وتعمل أيضًا على الدراسات الجارية بالفعل: تُبلغ عن التقدّم ومستوى الاتفاق، وتوضّح التغييرات الآمنة بعد أن يبدأ المُعلِّقون العمل.

تعمل المهمة التي تبنيها على Potato، فتحصل على ما يوفّره Potato أصلًا: تسجيل دخول لكل مُعلِّق، وعدة مُعلِّقين لكل عنصر، وإحصاءات الاتفاق، والتكامل مع Prolific وMTurk، والتصدير إلى الصيغ التي تقرؤها الأدوات اللاحقة.

المتطلبات

يجب تثبيت Potato حيث ينفّذ الوكيل الأوامر، لأن النصوص البرمجية المساعدة للمهارة تستورد Potato وتستدعي الأمر potato:

bash

pip install potato-annotation

تحتاج أيضًا إلى وكيل برمجة. كُتبت المهارة من أجل Claude Code، ويتناول القسم التالي الوكلاء الآخرين.

تثبيت المهارة

في Claude Code:

text

/plugin marketplace add davidjurgens/potato-skill
/plugin install potato-skill@potato

بالنسبة إلى Codex وCursor والوكلاء الآخرين، تثبّتها أداة skills لسطر الأوامر في مشروعك:

bash

npx skills add davidjurgens/potato-skill --agent codex cursor

مع --agent codex cursor تنسخ الأداة المهارة إلى .agents/skills/potato-skill/. ويمكن لـ Codex وCursor أيضًا قراءة ملف AGENTS.md الموجود في جذر مستودع potato-skill.

صِف الدراسة

قل ما الذي يحتاج إلى توسيم، ومن سيقوم به، وفيمَ ستُستخدم التسميات. لا تحتاج إلى معرفة أنواع التوسيم في Potato أو صيغة إعداداته. يمكن أن يكون الطلب بهذا القِصَر:

أريد توسيم 200 تغريدة حسب المشاعر على مقياس من 5 نقاط، بواسطة ثلاثة مُعلِّقين لكل تغريدة، مع صفحة موافقة وسؤالين للتحقق من الانتباه. ابنِها وشغّلها.

تحدّد المهارة صياغة الأسئلة والمقياس وطريقة توزيع العناصر وطريقة التحقق من المُعلِّقين. ثم يبني الوكيل المهمة ويشغّلها ويمرّ عليها كما يفعل المُعلِّق قبل أن يسلّمها إليك. افتحها في المتصفح ووسِّم بعض العناصر بنفسك قبل أن تدعو أي أحد.

المهمة الناتجة

مهمة Potato: مجلد مشروع يضم إعدادات المهمة وبياناتها وتعليماتها. ينطبق عليها كل ما في البدء السريع. تشغّلها بالأمر potato start config.yaml، وتعدّلها يدويًا، وتضيف مُعلِّقين، وتصدّر التسميات.

ولأن النتيجة مجلد مهمة في Potato، يستطيع آخرون استخدامها أيضًا. يمكن لزميل أن يشغّل الدراسة نفسها على بيانات جديدة، ويمكنك إعادة تشغيلها العام المقبل، أو نشرها مع الورقة البحثية التي استخدمتها. والمعرض مجموعة من المهام المُشارَكة بهذه الطريقة، مأخوذة من أوراق بحثية منشورة.

التصاميم والتوسيمات الموجودة

تصميم منشور. يمكن للمهارة أن تبدأ من أحد 440 تصميم توسيم مأخوذة من أوراق بحثية منشورة، مع مجموعات تسمياتها وصياغة أسئلتها وتعليماتها. يمكنك تصفّحها في المعرض.
توسيمات من أداة أخرى. تستورد التوسيمات الموجودة من Label Studio أو CVAT أو COCO، فيمكن لمشروع نصف منجز أن يكتمل في Potato.
دراسة جارية. تُبلغ عن تقدّم كل مُعلِّق ومستوى الاتفاق في كل سؤال، وتوضّح أي الإصلاحات آمنة أثناء الدراسة وأيها يُفسد البيانات التي جُمعت بالفعل.

اختبارات مقابل سجلات Potato

يتحقق التكامل المستمر (CI) للمهارة من أن كل نوع توسيم ومفتاح إعداد ومثال إعدادات تذكره تعليماتها موجود فعلًا في Potato. تمرّ ملفات YAML النموذجية عبر مُدقِّق Potato، ويشغّل المثال العملي خادم Potato حقيقيًا. وتُولَّد ثلاثة من مراجعها من سجلات Potato نفسها، فتكون الأنواع والمفاتيح التي يقرؤها الوكيل هي نفسها التي يفرضها الخادم.

المواد المرجعية منشورة على davidjurgens.github.io/potato-skill، ويمكن قراءتها دون تثبيت أي شيء. وتوصي Anthropic بمراجعة أي مهارة قبل تثبيتها.

مقارنة بين الطريقتين

	كتابة المهمة بنفسك	وصفها لوكيل برمجة
تبدأ بـ	ملف إعدادات YAML	وصف بلغة عادية
تناسب	تعلّم Potato، والمهام الصغيرة	الدراسات الجديدة، ودراسات التعهيد الجماعي التي تتضمن تدريبًا وتحققًا، وأنواع التوسيم التي لم تستخدمها من قبل
تنتهي بـ	مهمة Potato	مهمة Potato

يمكنك تبديل الطريقة في أي وقت. يستطيع الوكيل تعديل مهمة كتبتها أنت، ويمكنك تحرير مهمة بناها الوكيل.