تخطّي إلى المحتوى

إعداد potato-skill في Codex

أضف potato-skill إلى مشروع Codex بأمر npx واحد، وابدأ المهارة بـ $potato-skill، ووافق على الأوامر التي تحجبها البيئة المعزولة الافتراضية.

يقرأ Codex المهارات من .agents/skills/ في مستودعك، وينسخ npx skills add davidjurgens/potato-skill --agent codex المهارة potato-skill إلى هناك. ويكتشف Codex المهارة دون إعادة تشغيل، ويبدأ $potato-skill المهارة في CLI وفي امتداد IDE. ويشرح البدء السريع مع وكيل برمجة ما تفعله المهارة بالدراسة، ويشرح تثبيت potato-skill في وكيل البرمجة الخاص بك الوكلاء الآخرين.

قبل التثبيت

ثبّت Potato في بيئة Python التي يستخدمها شل Codex. تستورد السكربتات المساعدة في المهارة سجلات Potato وتستدعي الأمر potato، وتتحقق الخطوة الأولى في المهارة من أن Potato يُستورد. وتتيح إضافة المتصفح وChromium للأمر potato preview --screenshot ولسكربت الجولة الاختبارية في المهارة فتح المهمة في متصفح بلا واجهة:

bash
pip install 'potato-annotation[preview]'
playwright install chromium

لا وصول إلى الشبكة في البيئة المعزولة الافتراضية في Codex. ثبّت الاثنين قبل أن تبدأ لتوفّر جولة من الموافقات. وتعمل أداة skills عبر npx وتحتاج إلى Node.js 22.20 أو أحدث.

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

شغّل التثبيت في مستودعك:

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

ينسخ الأمر SKILL.md وملفات المرجع الثلاثين والسكربتات المساعدة التسعة إلى .agents/skills/potato-skill/، ويسجّل المصدر في skills-lock.json في جذر المستودع. ويفحص Codex المجلد .agents/skills/ في كل مجلد من المجلد الحالي حتى جذر المستودع، فتجد المهارة أيضاً جلسةٌ بدأت في مجلد فرعي من المستودع. وإيداع .agents/skills/ يعطي المتعاونين المهارة دون خطوة تثبيت.

أضف -g لتثبيت المهارة لكل مستودع على الجهاز بدلاً من ذلك:

bash
npx skills add davidjurgens/potato-skill --agent codex -g

يذهب التثبيت العام إلى ~/.agents/skills/potato-skill/، وهو مجلد المهارات على مستوى المستخدم الذي يقرأه Codex. ويكتشف Codex المهارة الجديدة دون إعادة تشغيل. وإذا لم تظهر المهارة فأعد تشغيل Codex.

التحقق من التثبيت

في Codex CLI أو امتداد IDE، يسرد /skills المهارات التي وجدها Codex، وتظهر potato-skill في القائمة. وفي تطبيق ChatGPT لسطح المكتب، يعرض Skills في الشريط الجانبي المهارات عبر مشاريعك.

بدء الدراسة

اذكر المهارة بـ $potato-skill وصِف الدراسة:

text
$potato-skill I want 200 tweets labeled for sentiment on a 5-point scale by three annotators each, with a consent page and two attention checks. Build it and start it.

ويحمّل Codex المهارة أيضاً دون ذكر لها حين يطابق الطلب وصف المهارة، مثل طلب بناء مهمة تعليق توضيحي أو تعديل ملف Potato config.yaml أو الاطلاع على دراسة قيد التشغيل.

البيئة المعزولة والموافقات

ينفّذ Codex الأوامر في بيئة معزولة. ويسمح الوضع الافتراضي، workspace-write، للأوامر بالكتابة داخل مساحة العمل مع إيقاف الوصول إلى الشبكة. والإعداد الذي يتحكم بالشبكة هو sandbox_workspace_write.network_access، وقيمته الافتراضية false. وفي سياسة الموافقة on-request يعمل Codex داخل البيئة المعزولة ويسأل قبل أي أمر يتجاوزها.

أثناء البناء، تطلب المهارة من Codex التحقق من ملف الضبط، وبدء خادم Potato على جهازك، وفتح المهمة في متصفح بلا واجهة، وتشغيل السكربتات المساعدة في المهارة. ويحتاج pip install إلى الشبكة، ولا شبكة في البيئة المعزولة الافتراضية. وافق على تنفيذ الأمر خارج البيئة المعزولة حين يسأل Codex، بعد أن تقرأ الأمر. وفي CLI يفتح /permissions أداة اختيار الأذونات. وفي امتداد IDE والتطبيق توجد الخيارات نفسها تحت مربع الكتابة باسم Ask for approval وApprove for me وFull access. وتصف وثائق العزل في Codex كل وضع.

AGENTS.md

يقرأ Codex الملف AGENTS.md باسمه. وفي جذر مستودع potato-skill ملف AGENTS.md، وهو ملخص قصير لقواعد المهارة. ونسخ هذا الملف إلى جذر مستودعك يعطي Codex القواعد دون خطوة تثبيت. ويشير الملف إلى ملفات مرجع وسكربتات لا تصل إلى القرص إلا بالتثبيت الكامل. استخدم تثبيت أداة skills لبناء دراسة. وإذا كان في مستودعك ملف AGENTS.md أصلاً، فأضف الملخص إلى ذلك الملف بدلاً من استبداله.

تحديث المهارة وإزالتها

تحدّث أداة skills المهارة وتزيلها بالاسم. أضف -g إلى أي من الأمرين للتثبيت العام:

bash
npx skills update potato-skill
npx skills remove potato-skill

يقارن update النسخة المثبّتة بمستودع GitHub ويستبدلها حين يتغير المستودع. ويحذف remove المجلد .agents/skills/potato-skill/ وإدخال المهارة في skills-lock.json.

ولإيقاف المهارة دون حذفها، أضف إدخالاً إلى ~/.codex/config.toml بالمسار المطلق للملف SKILL.md الخاص بالمهارة، وأعد تشغيل Codex. وتسرد وثائق المهارات في Codex الإعدادات الأخرى التي يقبلها الإدخال:

toml
[[skills.config]]
path = "/path/to/your/repo/.agents/skills/potato-skill/SKILL.md"
enabled = false

قراءات إضافية