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

إعداد potato-skill في Claude Code

ثبّت potato-skill بوصفها إضافة في Claude Code، واختر النطاق الذي يحدد من يحصل على الإضافة، ووافق على الأوامر التي تشغّلها المهارة.

يثبّت Claude Code المهارة potato-skill بوصفها إضافة، بالأمر /plugin marketplace add davidjurgens/potato-skill متبوعاً بالأمر /plugin install potato-skill@potato. تضيف الإضافة مهارة واحدة، دون وكلاء أو خطافات أو خوادم MCP، ويحمّل Claude المهارة كلما كان الطلب عن بناء دراسة تعليق توضيحي أو تشغيلها. كُتبت potato-skill من أجل Claude Code، وبهذا الطريق تحصل على كل أجزاء المهارة كما صُمّمت. ويشرح البدء السريع مع وكيل برمجة ما تفعله المهارة بالدراسة، ويشرح تثبيت potato-skill في وكيل البرمجة الخاص بك الوكلاء الآخرين.

قبل التثبيت

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

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

تثبيت الإضافة

في جلسة Claude Code، أضف المتجر ثم ثبّت الإضافة:

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

يفتح أمر التثبيت تفاصيل الإضافة في لوحة /plugin ويسأل عن النطاق:

النطاقمن يحصل على المهارةأين يسجّل Claude Code الإضافة
المستخدمأنت، في كل مشروع على هذا الجهاز~/.claude/settings.json
المشروعكل من يعمل في المستودع.claude/settings.json، وأنت من يودعه (commit)
محليأنت، في هذا المستودع وحده.claude/settings.local.json

يناسب نطاق المستخدم باحثاً يبني دراسات في عدة مجلدات مشاريع. ويناسب نطاق المشروع مختبراً تشترك دراساته في مستودع واحد. وإيداع .claude/settings.json يفعّل الإضافة للمتعاونين، لكنه لا ينزّلها إلى أجهزتهم. وينفّذ كل متعاون أمر التثبيت مرة واحدة:

bash
claude plugin install potato-skill@potato --scope project

ويمكن لسكربت إعداد أن يشغّل الخطوتين نفسيهما من الشل دون فتح جلسة:

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

تُحمَّل الإضافة المثبّتة من الشل عند التشغيل التالي لـ Claude Code، أو بعد /reload-plugins في جلسة مفتوحة أصلاً. وتقرأ الطرفية والجلسات المحلية في تطبيق سطح المكتب وامتداد VS Code على حاسوب واحد ملفات الإعدادات نفسها. فالتثبيت بنطاق المستخدم في أي واحد من الثلاثة يصل إلى الاثنين الآخرين.

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

يطبع claude plugin list في الشل الإضافة مع إصدارها ونطاقها وحالتها:

text
  ❯ potato-skill@potato
    Version: 1.2.0
    Scope: user
    Status: ✔ enabled

يعرض claude plugin details potato-skill مهارة واحدة دون وكلاء أو خطافات أو خوادم MCP. ويقدّر الأمر نفسه كلفة المهارة في السياق بنحو 220 رمزاً في كل جلسة، لاسم المهارة ووصفها، ونحو 10,900 رمز في كل مرة تُحمَّل فيها المهارة.

بدء الدراسة

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

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

تُسمّى مهارات الإضافات باسم إضافتها. وكتابة /potato-skill:potato-skill قبل الطلب تحمّل المهارة مباشرة. وكتابة / تعرض الاسم في قائمة الأوامر، ويسرد /skills كل مهارة حمّلها Claude Code.

الموافقة على الأوامر التي تشغّلها المهارة

تطلب المهارة من Claude التحقق من ملف الضبط، وبدء خادم Potato، وفتح المهمة في متصفح بلا واجهة، وتشغيل السكربتات المساعدة في المهارة. وكل واحد من هذه أمر شل. وفي وضع Manual الافتراضي، يسأل Claude Code قبل تشغيل أمر شل، والإجابة بـ "Yes, and don't ask again" تحفظ قاعدة لذلك الأمر في ذلك المستودع.

يشغّل بناء الدراسة potato validate وpotato preview مرات كثيرة. وقواعد السماح في .claude/settings.json توافق على هذين الأمرين مسبقاً وتترك كل ما عداهما لسؤال:

json
{
  "permissions": {
    "allow": [
      "Bash(potato validate *)",
      "Bash(potato preview *)"
    ]
  }
}

يعرض /permissions كل قاعدة وملف الإعدادات الذي جاءت منه. ولا تعلن potato-skill أي allowed-tools. فكل أمر تطلبه المهارة يمر عبر إعدادات الأذونات لديك. وتصف وثائق الأذونات في Claude Code صيغة القواعد وأوضاع الأذونات الأخرى.

التثبيت دون نظام الإضافات

تضع أداة skills الملفات نفسها في .claude/skills/potato-skill/ داخل مشروعك، حيث يقرأ Claude Code مهارات المشروع:

bash
npx skills add davidjurgens/potato-skill --agent claude-code

تُسمّى مهارة المشروع دون بادئة إضافة، فيحمّل /potato-skill المهارة. وإيداع .claude/skills/ يعطي المتعاونين المهارة دون خطوة تثبيت. ويقرأ Cursor وGitHub Copilot في VS Code وOpenCode المجلد .claude/skills/ أيضاً. وتحتاج الأداة إلى Node.js 22.20 أو أحدث. ولا تحمّل جلسات Claude Code السحابية الإضافات المثبّتة على جهازك. ويشغّل المتصفح على claude.ai/code الجلسات السحابية.

تحديث الإضافة وإزالتها

لا يحدّث Claude Code الإضافة تلقائياً إلا إذا كان التحديث التلقائي مفعّلاً في متجر الإضافة، ويبدأ التحديث التلقائي معطّلاً في متجر أُضيف يدوياً، مثل davidjurgens/potato-skill. حدّث الإضافة من الشل:

bash
claude plugin update potato-skill@potato

وللتحديث التلقائي بدلاً من ذلك، شغّل /plugin، وافتح تبويب Marketplaces، واختر potato، ثم اختر Enable auto-update. وتحتفظ الجلسة الجارية بالإصدار الذي حمّلته، وتحمّل الجلسة التالية الإصدار الجديد.

يزيل claude plugin uninstall potato-skill@potato الإضافة. ويزيل /plugin marketplace remove potato المتجر وكل إضافة ثُبّتت منه. وتغطي وثائق الإضافات في Claude Code لوحة /plugin بالكامل.

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